Skip to main content

GET Tradovate Status

Returns the link status for your Tradovate identities: whether an identity is linked, its environment (demo or live), and when its access token expires. It is useful as a first call to confirm the Tradovate API is ready before reading or trading.

Endpoint

GET /v1/api/tv/status

Headers

NameValue
Content-Typeapplication/json
AuthorizationBearer <token>

Code examples

import requests

token = 'my-secret-token'

url = "https://app.crosstrade.io/v1/api/tv/status"
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}")

Response

{
"success": true,
"data": {
"linked": true,
"identities": [
{
"environment": "demo",
"userId": "12345",
"expires": "2026-08-01T00:00:00Z"
}
]
}
}

The inner shape is illustrative and may carry additional per-identity fields.

Platform nuances

Authentication uses the same bearer token as the rest of the CrossTrade API and requires a plan with API access (Pro) plus a linked Tradovate account. Unlinked users receive 403 tradovate_not_linked.

This endpoint is REST-only and has no WebSocket equivalent.