v1
latestOpenAPI 3.1.02026-07-2681217214.1 KBGet user fills
Retrieve fill data for a user including regular fills and TWAP slice fills
Request body
Type of fills to retrieve. Applies to all request types.
User's wallet address (hex string). Applies to all request types.
Start time filter (Unix timestamp in milliseconds). Required for userFillsByTime. Only applies to userFillsByTime.
End time filter (Unix timestamp in milliseconds). Only applies to userFillsByTime.
When true, aggregates multiple fills from the same order at the same timestamp into a single fill with combined size, weighted average price, and summed fees/PnL. Only applies to userFills and userFillsByTime.
Controls TWAP fill filtering: 'none' (default) excludes TWAP fills, 'include' returns both regular and TWAP fills, 'only' returns only TWAP fills. Only applies to userFills and userFillsByTime.
Response
Fills retrieved successfully
Realized PnL from closing a position with this fill
Trading pair symbol (e.g., BTC, ETH)
Whether the order crossed the spread (i.e., was a taker order)
Direction description (e.g., Open Long, Close Short, Buy, Sell)
Transaction hash
Order ID
Execution price
Order side: B (buy) or A (sell)
Position size before this fill was executed
Fill size
Fill timestamp (Unix timestamp in milliseconds)
Trading fee amount
Token used for fee payment
Unique trade ID
Builder fee if order was routed through a builder
Address of the builder if applicable
TWAP order ID if this fill is part of a TWAP order