Credit Cost
1 per minute
Processing
Realtime
- GoldRush-native: No
wss://api.hyperliquid.xyz/wsequivalent. - Pass
builder(string) for a single builder oraddresses(string[]) for many.aggregateByTimeoptional. - Live-only: No historical snapshot on subscribe. For windowed history, use the Info API
builderFillsByTime. - Same per-fill shape as
userFills, plusbuilderandbuilderFeeon every entry; channel name in messages isbuilderFills.
builder) or many (addresses) and receive every fill routed through those builders as they execute, batched per block as [address, fill] tuples. Each fill carries the matched builder address and the corresponding builderFee.
Endpoint
Your GoldRush API key. Passed as a query parameter at connection time - no
Authorization header is used.Subscribe
Send this JSON message after the connection is established. Provide eitherbuilder (single address) or addresses (array of addresses).
Example
Unsubscribe
Send the samesubscription body with method: "unsubscribe":
Unsubscribe matches subscriptions by exact body. A subscription created with
builder: "0xAAA" is a different subscription from one created with addresses: ["0xAAA"], even if they target the same builder. To narrow a multi-builder set, unsubscribe the original list in full, then resubscribe with the smaller list.Streamed message
Each push haschannel: "builderFills" and a fills array of [address, fill] tuples. The first element of each tuple is the trader who executed the fill; the fill object carries the trade details, including the builder it was routed through and the builderFee earned.
Tuples of
[address, fill]. The address is the trader who placed the order; the fill object carries the trade details plus builder-attribution fields.Errors
A missing or malformedbuilder/addresses field returns an error message on the same channel:
Related endpoints
builderLiquidations
subscribe to real-time liquidation fills of your users.
allFills
stream every fill on HyperCore in real time for global market analytics and cross-wallet order-flow monitoring.
liquidationFills
stream a global, market-wide feed of every liquidation fill on HyperCore.
userFills
stream real-time trade fills for one or more wallets as they execute on HyperCore.
/info and /ws APIs at hypercore.goldrushdata.com, with no rate limits and every fill, order, trade, funding and ledger event retained from the start of HyperCore coverage.
Last reviewed: 2026-06-19