Skip to main content

Get deals history

GET 
/v1/history/accounts/:account_id/deals

Returns historical deals within the configured history age and range limits.

Deals:

  • all deal types may be returned
  • deals do not have lifecycle statuses
  • deals may represent both trading activity and balance operations
  • deal-to-order relation is exposed through deal.order_id, when applicable

Supported deal types:

  • open: position opening deal
  • close: position closing deal
  • balance: deposit or withdrawal
  • null_compensation
  • admin_fee
  • swap_fee
  • dividend
  • exness_dollar

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 deals are sorted in ascending order by event_time, from older to newer

Filtering:

  • by deal type: open, close, balance, null_compensation, admin_fee, swap_fee, dividend, exness_dollar
  • by instrument

Response composition:

  • each item contains exactly one historical deal
  • deals 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​

Deals history returned successfully