Fill History

HyperliquidPolymarket

Returns fills in newest protocol commit order (block number, then transaction index). The time field is the venue trade time, so it need not decrease from one row to the next. There is no time-range filter. Each page examines at most 500 indexed transactions; unrelated transactions can produce an empty page with a continuation cursor.

Endpoint

POST /info

Request Body

Parameter	Type	Description
`type`*	string	Must be `"userFills"`
`user`*	string	User’s wallet address (case-insensitive), e.g., `"0x1234567890abcdef..."`

For an incremental refresh, pass afterBlock from a previously completed response’s snapshotBlock. For continuation, pass the exact nextCursor as cursor with the same user; do not also send afterBlock. No limit parameter is accepted.

{
  "type": "userFills",
  "user": "0x1111111111111111111111111111111111111111",
  "cursor": {
    "user": "0x1111111111111111111111111111111111111111",
    "snapshotBlock": 100,
    "afterBlock": 0,
    "beforeBlock": 90,
    "beforeTxIndex": 4
  }
}

Response

200: Fills

{
  "snapshotBlock": 100,
  "nextCursor": null,
  "fills": [
  {
    "coin": "BTC",
    "marketAssetId": "00020000",
    "px": "50000.00",
    "sz": "0.1",
    "side": "B",
    "time": 1701234567890,
    "startPosition": "0",
    "dir": "Open Long",
    "closedPnl": "0",
    "hash": "0x1234abcd...",
    "orderId": "0x1234567890abcdef1234567890abcdef",
    "crossed": true,
    "fee": "2.50",
    "tid": 67890,
    "feeToken": "USDC"
  },
  {
    "coin": "polymarket:5615282760875985231868508008056959876238536896643315063916840237042205273721",
    "marketAssetId": "10010c6a232d8b7ebad17d093c8cc5f7b2326b41052074f4ae9883e22ab7e9f52e79",
    "px": "0.42",
    "sz": "2.5",
    "side": "A",
    "time": 1701234567900,
    "startPosition": "0",
    "startPositionStatus": "unknown",
    "dir": "Sell",
    "closedPnl": "0",
    "closedPnlStatus": "unknown",
    "hash": "0xabcd1234...",
    "orderId": "0xabcdef1234567890abcdef1234567890",
    "crossed": false,
    "crossedStatus": "unknown",
    "fee": "0.01",
    "tid": 67891,
    "feeToken": "pUSD",
    "settlementStatus": "finalized"
  }
  ]
}

Page fields

fills contains the rows below. snapshotBlock fixes the committed high-water mark for the whole traversal. Continue until nextCursor is null, including when fills is empty. Unknown fields, malformed cursors and cross-wallet cursors return 400; a reader behind the requested watermark returns 503. A committed transaction that cannot be rendered as a canonical fill fails the request with 500 and pages an operator — read failures remain errors rather than empty history. Commit order differs from trade time, especially after delayed finalization. To select a global window by time, traverse the snapshot before sorting. The app keeps its most recent 2,000 by trade time, then refreshes only commits after its completed watermark. Initial load and full-history consumers still traverse all indexed transactions through bounded sequential requests.

Fill fields

Field	Type	Description
`coin`	string	Asset symbol, or `"polymarket:<tokenId>"` for Polymarket
`marketAssetId`	string	Unprefixed AssetId for the fill’s market
`px`	string	Fill price, e.g., `"50000.00"`
`sz`	string	Fill size, e.g., `"0.1"`
`side`	string	`"B"` for buy or `"A"` for sell
`time`	number	Fill time in Unix milliseconds, e.g., `1701234567890`
`startPosition`	string	Position before fill, or the placeholder `"0"` when status is unknown
`startPositionStatus`	string	Optional `"known"` or `"unknown"`; ignore `startPosition` when unknown
`dir`	string	Direction, e.g., `"Open Long"`
`closedPnl`	string	Realized PnL, or the compatibility placeholder `"0"` when status is unknown
`closedPnlStatus`	string	Optional `"known"` or `"unknown"`; ignore `closedPnl` when unknown
`hash`	string	Transaction hash, e.g., `"0x1234abcd..."`
`orderId`	string	Notional order ID; forced-closure fills use their allocation ID
`crossed`	boolean	Whether the fill crossed the book; ignore only when `crossedStatus` is `"unknown"`
`crossedStatus`	string	Optional authority flag; currently `"unknown"` for Polymarket fills
`fee`	string	All-in fee in `feeToken` units, including venue and protocol fees where applicable
`tid`	number	Venue trade ID for ordinary Hyperliquid fills; synthetic ID for Polymarket and forced closures
`feeToken`	string	Fee denomination, currently `"USDC"` or `"pUSD"`
`settlementStatus`	string	Polymarket only: currently `"finalized"` after Polygon finality
`forcedClosureType`	string	Optional forced-closure type: `"adl"`, `"backstop"`, or `"notionalAdl"`

Polymarket fills appear after Polygon finality with settlementStatus: "finalized". Pending CLOB matches remain available through orderUpdates.polymarketFills. For sells from positions without complete canonical cost basis, closedPnlStatus remains "unknown" after finalization. Polymarket finalized fills emitted after the accounting cutover have an authoritative startPosition; legacy fills retain the numeric "0" placeholder with startPositionStatus: "unknown". Maker/taker role is not currently canonical, so crossedStatus is "unknown". Authority flags are optional: when omitted, interpret the field using established userFills semantics; when unknown, ignore its compatibility placeholder.

Start Here

Info

Analytics

Exchange

WebSocket

Endpoint

Request Body

Response

Page fields

Fill fields

​Endpoint

​Request Body

​Response

​Page fields

​Fill fields

Endpoint

Request Body

Response

Page fields

Fill fields