GET Cash Balances
Returns the current Tradovate cash-balance rows for every linked identity.
This route is specific to linked Tradovate accounts.
GET /v1/api/tv/cashbalancesRuns 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 cash balances
GET /v1/api/tv/cashbalances
Returns raw Tradovate /cashBalance/list rows for every linked identity. For a single account's balance combined with its account record, /v1/api/tv/accounts/{account} is usually more convenient.
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
- JavaScript
- cURL
import requests
token = 'my-secret-token'
url = "https://app.crosstrade.io/v1/api/tv/cashbalances"
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}")
const token = 'my-secret-token';
const url = "https://app.crosstrade.io/v1/api/tv/cashbalances";
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));
TOKEN="my-secret-token"
curl -X GET "https://app.crosstrade.io/v1/api/tv/cashbalances" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json"
Response
- 200
- 403
{
"success": true,
"data": [
{
"id": 45678,
"accountId": 123456,
"timestamp": "2026-07-15T14:32:05.184Z",
"tradeDate": { "year": 2026, "month": 7, "day": 15 },
"currencyId": 1,
"amount": 52340.18,
"realizedPnL": 340.18,
"weekRealizedPnL": 812.50
}
]
}
Rows are raw Tradovate cash-balance records and may carry additional fields.
{
"success": false,
"error": "tradovate_not_linked"
}