Skip to main content
POST
/
info
builderFills | Hyperliquid Info API
curl --request POST \
  --url https://hypercore.goldrushdata.com/info \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>",
  "builder": "<string>",
  "aggregateByTime": true,
  "cursor": "<string>"
}
'
{
  "user": "<string>",
  "coin": "<string>",
  "px": "<string>",
  "sz": "<string>",
  "side": "<string>",
  "time": 123,
  "startPosition": "<string>",
  "dir": "<string>",
  "closedPnl": "<string>",
  "hash": "<string>",
  "oid": 123,
  "tid": 123,
  "crossed": true,
  "fee": "<string>",
  "feeToken": "<string>",
  "builderFee": "<string>",
  "cloid": "<string>",
  "liquidation": {
    "liquidatedUser": "<string>",
    "markPx": "<string>",
    "method": "<string>"
  }
}

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "builderFills" is used to fetch a builder’s most recent attributed trade fills for revenue attribution and order-flow analytics.
  • GoldRush-native: No POST api.hyperliquid.xyz/info equivalent. Available only via POST hypercore.goldrushdata.com/info.
  • Each response contains at most 2,000 fills, ordered most-recent first.
  • For windowed queries for revenue reports and monthly reconciliation, use builderFillsByTime.
  • For real-time push instead of windowed polling, subscribe to walletTxs and read HypercoreFillTransaction events.
Returns the 2,000 most recent fills attributed to a builder address. Use this when you operate a builder code and want to inspect the order flow routed through it without specifying a time window. Builder-keyed. GoldRush-native so there is no upstream Hyperliquid /info equivalent.

​
Endpoint

POST https://hypercore.goldrushdata.com/info
Authorization: Bearer <GOLDRUSH_API_KEY>
Content-Type: application/json

​
Request

​
type
string
required
Always "builderFills".
​
builder
string
required
The builder address that orders were routed through. Must be a 0x-prefixed 42-character hex address.
​
aggregateByTime
boolean
When true, partial fills sharing the same timestamp are consolidated into one row. Default false.
​
cursor
string
Pagination cursor — a Unix timestamp in milliseconds encoded as a string. When set, returns fills strictly before this time. Use the time value of the oldest fill in the previous page to fetch the next page.

​
Example

curl -X POST https://hypercore.goldrushdata.com/info \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "builderFills",
    "builder": "0x0000000000000000000000000000000000000000"
  }'

​
Response

An array of fill objects ordered most-recent-first. Each entry is a fill from an order that was routed through the builder address. 
[
  {
    "user": "0x73f9c53a8b15e43056d5599f6488ac9a8730f85d",
    "coin": "HYPE",
    "px": "66.977",
    "sz": "0.69",
    "side": "B",
    "time": 1781518798259,
    "startPosition": "0",
    "dir": "Open Long",
    "closedPnl": "0",
    "hash": "0x2b7bd2df9499dfef2cf5043dc500b402068500c52f9cfec1cf447e32539db9d9",
    "oid": 469533808540,
    "crossed": true,
    "fee": "0.048524",
    "tid": 332575399132451,
    "feeToken": "USDC",
    "builderFee": "0.027728",
    "cloid": "0xff8ffaa775354e8faf1eaa18127d6b5e"
  }
]

​
Field descriptions

All numeric fields (px, sz, startPosition, closedPnl, fee, builderFee) are returned as decimal strings with full upstream precision (up to 18 decimal places). Do not parse them as floats - keep them as strings or use a fixed-precision decimal type.
​
user
string
The trader’s wallet address - the account that placed the order routed through the builder code.
​
coin
string
Asset symbol - e.g. "BTC", "ETH" for perps; spot pairs use the @N form (e.g. "@107"); HIP-3 markets use the deployer-prefixed form.
​
px
string
Fill execution price.
​
sz
string
Fill size.
​
side
string
"B" for buy/long, "A" for ask/short.
​
time
int
Unix timestamp in milliseconds when the fill executed.
​
startPosition
string
Signed position size the trader held on this coin immediately before this fill.
​
dir
string
Human-readable direction label - "Open Long", "Open Short", "Close Long", "Close Short", "Buy", "Sell", or position-flip labels "Long > Short" / "Short > Long".
​
closedPnl
string
Realized PnL in USDC attributable to this fill for the trader (zero when the fill opens or extends a position).
​
hash
string
L1 transaction hash that included this fill.
​
oid
int
Parent order ID.
​
tid
int
Unique trade ID.
​
crossed
boolean
true when the fill came from the taker side of the order, false when it was the maker side.
​
fee
string
Trading fee paid by the trader for this fill, denominated in feeToken.
​
feeToken
string
Symbol the fee was paid in - typically "USDC".
​
builderFee
string
Optional. Builder fee earned for this fill, denominated in feeToken. Omitted when no builder fee was charged.
​
cloid
string
Optional. Client order ID (0x-prefixed 32-character hex) if one was set at order placement.
​
liquidation
object
Optional. Present only when this fill closed a position as part of a liquidation event.

builderFillsByTime

fetch a builder’s attributed trade fills within a time window for revenue attribution and fee accounting.

userFills

fetch a user’s most recent trade fills without specifying a time window.

userFillsByTime

fetch a user’s trade fills within a time window for P&L recaps and tax ledger reconstruction.

userTwapSliceFills

fetch a user’s most recent TWAP slice fills for execution-quality analytics on algorithmic orders.
Last reviewed: 2026-06-16