List NT8 Connections

Read the connections configured in your running NinjaTrader instance, including disconnected connections. Each entry reports broker connection status and the separate market-data status.

Elite

Requires an Elite subscription and a connected CrossTrade add-on. Use your existing API token. See Authentication.

Endpoint

GET https://app.crosstrade.io/v1/api/manage/nt8/connections

Headers

Name	Required	Value
Authorization	Yes	Bearer <your API token>
If-None-Match	No	ETag from a previous list. Returns 304 with no body when the live snapshot is unchanged

Query parameters

Name	Type	Default	Description
refresh	boolean	false	Refresh discovery of configured connections from the NT8 Connections menu

Every call reads live status. refresh=true also refreshes menu discovery; it does not reconnect a broker. Send no request body.

Code examples

Python

import requests

resp = requests.get(
    "https://app.crosstrade.io/v1/api/manage/nt8/connections",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    params={"refresh": "true"},
)
print(resp.status_code, resp.json())

cURL

curl "https://app.crosstrade.io/v1/api/manage/nt8/connections?refresh=true" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

{
  "success": true,
  "data": [
    {
      "name": "Rithmic",
      "provider": "Rithmic",
      "status": "Connected",
      "priceStatus": "Connected",
      "apiDisconnectIntent": false,
      "establishedAt": "2026-10-22T13:00:00Z",
      "uptimeSeconds": 120
    }
  ],
  "meta": {
    "requestId": "req_9f2c1a0b7d3e4f51",
    "count": 1,
    "etag": "\"c2:7Q0xMmZ3bTRkWmRVdz\""
  }
}

See the Connection field reference. Provider credentials and cached provider properties are not returned. The ETag covers the whole snapshot, including uptime, so it can change while a connection stays connected.

Other responses

Status	error	When
304		If-None-Match matched; no body
400	unexpected_body, unknown_parameter	A body or an unknown/repeated query parameter was sent
401	unauthorized	Missing or invalid API token
403	elite_required, not_available	See Authentication
409	addon_disconnected	NinjaTrader or the CrossTrade add-on is offline
422	validation_failed	refresh is not a valid boolean
429	rate_limited, too_many_concurrent_requests	See Rate limits
503	addon_unavailable	The add-on timed out, returned an error, or could not provide a valid inventory
503	management_unavailable, family_unavailable, management_busy	See Errors

Use Connect and Disconnect for immediate commands. Saved auto-reconnect, watchdog, and reconnect-action policies remain under Connection Settings.