Fills by Address

Get HL user fills

get

Retrieve fills in hyperliquid of an address at any time range. Returns in descending order. Defaults to last 30 records.

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

addressstringRequired

Query parameters

limitinteger · min: 1 · max: 1000Optional

Number of records to return

Default: 30

start_timestampany ofOptional

Start timestamp in Unix epoch milliseconds (optional filter)

integerOptional

or

nullOptional

end_timestampany ofOptional

End timestamp in Unix epoch milliseconds (optional filter)

integerOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/v1/fills/{address}

HTTPcURLJavaScriptPython

GET /v1/fills/{address} HTTP/1.1
Host: data.blockliquidity.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "timestamp": 1,
      "hash": "text",
      "tid": 1,
      "oid": 1,
      "token": "text",
      "px": 1,
      "sz": 1,
      "side": "text",
      "dir": "text",
      "closed_pnl": 1,
      "start_position": 1,
      "crossed": true,
      "fee": 1,
      "fee_token": "text",
      "liquidated_user": "text",
      "mark_px": 1,
      "method": "text",
      "twap_id": 1,
      "builder": "text",
      "builder_fee": 1
    }
  ]
}