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.
Cached 2s — a request served from cache costs 1
Query Parameters
Address
"0x1234567890abcdef1234567890abcdef12345678"
Instrument ID
0 <= x <= 4294967295Opaque 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.
"eyJ0cyI6MTc2NzIyNTYwMDAwMDAwMDAwMCwiaWQiOjF9"
Time sort direction. desc (default) returns newest fills first; asc returns oldest first.
desc, asc Response
Current position fills response.
Account's trade history
More data available
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.
"eyJ0cyI6MTc2NzIyNTYwMDAwMDAwMDAwMCwiaWQiOjF9"