Get Fills

Changed on

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. Pass instrument_id to narrow the page to one instrument's fills; the window, cursor and sort apply unchanged.

get/v1/account/fills

Request

  • Base URL: https://api.perpetuals.polymarket.com
  • URL: https://api.perpetuals.polymarket.com/v1/account/fills
  • Auth: API key in header POLYMARKET-PROXY and API key in header POLYMARKET-SECRET

Query parameters

instrument_idinteger

Instrument ID — when set, only fills on this instrument are returned

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"
}

Changes