GET Accounts Summary
- NT8
- Tradovate
Get list of all accounts NT8
Returns a consolidated snapshot of NT8 account balances, P&L, and positions.
Freshness contract
Each request makes an RPC call to the connected add-on, which reads NT8's in-memory account and position objects. The API does not serve a stored snapshot as a fallback when the add-on is disconnected.
The top-level timestamp and epoch describe when the add-on assembled the response. They are not the last broker-update time or a guarantee that balances and positions were refreshed recently. Check each account's connectionStatus; an active CrossTrade add-on connection does not establish that its broker connection is healthy. Account and position values are collected sequentially, so the response is not an atomic broker snapshot.
This endpoint currently has no per-field age, max_age option, or maximum staleness guarantee. Do not treat a recent response timestamp alone as proof that it is safe to trade. If your integration requires a bounded-age broker valuation, this endpoint does not currently provide that contract.
Endpoint
GET /v1/api/accounts/snapshot
Headers
| Name | Value |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
Code examples
- Python
- JavaScript
- cURL
import requests
url = "https://app.crosstrade.io/v1/api/accounts/snapshot"
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
try:
response = requests.get(url, headers=headers)
print(f"Response Code: {response.status_code}, Response Text: {response.text}")
except Exception as e:
print(f"An error occurred: {e}")
const url = "https://app.crosstrade.io/v1/api/accounts/snapshot";
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 -X GET "https://app.crosstrade.io/v1/api/accounts/snapshot" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json"
Response
- 200
- 400
- 401
- 403
- 408
- 429
- 500
{
"type": "snapshot",
"timestamp": "2025-03-10T07:53:13.0908809-07:00",
"epoch": 1741618393090,
"accounts": [
{
"account": {
"id": 15,
"name": "Sim110",
"type": "NinjaTrader.Cbi.Account",
"displayName": "Sim110",
"primaryUser": null,
"provider": "Simulator",
"denomination": "UsDollar",
"commissionTemplate": null,
"status": "Enabled",
"isAccountFlat": false,
"dailyLossLimit": 0.0,
"minCashValue": 0.0,
"maxOrderSize": 0,
"maxPositionSize": 0,
"connection": "NinjaTrader.Cbi.Connection",
"connectionStatus": "Connected",
"connectionName": "Simulation",
"item": {
"buyingPower": 0.0,
"cashValue": 153772.375,
"commission": 0.0,
"dailyLossLimit": 0.0,
"dailyProfitTrigger": 0.0,
"excessInitialMargin": 0.0,
"excessIntradayMargin": 0.0,
"excessMaintenanceMargin": 0.0,
"excessPositionMargin": 0.0,
"fee": 0.0,
"grossRealizedProfitLoss": 0.0,
"initialMargin": 0.0,
"intradayMargin": 0.0,
"longOptionValue": 0.0,
"longStockValue": 0.0,
"lookAheadMaintenanceMargin": 0.0,
"maintenanceMargin": 0.0,
"netLiquidation": 154185.375,
"netLiquidationByCurrency": 0.0,
"positionMargin": 0.0,
"realizedProfitLoss": 0.0,
"shortOptionValue": 0.0,
"shortStockValue": 0.0,
"sodCashValue": 0.0,
"sodLiquidatingValue": 0.0,
"totalCashBalance": 0.0,
"trailingMaxDrawdown": 0.0,
"unrealizedProfitLoss": 412.99999999999727,
"weeklyLossLimit": 0.0,
"weeklyProfitLoss": 0.0,
"weeklyProfitTrigger": 0.0
}
},
"positions": [
{
"type": "NinjaTrader.Cbi.Position",
"account": "Sim110",
"instrument": "MGC 12-25",
"instrumentType": "Future",
"marketPosition": "Long",
"quantity": 1,
"averagePrice": 2916.8,
"marketPrice": 2958.1,
"unrealizedProfitLoss": 412.99999999999727,
"tag": null
}
]
}
],
"success": true
}
{
"error": "The request timed out, please check connection to NT8 Add-On."
}
{
"error": "Invalid bearer token"
}
{
"error": "Endpoint not available"
}
{
"error": "Client not ready to receive requests, disconnected."
}
// retryAfter is integer seconds; also sent as Retry-After.
{
"error": "Rate limit exceeded",
"retryAfter": 1
}
{
"success": false,
"error": "internal_error"
}
Success field types
| Field | Type | Description |
|---|---|---|
success | boolean | true on success. |
type | string | Snapshot type. |
timestamp | string | ISO 8601 snapshot time. |
epoch | integer | Snapshot time in Unix milliseconds. |
accounts | array of objects | Account cards; may be empty. |
accounts[].account | object | Account fields and nullability, without the top-level success. |
accounts[].positions | array of objects | Position fields and nullability; may be empty. |
Platform nuances
The NT8 snapshot includes top-level type, timestamp, and epoch fields. Account details and
positions are grouped under accounts.
WebSocket API
This request can also be made over the WebSocket API.
{
"action": "rpc",
"id": "my-request-id",
"api": "GetAccountSummary",
"args": {}
}
Get list of all accounts Tradovate
Returns a consolidated snapshot of net liquidation, P&L, positions, and working orders for every linked Tradovate account. The request executes server-side against the Tradovate Web API and works while NinjaTrader is closed.
Endpoint
GET /v1/api/tv/accounts/snapshot
Headers
| Name | Value |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
Code examples
- Python
- JavaScript
- cURL
import requests
token = 'my-secret-token'
url = "https://app.crosstrade.io/v1/api/tv/accounts/snapshot"
headers = {
"Authorization": f"Bearer {token}"
}
try:
response = requests.get(url, headers=headers)
print(f"Response Code: {response.status_code}, Response Text: {response.text}")
except Exception as e:
print(f"An error occurred: {e}")
const token = 'my-secret-token';
const url = "https://app.crosstrade.io/v1/api/tv/accounts/snapshot";
fetch(url, {
method: "GET",
headers: {
"Authorization": `Bearer ${token}`
}
})
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));
TOKEN="my-secret-token"
curl -X GET "https://app.crosstrade.io/v1/api/tv/accounts/snapshot" \
-H "Authorization: Bearer $TOKEN"
Response
- 200
- 401
- 403
- 429
- 500
- 502
- 503
{
"success": true,
"accounts": [
{
"name": "DEMO12345678",
"accountId": "12345678",
"environment": "demo",
"broker": "tradovate",
"netLiq": 50125,
"openPnl": 125,
"realizedPnl": 0,
"weekRealizedPnl": 250,
"positions": [
{
"contract": "ESZ6",
"contractId": 1234,
"netPos": 1,
"netPrice": 6000.25,
"bought": 1,
"sold": 0,
"unrealized": 125
}
],
"workingOrders": [
{
"orderId": 123456789,
"contract": "ESZ6",
"contractId": 1234,
"action": "Sell",
"status": "Working",
"qty": 1,
"orderType": "Limit",
"price": 6010,
"stopPrice": null,
"timestamp": "2026-10-27T12:00:00Z"
}
],
"error": null,
"errorCode": null
}
],
"asOf": "2026-10-27T12:00:00",
"asOfEpoch": 1793102400.25,
"source": "rest",
"counts": {
"accounts": 1,
"positions": 1,
"workingOrders": 1
}
}
{
"success": false,
"error": "inactive_subscription"
}
{
"success": false,
"error": "tradovate_not_linked"
}
// retryAfter is integer seconds; also sent as Retry-After.
{
"success": false,
"error": "rate_limited",
"detail": "CrossTrade API rate limit exceeded (180 requests/min per user). Retry after 1s.",
"retryAfter": 1
}
{
"success": false,
"error": "internal_error"
}
{
"success": false,
"error": "tradovate_unavailable",
"detail": "Tradovate is temporarily unavailable. Please try again shortly."
}
{
"success": false,
"error": "temporarily_disabled"
}
Success field types
| Field | Type | Description |
|---|---|---|
success | boolean | true on success; check per-account errors too. |
asOf, source | string | Snapshot time and source: ws when served from your login's live account stream, rest when read from Tradovate. |
asOfEpoch | float | Unix seconds, including fractional seconds. |
accounts | array of objects | Account cards. |
accounts[].name, accounts[].accountId, accounts[].environment, accounts[].broker | string | Account identity and broker. |
accounts[].netLiq, accounts[].openPnl, accounts[].realizedPnl, accounts[].weekRealizedPnl | float or null | Valuations; null means unavailable. |
accounts[].error | string or null | Per-account read failure in plain language, or null. |
accounts[].errorCode | string or null | Machine-readable cause when error is set: broker_rate_limited (Tradovate's penalty on your login), tradovate_unavailable (no usable answer in time), tradovate_session_expired (relink), snapshot_refresh_pending (retry in a moment), tradovate_rejected, tradovate_not_linked. Null when error is null. |
accounts[].positions | array of objects | May be empty. Fields below are relative to each position. |
accounts[].positions[].contract | string | Contract symbol. |
accounts[].positions[].contractId, accounts[].positions[].netPos, accounts[].positions[].bought, accounts[].positions[].sold | integer | Contract ID and quantities. |
accounts[].positions[].netPrice | float | Average net price. |
accounts[].positions[].unrealized | float or null | Unrealized P/L; null if unavailable. |
accounts[].workingOrders | array of objects | Working and pending orders. |
accounts[].workingOrders[].orderId, accounts[].workingOrders[].contractId | integer | Broker IDs. |
accounts[].workingOrders[].contract, accounts[].workingOrders[].action, accounts[].workingOrders[].status, accounts[].workingOrders[].timestamp | string | Contract, side, state and time. |
accounts[].workingOrders[].qty | integer or null | Quantity when version enrichment succeeds. |
accounts[].workingOrders[].orderType | string or null | Enriched order type. |
accounts[].workingOrders[].price, accounts[].workingOrders[].stopPrice | float or null | Enriched prices. |
counts | object | Totals below. |
counts.accounts, counts.positions, counts.workingOrders | integer | Returned counts. |
Platform nuances
- This is the exception to the normal Tradovate
{"success": true, "data": ...}read shape. - The snapshot covers all linked Tradovate accounts in one request.
workingOrdersincludesWorkingandSuspendedorders, plus orders in the transitionalPendingNew,PendingReplace, andPendingCancelstates. Quantity, type, and price enrichment is capped at 20 OrderVersion lookups across the snapshot; failed or skipped lookups leave those fieldsnull. OrderVersion IDs are not returned.- Version-derived fields can reflect a subsequently rejected modification. Use the order lifecycle to reconcile command outcomes rather than treating these fields as confirmation.
openPnlis the sum of the per-position unrealized values.netLiqis cash value plus that sum. If any open position lacks fresh pricing, both account-level fields arenullrather than presenting a partial or Tradovate-marked valuation.- While a live account stream is running for your login (the CrossTrade dashboard or Account Manager open, or a WebSocket stream subscribed to Tradovate events or P&L), the snapshot is served from that stream with
source: "ws": it costs no Tradovate request, positions and orders come straight off the socket, andasOfis the stream's last publish time, at most 15 seconds old. Otherwise it is read from Tradovate (source: "rest") and cached for three seconds, and an identicalasOfon two calls means the second was served from cache. Poll at five seconds or slower. - Reads are sent to Tradovate as you make them; CrossTrade does not pace them. They count toward Tradovate's per-login limits together with everything else on that login. A penalty they draw shows up on the affected accounts as
errorCode: "broker_rate_limited", and on the other read endpoints as an HTTP 429broker_rate_limitedwith the remaining time. - A
nullfigure means unusable, never zero. A read failure nulls the affected account's balance fields, setserrorto a plain-language sentence anderrorCodeto its machine-readable cause (table above). Branch onerrorCode;erroris for a human and its wording can change. - The endpoint works while NinjaTrader is closed.
See the Tradovate API overview for the full field grammar, mutation safety guarantees, and error table.