Futures order and fill history
https://app.skylit.ai/api/nexus/v1/trading/accounts/{account}/ordersThe orders your keys placed in this account, newest first, with the clientOrderId each was sent with, the key that placed it, and each fill's commission and gross realized P/L (0 on a fill that only opened). Page back with before: send the placedAt of the last order you have.
Authorization
Authorization: Bearer <your API key>Required. A missing header returns 401; an invalid, revoked or expired key returns 403.
Path parameters
accountstringrequiredpractice,agent(your bot's account),evaluationorfunded(when you have exactly one running), or a futures account id from capabilities.
Query parameters
limitintegerdefault50min 1 · max 200Page size.
beforestringdate-timeOnly orders placed before this time, like
2026-10-09T14:00:00Z.
Responses
- 200
The orders.
meta.countis how many are on this page. - 400
The request was refused before anything was traded. Codes:
bad_request,bad_contract,invalid_quantity,invalid_price,unsupported_asset_class,unsupported_order_type,only_market_orders,limit_price_required(a limit with nolimitPrice),invalid_limit_price(not in cents, or outside 0.01 to 99,999.99 for options or 999,999.99 for stocks),stop_price_required(a stop with nostopPrice),invalid_stop_price(not in cents, or outside 0.01 to 999,999.99),invalid_take_profit,test_orders_unavailable,test_modify_unavailable. - 401
No key, or a key that isn't valid. Codes:
missing_api_key,invalid_api_key. - 403
The key works but the account can't do this. Codes:
account_suspended,nexus_access_denied,futures_access_denied. - 404
Not on your account. Codes:
trade_not_found,account_not_found,order_not_found. - 429
Over a rate limit. Wait
Retry-Afterseconds, then retry. Codes:rate_limited, andstream_limit_reached(too many live streams open: 3 per key, 6 per account). - 503
Try again in a moment (honour
Retry-Afterwhen it's sent). Codes:stale_quote(the quote, or a stock's last trade, is more than 15 seconds old, so nothing filled),no_live_price,rules_pending,unavailable,auth_unavailable,access_check_unavailable,api_keys_unavailable,trades_api_disabled,stream_unavailable(the live stream isn't on, or the server is restarting: try again shortly, or poll the reads).
Response fields
dataobject[]idstringuuidassetClassstringfuturessourcestringapiwhen a key placed it. Left out on an order you placed in Nexus.accountobjectsymbolstringThe contract, like
NQZ26.sidestringbuysellquantityintegerrolestringentryclosestop_losstake_profitorderTypestringmarketlimitstopstop_limitstatusstringheldis a stop or target waiting for its entry to fill.workingheldfilledcancelledrejectedstatusReasonstringWhy it was cancelled or rejected.
limitPricenumberstopPricenumbertrailingDistancenumberA trailing stop: how far behind the price it follows, in points.
fillPricenumberplacedAtstringdate-timefilledAtstringdate-timetriggeredAtstringdate-timeA stop-limit: when a trade hit its stop. From then on it works as a limit.
parentIdstringuuidOn a stop or target: the entry it was placed with.
bracketobject[]The stop and target placed with this order, each a
FuturesOrderwith its own id.clientOrderIdstringkeyIdstringThe public id of the key that placed it.
commissionCentsintegerrealizedPnlCentsintegerGross realized P/L of this fill. 0 on a fill that only opened.
testbooleantrueon a test order.
metaobjectcountintegerlimitinteger
Last updated