History

private/get_order_history

Returns a paginated history of orders for a single subaccount or for an entire wallet (specify exactly one), optionally bounded by a from/to timestamp window. Only orders in a terminal state (filled, cancelled, expired) are recorded here, one record per order. Trigger and algo orders appear once they terminate, carrying their accumulated filled amount; while they are still live — including partially executed algo orders and trigger orders that have not yet fired — read them from get_trigger_orders and get_algo_orders instead. Each page includes the order records plus pagination info with the total count and number of pages.

post/private/get_order_history

Request

  • Base URL: https://api.derive.xyz/v3
  • URL: https://api.derive.xyz/v3/private/get_order_history
  • Auth: none declared

Request body

from_timestampinteger nullable
pageinteger nullable
page_sizeinteger nullable
subaccount_idinteger nullable
to_timestampinteger nullable
walletstring nullable

Response

Success

subaccount_idinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.