Orders

Get orders

Get current user orders filtered on attributes

get/orders-history

Query parameters

client_idstring

Unique ID of client generating the order

cursorstring

Returns the ‘next’ paginated page.

end_atinteger

End Time (unix time millisecond)

marketstring

Market for the order

page_sizeinteger

Limit the number of responses in the page

side'BUY' | 'SELL'

Order side

start_atinteger

Start Time (unix time millisecond)

status'OPEN' | 'CLOSED' | 'NEW'

Order status

Order type

Response

nextstring

The pointer to fetch next set of records (null if there are no records left)

prevstring

The pointer to fetch previous set of records (null if there are no records left)

Example response

{
  "next": "eyJmaWx0ZXIiMsIm1hcmtlciI6eyJtYXJrZXIiOiIxNjc1NjUwMDE3NDMxMTAxNjk5N=",
  "prev": "eyJmaWx0ZXIiOnsiTGltaXQiOjkwfSwidGltZSI6MTY4MTY3OTgzNzk3MTMwOTk1MywibWFya2VyIjp7Im1zMjExMD==",
  "results": [
    {
      "account": "0x4638e3041366aa71720be63e32e53e1223316c7f0d56f7aa617542ed1e7512x",
      "avg_fill_price": "26000",
      "cancel_reason": "NOT_ENOUGH_MARGIN",
      "client_id": "x1234",
      "created_at": 1681493746016,
      "id": "123456",
      "last_updated_at": 1681493746016,
      "market": "BTC-USD-PERP",
      "price": "26000",
      "published_at": 1681493746016,
      "received_at": 1681493746016,
      "remaining_size": "0",
      "seq_no": 1681471234972000000,
      "size": "0.05",
      "timestamp": 1681493746016,
      "trigger_price": "26000"
    }
  ]
}

Changes

Changed in 1 of the 50 revisions of this API.2

Dec 24, 2025e0dd7ef9404f2See the full diff
- ○
  added the media type application/json for the response with the status 200
  response-media-type-added
- ○
  added the media type application/json for the response with the status 400
  response-media-type-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history