POST
/
api
/
v1
/
developer
/
trading
/
hyperliquid
/
info
/
fills
Get user fills
curl --request POST \
  --url https://api.allium.so/api/v1/developer/trading/hyperliquid/info/fills \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "type": "userFills",
  "user": "0x1234567890abcdef1234567890abcdef12345678",
  "startTime": 1640995200000,
  "endTime": 1641081600000,
  "aggregateByTime": false
}'
[
  {
    "closedPnl": "<string>",
    "coin": "<string>",
    "crossed": true,
    "dir": "<string>",
    "hash": "<string>",
    "oid": 123,
    "px": "<string>",
    "side": "<string>",
    "startPosition": "<string>",
    "sz": "<string>",
    "time": 123,
    "fee": "<string>",
    "feeToken": "<string>",
    "tid": 123,
    "liquidation": {
      "liquidatedUser": "<string>",
      "markPx": "<string>",
      "method": "<string>"
    }
  }
]
This endpoint is a 1-1 drop in replacement for the userFills and userFillsByTime in HyperliquidHowever there are no limits to how far back you can go when fetching fills.

Authorizations

X-API-KEY
string
header
required

Body

application/json
type
enum<string>
required

Type of fills to retrieve

Available options:
userFills,
userFillsByTime,
userTwapSliceFills
user
string
required

User's wallet address (hex string)

startTime
integer

Start time filter (Unix timestamp in milliseconds). Required for userFillsByTime type.

endTime
integer

End time filter (Unix timestamp in milliseconds)

aggregateByTime
boolean

Whether to aggregate fills by time

Response

Fills retrieved successfully

closedPnl
string | null

Closed PnL from this fill

coin
string | null

Trading pair symbol

crossed
boolean | null

Whether the fill crossed the spread

dir
string | null

Direction of the fill

hash
string | null

Transaction hash

oid
integer | null

Order ID

px
string | null

Fill price

side
string | null

Order side (A for long/buy, B for short/sell)

startPosition
string | null

Position size before fill

sz
string | null

Fill size

time
integer | null

Fill timestamp

fee
string | null

Fee amount

feeToken
string | null

Fee token symbol

tid
integer | null

Trade ID

liquidation
object

Liquidation details if this was a liquidation