Skip to main content

Get orders history

GET 
/v1/history/accounts/:account_id/orders

Returns historical closed orders within the configured history age and range limits.

Orders:

  • available order states: filled, cancelled, rejected
  • open, placed, or pending orders are not returned by this method and should be retrieved through the trading state snapshot
  • positions of filled orders are not returned by this method and can be calculated based on deals with type = 'open', 'close'

Query rules:

  • from is required when cursor is not provided
  • from must be earlier than the current server time
  • the requested history window must be within the configured history age
  • the requested range length must not exceed the configured history range
  • retrieve the current values from GET /v1/configuration/accounts/{account_id}/limits
  • use either:
    • 'from' + optional 'to'
    • or 'cursor'
    • 'to' must be later than 'from'
    • 'cursor' cannot be combined with filters other than limit
    • limit must be between 1 and 200
    • returned orders are sorted in ascending order by event_time, from older to newer

Filtering:

  • by order state: filled, cancelled, rejected
  • by instrument

Response composition:

  • each item contains exactly one historical order
  • orders are returned only if their own event_time is within the requested range
  • related objects outside the requested range are not expanded into the response

Runtime restrictions:

  • unavailable if trade_mode is trading_disabled

Request​

Responses​

Orders history returned successfully