Sign in
latestOpenAPI 3.0.3Apache 2.02026-08-2156323220.5 KB

76e4e47cf3aa

Get Fills

Get fill history for the authenticated account. If no end time is provided, the current time will be used. Maximum of 100 entries returned per request. Results are ordered by time; use sort to choose newest-first (desc, default) or oldest-first (asc). To page through more than 100 fills, pass the cursor returned by the previous page (keep sort consistent across pages). Passing the trade ID of the last fill from the previous page is also still accepted.

get/v1/account/fills

Query parameters

start_timestampinteger

Start timestamp in milliseconds

Example:1767225600000
end_timestampinteger

End timestamp in milliseconds

Example:1767229200000
cursorstring

Pagination cursor. Pass the opaque cursor returned by the previous page to fetch the next page. Paging follows the sort direction (strictly older fills when sort=desc, strictly newer when sort=asc). The trade ID of the last fill from the previous page is also accepted for backwards compatibility.

Example:eyJ0cyI6MTc2NzIyNTYwMDAwMDAwMDAwMCwiaWQiOjF9
sort'desc' | 'asc'

Time sort direction. desc (default) returns newest fills first; asc returns oldest first.

Response

Fills response.

moreboolean required

More data available

cursorstring

Opaque keyset pagination cursor for the next page of fills. Present while more is true; pass it as cursor on the next request, keeping the other parameters the same across pages.

Example response

{
  "data": [
    {
      "trade_id": 1,
      "order_id": 1234567890,
      "instrument_id": 1,
      "price": "100.00",
      "quantity": "10.00",
      "fee": "1.25",
      "fee_asset": "USDC",
      "previous_size": "26.86",
      "previous_entry_price": "100.00",
      "pnl": "100.00",
      "timestamp": 1767225600000,
      "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
    }
  ],
  "cursor": "eyJ0cyI6MTc2NzIyNTYwMDAwMDAwMDAwMCwiaWQiOjF9"
}