GET Margin Snapshots

Returns current margin usage and liquidation threshold snapshots for every linked Tradovate identity.

NinjaTrader 8Not available

No equivalent NT8 endpoint

This route is specific to linked Tradovate accounts.

TradovateREST only

GET /v1/api/tv/marginsnapshots

Runs server-side for a linked Tradovate account, so NinjaTrader can be closed. Tradovate does not currently use the CrossTrade WebSocket API. See the Tradovate API guide.

Get margin snapshots

GET /v1/api/tv/marginsnapshots

Returns raw Tradovate /marginSnapshot/list rows for every linked identity: initial and maintenance margin, total used margin, and liquidation thresholds as Tradovate reports them.

Auth is the same bearer token as the rest of the CrossTrade API, on a plan with API access (Pro), plus a linked Tradovate account. Unlinked users receive 403 tradovate_not_linked.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Code Examples

Python

import requests

token = 'my-secret-token'

url = "https://app.crosstrade.io/v1/api/tv/marginsnapshots"
headers = {
    "Authorization": f"Bearer {token}",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(f"Response Code: {response.status_code}, Response Text: {response.text}")

JavaScript

const token = 'my-secret-token';

const url = "https://app.crosstrade.io/v1/api/tv/marginsnapshots";

fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json"
  }
})
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

cURL

TOKEN="my-secret-token"

curl -X GET "https://app.crosstrade.io/v1/api/tv/marginsnapshots" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"

---

Response

200

{
  "success": true,
  "data": [
    {
      "id": 123456,
      "timestamp": "2026-07-15T14:32:05.184Z",
      "riskTimePeriodId": 9,
      "initialMargin": 1760.00,
      "maintenanceMargin": 1600.00,
      "totalUsedMargin": 1600.00,
      "fullInitialMargin": 1760.00
    }
  ]
}

Rows are raw Tradovate margin-snapshot records and may carry additional fields.

403

{
  "success": false,
  "error": "tradovate_not_linked"
}