Skip to navigation

Order L Dependents

View as Markdown

Retrieve the orders for several accounts.

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.

Return the orders for several accounts in a single call. Pass the account IDs as masterids. Prefer this over repeated orderDependents calls.

Common Failure Scenarios

  • Any one of the accounts in masterids doesn’t exist, or is one you can’t access. The whole call returns HTTP 401 with "Access is denied", not HTTP 404.
  • The masterids parameter 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 401 with "Access is denied".

Error Messages

MessageResponseTrigger
"Access is denied"401The caller’s user type, or the API key’s permissions, can’t read orders.
"Access is denied"401Any one of the accounts in masterids doesn’t exist, or the caller can’t see it.
(no message text)404The masterids parameter is missing or repeated.
"Internal Server Error, error id: {id}"500A value in masterids isn’t a number. The error ID is generated per request.

Related Endpoints

  • Use orderDependents to retrieve the orders for a single account.
  • Use orderList to retrieve every order you can access.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

masteridslist of longsRequired
List of Account entity IDs

Response

Order
accountIdlong
timestampdatetime
Create Time
actionenum
Buy, Sell
Allowed values:
ordStatusenum
Canceled, Completed, Expired, Filled, PendingCancel, PendingNew, PendingReplace, Rejected, Suspended, Unknown, Working
adminboolean
idlongOptional
contractIdlongOptional
spreadDefinitionIdlongOptional
executionProviderIdlongOptional
ocoIdlongOptional
parentIdlongOptional
linkedIdlongOptional
clOrdIdstringOptional