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
Key | Datatype | Required | Description |
---|---|---|---|
status | string | Order status to be queried. open, closed or all. Defaults to open. | |
limit | number | The maximum number of orders in response. Defaults to 50 and max is 500. | |
after | string | The response will include only ones submitted after this timestamp (exclusive.) | |
until | string | The response will include only ones submitted until this timestamp (exclusive.) | |
direction | string | The chronological order of response based on the submission time. asc or desc. Defaults to desc. | |
nested | boolean | If true, the result will roll up multi-leg orders under the legs field of primary order. | |
symbols | string | A comma-separated list of symbols to filter by. | |
qty_above | string | ||
qty_below | string | ||
subtag | string |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
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":{}}]