Returns at most 2000 most recent fills for a specified user address
info
endpoint with type: "userFills"
retrieves a user’s trading fills (executed orders) on the Hyperliquid exchange. This endpoint returns detailed information about completed trades, including prices, sizes, fees, and profit/loss data for both perpetual and spot markets.
type
(string, required) — The request type. Must be "userFills"
to retrieve user fills.user
(string, required) — Address in 42-character hexadecimal format; e.g. 0x0000000000000000000000000000000000000000.aggregateByTime
(boolean, optional) — When true, partial fills are combined when a crossing order gets filled by multiple different resting orders. Resting orders filled by multiple crossing orders will not be aggregated.coin
— Asset identifier (simple names like “BTC”, “ETH” for perpetuals; spot format like “@107” for spot trades)px
— Fill price as a string for precisionsz
— Fill size (quantity traded)side
— Trade side: “A” for Ask/Sell, “B” for Bid/Buytime
— Fill timestamp in millisecondsoid
— Order ID that generated this filltid
— Unique trade IDstartPosition
— Position size before this filldir
— Trade direction (e.g., “Open Long”, “Close Short”, “Buy”, “Sell”)closedPnl
— Realized profit/loss from this fillcrossed
— Boolean indicating if this was a crossing orderfee
— Trading fee paid for this fillfeeToken
— Token used to pay the fee (typically “USDC”)builderFee
— Builder fee (optional, only present if non-zero)hash
— Transaction hash for blockchain verificationuserFillsByTime
info
endpoint with type: "userFills"
is essential for applications that need to:
Successful response with user fills data
The response is of type object[]
.