Retrieve a List of Orders

GET {{baseUrl}}/v1/trading/accounts/:account_id/orders

Retrieves a list of orders for the account, filtered by the supplied query parameters.

Endpoint defaults to open orders if no parameters are provided.

Request Params

KeyDatatypeRequiredDescription
statusstringOrder status to be queried. open, closed or all. Defaults to open.
limitnumberThe maximum number of orders in response. Defaults to 50 and max is 500.
afterstringThe response will include only ones submitted after this timestamp (exclusive.)
untilstringThe response will include only ones submitted until this timestamp (exclusive.)
directionstringThe chronological order of response based on the submission time. asc or desc. Defaults to desc.
nestedbooleanIf true, the result will roll up multi-leg orders under the legs field of primary order.
symbolsstringA comma-separated list of symbols to filter by.
qty_abovestring
qty_belowstring
subtagstring

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

[{"id":"61e69015-8549-4bfd-b9c3-01e75843f47d","symbol":"AALP","client_order_id":"61e69015-8549-4bfd-b9c3-01e75843f47d","created_at":"2021-03-16T18:38:01.942282Z","updated_at":"2021-03-16T18:38:01.942282Z","submitted_at":"2021-03-16T18:38:01.942282Z","filled_at":"2021-03-16T18:38:01.942282Z","expired_at":"2021-03-16T18:38:01.942282Z","canceled_at":"2021-03-16T18:38:01.942282Z","failed_at":"2021-03-16T18:38:01.942282Z","replaced_at":"2021-03-16T18:38:01.942282Z","replaced_by":"61e69015-8549-4bfd-b9c3-01e75843f47d","replaces":"61e69015-8549-4bfd-b9c3-01e75843f47d","asset_id":"61e69015-8549-4bfd-b9c3-01e75843f47d","asset_class":"crypto","notional":"4.2","qty":"4.2","filled_qty":"4.2","filled_avg_price":"4.2","order_class":"bracket","order_type":"stop","type":"stop","side":"buy","time_in_force":"gtc","limit_price":"3.14","stop_price":"3.14","status":"filled","extended_hours":true,"legs":[{"value":"\u003cCircular reference to #/components/schemas/Order detected\u003e"},{"value":"\u003cCircular reference to #/components/schemas/Order detected\u003e"}],"trail_price":"3.14","trail_percent":"5.0","hwm":"3.14","commission":"3.14","commission_bps":"10","swap_rate":"est labore commodo officia","swap_fee_bps":"laborum ex","usd":{}},{"id":"61e69015-8549-4bfd-b9c3-01e75843f47d","symbol":"AALP","client_order_id":"61e69015-8549-4bfd-b9c3-01e75843f47d","created_at":"2021-03-16T18:38:01.942282Z","updated_at":"2021-03-16T18:38:01.942282Z","submitted_at":"2021-03-16T18:38:01.942282Z","filled_at":"2021-03-16T18:38:01.942282Z","expired_at":"2021-03-16T18:38:01.942282Z","canceled_at":"2021-03-16T18:38:01.942282Z","failed_at":"2021-03-16T18:38:01.942282Z","replaced_at":"2021-03-16T18:38:01.942282Z","replaced_by":"61e69015-8549-4bfd-b9c3-01e75843f47d","replaces":"61e69015-8549-4bfd-b9c3-01e75843f47d","asset_id":"61e69015-8549-4bfd-b9c3-01e75843f47d","asset_class":"crypto","notional":"4.2","qty":"4.2","filled_qty":"4.2","filled_avg_price":"4.2","order_class":"bracket","order_type":"stop","type":"stop","side":"buy","time_in_force":"gtc","limit_price":"3.14","stop_price":"3.14","status":"filled","extended_hours":true,"legs":[{"value":"\u003cCircular reference to #/components/schemas/Order detected\u003e"},{"value":"\u003cCircular reference to #/components/schemas/Order detected\u003e"}],"trail_price":"3.14","trail_percent":"5.0","hwm":"3.14","commission":"3.14","commission_bps":"10","swap_rate":"1.23","swap_fee_bps":"1.23","usd":{}}]