Info API Overview

The GoldRush Hyperliquid Info API is a drop-in replacement for POST https://api.hyperliquid.xyz/info. The request body, the response shape, and the JSON keys are byte-for-byte identical to the public Hyperliquid API. The only differences are the URL and the authentication header. Forty-nine wire-compatible type values are supported today across market metadata, user state, user history, vaults, and staking - plus four GoldRush-native types (two batched state lookups and two builder-keyed fill feeds) with no upstream equivalent.

Endpoint

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

The most-requested reads

Most Hyperliquid apps start from the same REST calls - a user’s trades and their account state. Over the drop-in /info API that is:

User trades (fills) - userFills for the latest fills, or userFillsByTime for a time window (GoldRush serves these past upstream’s ~10,000-fill retention limit).
Perp account state - clearinghouseState for a single wallet, or batchClearinghouseState for up to 50 wallets in one request.
Spot balances - spotClearinghouseState, or batchSpotClearinghouseState for many wallets at once.

Every type below is called the same way - POST /info with a type field - so these are the same requests you already make against api.hyperliquid.xyz, pointed at a faster, unthrottled host.

Comparison with the public Hyperliquid API

	Public API	GoldRush
URL	`https://api.hyperliquid.xyz/info`	`https://hypercore.goldrushdata.com/info`
Auth	None	`Authorization: Bearer <key>`
Rate limit	1200 weight/min/IP	None
Orderbook latency target	`p50`: `~280 ms`	`p50`: `<150 ms`
Wire compatibility	n/a (it’s the source)	Byte-for-byte
Available types	See Hyperliquid Docs	See Available types
Types not in public API	n/a	Batched user state, builder fills, liquidation feed, composites
Unsupported types	n/a	Return `{"error":"unsupported_type","type":"<x>"}` instead of being forwarded

Available types

The Info API supports the wire-compatible drop-in types below, organized by what they return. Four GoldRush-native types (batchClearinghouseState, batchSpotClearinghouseState, builderFills, builderFillsByTime) have no upstream Hyperliquid equivalent.

Market metadata

Type	Body	Returns
`metaAndAssetCtxs`	`{"type": "metaAndAssetCtxs", "dex": ""}`	Tuple `[meta, assetCtxs[]]` - perp universe + per-asset live mark price, funding, OI, day volume.
`meta`	`{"type": "meta", "dex": ""}`	Perp universe metadata only - size decimals, max leverage, margin tiers. No live context.
`spotMetaAndAssetCtxs`	`{"type": "spotMetaAndAssetCtxs"}`	Tuple `[spotMeta, assetCtxs[]]` - spot universe + per-pair live mark price, mid, day volume.
`spotMeta`	`{"type": "spotMeta"}`	Spot universe metadata only - pairs and the full token registry. No live context.
`outcomeMeta`	`{"type": "outcomeMeta"}`	Active HIP-4 outcome universe - integer outcome IDs, names, structured descriptions, and `sideSpecs` (`Yes` / `No`).
`settledOutcome`	`{"type": "settledOutcome", "outcome": 1}`	Resolution data for a settled HIP-4 outcome - the original `spec`, `settleFraction` paid to `Yes`, and `details` describing how the outcome resolved.
`l2Book`	`{"type": "l2Book", "coin": "BTC"}`	Aggregated Level-2 order book snapshot for one coin - bids and asks as `{px, sz, n}` levels.
`candleSnapshot`	`{"type": "candleSnapshot", "req": {"coin": "BTC", "interval": "1h", "startTime": …}}`	Historical OHLCV candles for a coin and interval over a time window.
`fundingHistory`	`{"type": "fundingHistory", "coin": "BTC", "startTime": …}`	Market-wide historical funding rates and premiums for a coin over a time window.
`perpDexs`	`{"type": "perpDexs"}`	List of HIP-3 builder-deployed perp DEXes (index `0` = canonical Hyperliquid; each entry has `name`, `full_name`, `deployer`, `oracle_updater`).
`allMids`	`{"type": "allMids", "dex": ""}`	Current mid price for every actively traded coin, as a `coin → price` map (spot pairs keyed `@index`).
`perpDexLimits`	`{"type": "perpDexLimits", "dex": "xyz"}`	Per-DEX open-interest, position-size, and transfer limits for a HIP-3 perp DEX.
`marginTable`	`{"type": "marginTable", "id": 56}`	Margin-tier (leverage-bracket) table for a `marginTableId`.
`maxMarketOrderNtls`	`{"type": "maxMarketOrderNtls"}`	Maximum market-order notional for each leverage bucket.
`perpsAtOpenInterestCap`	`{"type": "perpsAtOpenInterestCap"}`	List of perp coins currently at their open-interest cap.
`exchangeStatus`	`{"type": "exchangeStatus"}`	Current exchange operational status and server time.
`validatorL1Votes`	`{"type": "validatorL1Votes"}`	Pending validator L1 governance votes/actions.
`spotDeployState`	`{"type": "spotDeployState", "user": "0x…"}`	Spot-token deployment state and gas auction for a deployer.
`perpDeployAuctionStatus`	`{"type": "perpDeployAuctionStatus"}`	Current perp-deploy Dutch-auction status.
`liquidatable`	`{"type": "liquidatable"}`	Accounts currently eligible for liquidation.

