builderFills | Hyperliquid API Docs

Retrieve latest fills attributed to one builder address from the Dwellir Hyperliquid Index over /info or JSON-RPC.

Use builderFills to retrieve recent fills routed through a builder address. Results include user and builderFee when available.

Endpoints

REST-style Info API:

Text

POST https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/info

JSON-RPC:

Text

POST https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/jsonrpc

Parameters

Field	Type	Required	Description
`type`	string	yes	Must be `builderFills` for `/info`.
`builder`	string	yes	0x-prefixed builder address.
`limit`	number	no	Maximum rows to return, capped at 2000.

Billing

Billed by returned fill objects

builderFills responses are billed by the number of fill objects returned, not as one response per HTTP request. A response with 100 fills counts as 100 responses/API credits.

Requests that return an empty array are billed as 0 responses/API credits and do not count against usage. Error responses are not charged.

REST-style Example

Bash

curl -X POST "https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/info" \
  -H "content-type: application/json" \
  -d '{
  "type": "builderFills",
  "builder": "0x2222222222222222222222222222222222222222",
  "limit": 100
}'

JSON-RPC Example

Bash

curl -X POST "https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/jsonrpc" \
  -H "content-type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "builderFills",
  "params": {
    "builder": "0x2222222222222222222222222222222222222222",
    "limit": 100
  }
}'

Response

REST /info responses return an array directly. JSON-RPC responses return the same array under result. Empty matches return []; they are not errors.

builderFills - Builder Fill History