Get Current Position Fills

Get every fill in a registered account's current open position cycle for one instrument. A cycle begins when the position opens from flat or flips direction. For a flip, every fill from the flipping engine event belongs to the new cycle so a fill is never split between cycles.

Returns an empty page when the account has no open position for the instrument. 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 opaque cursor returned by the previous page and keep sort unchanged. Each page verifies that the cursor still describes the account's current position cycle. If that position changes while pagination is in progress, the cursor returns 400 and pagination must restart from the first page.

Cycle discovery for a position inherited from a gateway snapshot is limited to 250,000 account-history rows. A cycle older than that bound returns 413 rather than allowing a public request to run an unbounded ClickHouse scan. Positions opened or flipped after gateway startup carry their cycle boundary directly and do not use this discovery scan.

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