GET Tradovate Status

Confirms which Tradovate identities are linked, their demo or live environments, and token expiry.

NinjaTrader 8Not available

No equivalent NT8 endpoint

This route is specific to linked Tradovate accounts.

TradovateREST only

GET /v1/api/tv/status

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 link status

GET /v1/api/tv/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. Useful as a first call to confirm the Tradovate API is ready before reading or trading.

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/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}")

JavaScript

const token = 'my-secret-token';

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

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/status" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"

---

Response

200

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

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

403

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