User account state

Type	Body	Returns
`clearinghouseState`	`{"type": "clearinghouseState", "user": "0x…", "dex": ""}`	Perp account: positions, margin summary, account value, withdrawable.
`spotClearinghouseState`	`{"type": "spotClearinghouseState", "user": "0x…", "dex": ""}`	Spot balances per token, total USD value.
`frontendOpenOrders`	`{"type": "frontendOpenOrders", "user": "0x…", "dex": ""}`	Open orders + trigger metadata (TP/SL, `isPositionTpsl`, `reduceOnly`, `orderType`).
`activeAssetData`	`{"type": "activeAssetData", "user": "0x…", "coin": "ETH"}`	Per-user, per-asset trading state: leverage, directional max trade sizes, available-to-trade amounts, and mark price.
`subAccounts`	`{"type": "subAccounts", "user": "0x…"}`	List of sub-accounts owned by a master, each with its inlined perp and spot state.
`webData2`	`{"type": "webData2", "user": "0x…"}`	Composite frontend snapshot for a wallet - `clearinghouseState`, `openOrders`, perp `meta`/`assetCtxs`, `spotAssetCtxs`, TWAP and vault state in a single round-trip.
`openOrders`	`{"type": "openOrders", "user": "0x…", "dex": ""}`	A wallet’s resting open orders (coin, side, `limitPx`, `sz`, `oid`).
`userRole`	`{"type": "userRole", "user": "0x…"}`	Account role - `user`, `agent`, `vault`, or `subAccount` (with its master).
`userFees`	`{"type": "userFees", "user": "0x…"}`	Fee schedule and recent daily trading volume for a wallet.
`userRateLimit`	`{"type": "userRateLimit", "user": "0x…"}`	API rate-limit usage, cap, and cumulative volume.
`userAbstraction`	`{"type": "userAbstraction", "user": "0x…"}`	Account-abstraction mode (`"disabled"` or `"unifiedAccount"`).
`extraAgents`	`{"type": "extraAgents", "user": "0x…"}`	Approved API-agent wallets, each with `name` and `validUntil`.
`userToMultiSigSigners`	`{"type": "userToMultiSigSigners", "user": "0x…"}`	Authorized signers and threshold for a multi-sig account (`null` if not multi-sig).
`maxBuilderFee`	`{"type": "maxBuilderFee", "user": "0x…", "builder": "0x…"}`	Maximum builder fee (tenths of a bp) a user has approved for a builder.

User history

Type	Body	Returns
`userFills`	`{"type": "userFills", "user": "0x…"}`	Most recent fills for a wallet (up to 2,000).
`userFillsByTime`	`{"type": "userFillsByTime", "user": "0x…", "startTime": …}`	Fills bounded by a time window.
`userTwapSliceFills`	`{"type": "userTwapSliceFills", "user": "0x…"}`	Most recent TWAP slice fills, each tagged with the parent `twapId`.
`userTwapSliceFillsByTime`	`{"type": "userTwapSliceFillsByTime", "user": "0x…", "startTime": …}`	TWAP slice fills bounded by a time window. Served from GoldRush’s historical store so windows extend past upstream’s 10,000-fill retention.
`userFunding`	`{"type": "userFunding", "user": "0x…", "startTime": …}`	Funding payment history with rate, applied size, and USDC delta per event.
`userNonFundingLedgerUpdates`	`{"type": "userNonFundingLedgerUpdates", "user": "0x…", "startTime": …}`	Ledger events except funding - deposits, withdrawals, transfers, vault flows, liquidations.

