Order Items
Retrieve several orders by ID.
Available to: Traders (own accounts and any they hold an approved trading permission for); organization administrators (any account in their organization)
Environments: Demo, Live
Rate Limit: No endpoint-specific limit
On Live, some organizations restrict administrators from accessing other members’ accounts unless they hold an approved trading permission for that account.
Resolve multiple orderIds to their order records in a single call. Prefer this over repeated orderItem calls when you need to resolve several IDs at once.
Common Failure Scenarios
- An ID in
idsthat doesn’t match an order, or matches one you can’t access, is left out of the response array. The call still succeeds, so compare the returned records against the IDs you requested. - The
idsparameter is missing or repeated (HTTP 404), or contains a value that isn’t a number (HTTP 500). - The caller’s user type, or the API key’s permissions, can’t read orders. This returns
HTTP 401with"Access is denied".
Error Messages
Related Endpoints
- Use
orderItemto resolve a singleorderId. - Use
orderLDependentsto retrieve the orders for several accounts.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
ids
Response
Order
accountId
timestamp
Create Time
action
Buy, Sell
Allowed values:
ordStatus
Canceled, Completed, Expired, Filled, PendingCancel, PendingNew, PendingReplace, Rejected, Suspended, Unknown, Working
admin
id
contractId
spreadDefinitionId
executionProviderId
ocoId
parentId
linkedId
clOrdId