GET Order
- NT8
- Tradovate
Get order by ID NT8
Returns the full details for one order by its NT8-assigned or caller-supplied ID.
Endpoint
GET /v1/api/accounts/{account}/orders/{orderId}
Headers
| Name | Value |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
account | string | Required | Name of account in NT8 |
orderId | string | Required | NT8-assigned order ID or the custom orderId supplied to Place Order. |
Code examples
- Python
- JavaScript
- cURL
import requests
token = 'my-secret-token'
url = "https://app.crosstrade.io/v1/api/accounts/Sim101/orders/492281fc515e431692da57d957cfebb6"
headers = {
"Authorization": f"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 token = 'my-secret-token';
const url = "https://app.crosstrade.io/v1/api/accounts/Sim101/orders/492281fc515e431692da57d957cfebb6";
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/accounts/Sim101/orders/492281fc515e431692da57d957cfebb6" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json"
Response
- 200
- 400
- 401
- 403
- 408
- 429
- 500
{
"account": "Sim101",
"id": "50cca7b8051146c684087db511107983",
"type": "NinjaTrader.Cbi.Order",
"clientId": -1,
"onBehalfOf": "",
"instrument": "ES 12-25",
"instrumentType": "Future",
"orderType": "Market",
"orderState": "CancelPending",
"quantity": 1,
"averageFillPrice": 0.0,
"filled": 0,
"fromEntrySignal": null,
"gtd": "2099-12-01T00:00:00.0000000",
"hasOverfill": false,
"isBacktestOrder": false,
"limitPrice": 0.0,
"limitPriceChanged": 0.0,
"ocoId": "",
"orderAction": "Buy",
"quantityChanged": 0,
"stopPrice": 0.0,
"stopPriceChanged": 0.0,
"time": "2025-09-05T07:17:36.4864736",
"epoch": 1725545856486,
"timeInForce": "Day",
"name": "",
"isLimit": false,
"isLiveUntilCancelled": false,
"isLong": true,
"isMarket": true,
"isMarketIfTouched": false,
"isShort": false,
"isSimulatedStop": false,
"isStopLimit": false,
"isStopMarket": false,
"isTrackingConfigured": false,
"isTrackingEnabled": false,
"userData": "<NinjaTrader />",
"ownerStrategy": {
"id": null,
"name": null,
"displayName": null
},
"success": true
}
{
"error": "Order 'example-order' not found"
}
{
"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
Float fields accept whole or fractional JSON numbers. Nullable fields are marked below.
| Field | Type | Description |
|---|---|---|
success | boolean | true on success. |
id, type, account, instrument, instrumentType | string | Current order ID, object type and instrument identity. |
time, gtd | string | Order time and good-till date. |
epoch | integer | Unix milliseconds. |
name, ocoId, onBehalfOf | string | Order labels; may be empty. |
clientId | integer | NT8 client ID. |
orderType, orderState, orderAction, timeInForce | string | Order type, state, side and duration. |
quantity, quantityChanged, filled | integer | Requested, changed and filled quantities. |
limitPrice, limitPriceChanged, stopPrice, stopPriceChanged, averageFillPrice | float | Order prices. |
fromEntrySignal | string or null | Associated entry signal. |
hasOverfill, isBacktestOrder, isLimit, isLiveUntilCancelled | boolean | Order flags. |
isLong, isShort, isMarket, isMarketIfTouched | boolean | Side and type flags. |
isSimulatedStop, isStopLimit, isStopMarket, isTrackingConfigured, isTrackingEnabled | boolean | Stop and tracking flags. |
userData | string | NT8 user-data XML. |
ownerStrategy | object | Strategy metadata. |
ownerStrategy.id, ownerStrategy.name, ownerStrategy.displayName | string or null | Null when no owning strategy is identified. |
Platform nuances
Order ID lookup
CrossTrade first attempts to match the current NT8 order ID. If that is not found, it also asks NT8 to resolve the caller-supplied ID stored in the order's UserData XML under AutomatedTradingOrderId. This lets you query by the custom orderId you sent at placement even if NT8, the broker, or a prop firm later changes the live order ID.
WebSocket API
This request can also be made over the WebSocket API. The account and orderId path parameters are passed inside args. The orderId value may be either the current NT8 order ID or your custom placement ID.
{
"action": "rpc",
"id": "my-request-id",
"api": "GetOrder",
"args": {
"account": "Sim101",
"orderId": "492281fc515e431692da57d957cfebb6"
}
}
Get order by ID Tradovate
Returns the raw Tradovate order item for one order. No NinjaTrader add-on is involved: the read executes server-side against the Tradovate Web API, so it works even while NinjaTrader is closed.
Endpoint
GET /v1/api/tv/accounts/{account}/orders/{id}
Headers
| Name | Value |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
account | string | Required | Required route segment for the endpoint URL. |
id | string | Required | Tradovate order ID, for example 123456789. |
Code examples
- Python
- JavaScript
- cURL
import requests
token = 'my-secret-token'
url = "https://app.crosstrade.io/v1/api/tv/accounts/DEMO12345678/orders/123456789"
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/DEMO12345678/orders/123456789";
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/DEMO12345678/orders/123456789" \
-H "Authorization: Bearer $TOKEN"
Response
The response uses the Tradovate read envelope. data is the raw Tradovate Order entity, and its live state is in ordStatus. Quantity, order type, and prices belong to OrderVersion and are not enriched here. See GET Order Lifecycle for version data and command outcomes.
- 200
- 400
- 401
- 403
- 429
- 500
- 502
- 503
{
"success": true,
"data": {
"id": 123456789,
"accountId": 12345678,
"contractId": 1234,
"timestamp": "2026-10-27T12:00:00Z",
"action": "Buy",
"ordStatus": "Working",
"executionProviderId": 14,
"archived": false,
"external": false,
"admin": false
}
}
{
"success": false,
"error": "tradovate_rejected",
"detail": "The requested order could not be read."
}
{
"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
Broker-specific and relationship fields may be omitted; omission does not mean null.
| Field | Type | Description |
|---|---|---|
success | boolean | true on success. |
data | object | Order entity. |
data.id, data.accountId, data.contractId | integer | Broker IDs. |
data.timestamp, data.action, data.ordStatus | string | Timestamp, side and live state. |
data.archived, data.external, data.admin | boolean | Broker flags. |
data.executionProviderId, data.linkedId, data.ocoId, data.parentId | integer | Optional provider and related-order IDs. |
data.clOrdId, data.correlationClOrdId | string | Optional correlation identifiers. |
Platform nuances
- Tradovate uses
{id}in this route, while the NT8 route uses{orderId}. - The current REST handler passes
{id}directly to the Tradovate order-item lookup. It does not resolve a caller-supplied customorderId, and{account}is not used to verify ownership of the returned order. ordStatuscan beWorking,Filled,Canceled,Rejected, or another Tradovate order-state string.
See the Tradovate API overview for the full route list and error table.