Vaults & staking

Type	Body	Returns
`userVaultEquities`	`{"type": "userVaultEquities", "user": "0x…"}`	Per-vault locked equity with unlock timestamps.
`delegatorSummary`	`{"type": "delegatorSummary", "user": "0x…"}`	Current delegated, undelegated, and pending-withdrawal HYPE totals.
`delegatorHistory`	`{"type": "delegatorHistory", "user": "0x…"}`	Delegate, undelegate, deposit, and withdrawal staking events.
`delegatorRewards`	`{"type": "delegatorRewards", "user": "0x…"}`	Accrued staking rewards (delegation and validator commission).
`delegations`	`{"type": "delegations", "user": "0x…"}`	Active HYPE staking delegations, per validator.
`userBorrowLendInterest`	`{"type": "userBorrowLendInterest", "user": "0x…", "startTime": …}`	Borrow/lend interest accrual history over a time window.
`vaultSummaries`	`{"type": "vaultSummaries"}`	Summary information for every vault on the platform.
`vaultDetails`	`{"type": "vaultDetails", "vaultAddress": "0x…"}`	Full detail for one vault - leader, portfolio history, APR, followers.
`leadingVaults`	`{"type": "leadingVaults", "user": "0x…"}`	Vaults that a user leads.

Builder activity

Type	Body	Returns
`builderFills`	`{"type": "builderFills", "builder": "0x…"}`	Most recent fills attributed to a builder address (up to 2,000). GoldRush-native, no upstream equivalent.
`builderFillsByTime`	`{"type": "builderFillsByTime", "builder": "0x…", "startTime": …}`	Builder-attributed fills bounded by a time window. GoldRush-native, no upstream equivalent.

GoldRush-native batch

Type	Body	Returns
`batchClearinghouseState`	`{"type": "batchClearinghouseState", "users": ["0x…", …], "dex": ""}`	Array of `clearinghouseState` slots. GoldRush-native, 1 to 50 wallets per call.
`batchSpotClearinghouseState`	`{"type": "batchSpotClearinghouseState", "users": ["0x…", …]}`	Array of `spotClearinghouseState` slots. GoldRush-native, 1 to 50 wallets per call.

If you send a type that isn’t in the table above, the response body is {"error":"unsupported_type","type":"<the type you sent>"}. Requests are not forwarded to upstream Hyperliquid.

How clients see it

Existing Hyperliquid SDKs work unchanged after a baseUrl override. See SDK compatibility for nomeida/hyperliquid (JS) and hyperliquid-dex/hyperliquid-python-sdk setup snippets.

Errors

Status	Body	Cause
`400`	`{"error":"invalid request"}`	Malformed body.
`400`	`{"error":"unsupported_type","type":"<type>"}`	The `type` field isn’t one of the natively-supported types.
`401`	`{"error":"unauthorized"}`	Missing or invalid `Authorization` header.
`429`	n/a	Not returned. GoldRush has no per-IP rate limit on `/info` - any retry logic you carried over from `api.hyperliquid.xyz` can stay in place but won’t fire.
`5xx`	Server error	Internal server error.

Networks

Mainnet only. Testnet support is deferred.

Migration guide

Side-by-side examples - change one URL and one header.

SDK compatibility

Drop-in setup for nomeida/hyperliquid and hyperliquid-python-sdk.

Limits and caching

No rate limits - what to know about caching and recommended polling cadences.

API reference

Per-endpoint request and response schemas.

GoldRush for Hyperliquid

Info API

WebSocket API

Streaming Recipes

Endpoint

The most-requested reads

Comparison with the public Hyperliquid API

Available types

Market metadata

User account state

User history

Vaults & staking

Builder activity

GoldRush-native batch

How clients see it

Errors

Networks

Next

Migration guide

SDK compatibility

Limits and caching

API reference

​Endpoint

​The most-requested reads

​Comparison with the public Hyperliquid API

​Available types

​Market metadata

​User account state

​User history

​Vaults & staking

​Builder activity

​GoldRush-native batch

​How clients see it

​Errors

​Networks

​Next

Migration guide

SDK compatibility

Limits and caching

API reference

Endpoint

The most-requested reads

Comparison with the public Hyperliquid API

Available types

Market metadata

User account state

User history

Vaults & staking

Builder activity

GoldRush-native batch

How clients see it

Errors

Networks

Next