Skip to navigation

Order Strategy Items

View as Markdown

Retrieve several order strategies 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 orderStrategyIds to their order strategy records in a single call. Prefer this over repeated orderStrategyItem calls when you need to resolve several IDs at once.

Common Failure Scenarios

  • An ID in ids that doesn’t match an order strategy, 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 ids 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 order strategies. 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 order strategies.
(no message text)404The ids parameter is missing or repeated.
"Internal Server Error, error id: {id}"500A value in ids isn’t a number. The error ID is generated per request.

Related Endpoints

Authentication

AuthorizationBearer

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

Query parameters

idslist of longsRequired

Response

OrderStrategy
accountIdlong
timestampdatetime
contractIdlong
orderStrategyTypeIdlong
actionenum
Buy, Sell
Allowed values:
statusenum
ActiveStrategy, ExecutionFailed, ExecutionFinished, ExecutionInterrupted, InactiveStrategy, NotEnoughLiquidity, StoppedByUser
idlongOptional
initiatorIdlongOptional
paramsstringOptional<=8192 characters
uuidstringOptional<=64 characters
failureMessagestringOptional<=512 characters
senderIdlongOptional
customTag50stringOptional<=64 characters

Operator ID for the order. Send it only if NinjaTrader configured an allow-list of operator IDs for your user. In that case it’s required on every order and must exactly match one approved value. If no allow-list is configured, omit it: a supplied value is denied. Organizations using passthrough also omit it, and NinjaTrader fills it in. Up to 64 characters. See Operator ID (customTag50) and Passthrough.

userSessionIdlongOptional