Skip to main content
POST
/
info
builderFillsByTime | 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>",
  "startTime": 123,
  "endTime": 123,
  "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: "builderFillsByTime" is used to fetch a builder’s attributed trade fills within a time window for revenue attribution and fee accounting.
  • 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; widen the window in chunks or page by advancing startTime if you need more.
  • GoldRush serves this type from a dedicated HyperCore historical store, so windows can extend back to GoldRush’s full HyperCore coverage.
  • Use builderFills (no Time suffix) when you only need the most recent N fills without specifying a window.
  • For real-time push instead of windowed polling, subscribe to walletTxs and read HypercoreFillTransaction events.
Returns fills attributed to a builder address bounded by a [startTime, endTime] window in milliseconds. Use this for builder revenue reports, monthly fee reconciliation, or rebuilding historical builder order-flow. Builder-keyed. GoldRush-native as there is no upstream Hyperliquid /info equivalent. Served from a dedicated HyperCore historical store, so windows can extend back to GoldRush’s full HyperCore coverage.

​
Endpoint

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

​
Request

​
type
string
required
Always "builderFillsByTime".
​
builder
string
required
The builder address that orders were routed through. Must be a 0x-prefixed 42-character hex address.
​
startTime
int
required
Unix timestamp in milliseconds. Inclusive lower bound. Required unless cursor is supplied.
​
endTime
int
Unix timestamp in milliseconds. Inclusive upper bound. Defaults to current server time when omitted.
​
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 and overrides startTime. 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": "builderFillsByTime",
    "builder": "0x0000000000000000000000000000000000000000",
    "startTime": 1781000000000
  }'

​
Response

An array of fill objects ordered by time. Each entry is a fill from an order that was routed through the builder address within the window. 
[
  {
    "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.

builderFills

fetch a builder’s most recent attributed trade fills for revenue attribution and order-flow analytics.

userFillsByTime

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

userFills

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

userTwapSliceFills

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