Hyperliquid API Overview

GoldRush is the complete, low-latency data layer for Hyperliquid - the indexer and data provider that aggregates everything you need to build on Hyperliquid - HyperCore, HIP-3, HIP-4, and HyperEVM - under one API key.

​

Drop-in coverage: REST + WebSocket

GoldRush replaces both of Hyperliquid’s public surfaces with a single host - hypercore.goldrushdata.com. Same request bodies, same response shapes, same subscription payloads as the public API. Swap the URL, add the GoldRush API key, and your existing clients work unchanged - with no rate limits and no per-IP subscription caps.

​

Hyperliquid API limitations addressed by GoldRush

The public Hyperliquid /info API is generous, but it has hard limits that most production apps run into:

• 1200 weight/min/IP rate limits per address.
• 1000 WebSocket subscriptions per IP - not enough to track every active trader.
• WebSocket subscription filters are required - every subscription must specify an asset (e.g. coin on l2Book), forcing per-asset fan-out that burns through the 1000-subscription cap. GoldRush makes these filters optional so a single wildcard subscription streams every asset.
• No batch address endpoints - account-state calls are single-wallet only; GoldRush adds batchClearinghouseState and batchSpotClearinghouseState for up to 50 wallets per request.
• userFills capped at ~10,000 rows - active traders blow through that in weeks.
• Liquidations buried inside fills as a thin stub; vault, staking, and delegation data arrives untyped.
• HIP-3 and HIP-4 discovery is manual - candleSnapshot is poll-based and effectively limited to mainstream markets.
• No HyperEVM concept at all - DEXes, NFT mints, and lending live on chain 999 and the /info API doesn’t see them.

GoldRush closes every one of these gaps. See GoldRush vs Hyperliquid public API for the full breakdown.

​

What’s included

​

Infrastructure

GoldRush runs its own Hyperliquid indexing infrastructure - purpose-built to be the fastest, most reliable Hyperliquid data provider for production apps and quant desks:

• Dedicated Hyperliquid nodes in Tokyo - co-located with Hyperliquid’s validator infrastructure for low-latency reads.
• Private backbone for high-throughput data ingestion.
• No rate limits - bypass the public /info and WebSocket constraints entirely.
• Full historical backfill - every fill, funding payment, and ledger event back to HyperCore . HyperEVM coverage goes back to genesis.

​

Quickstart

Here are three “first 5 minutes” quickstarts. Pick whichever maps to what you are building.

​

All Hyperliquid endpoints

Every Hyperliquid endpoint reference page, grouped by surface. The Info API and WebSocket API overviews cover each type in context; the full index below links straight to every endpoint’s request/response schema.

​

Info endpoints

• metaAndAssetCtxs — fetch the full Hyperliquid perpetuals market universe with live per-asset trading context.
• meta — fetch the perpetuals universe metadata without live market context.
• perpDexs — enumerate every HIP-3 builder-deployed perpetual DEX on HyperCore.
• spotMetaAndAssetCtxs — fetch the spot universe metadata, token configuration, and live market data in a single call.
• spotMeta — fetch the spot universe metadata and full token configuration without live market context.
• outcomeMeta — enumerate all active HIP-4 binary outcome markets on HyperCore.
• settledOutcome — retrieve resolution details for a settled HIP-4 binary outcome market on HyperCore.
• l2Book — fetch an aggregated Level-2 order book snapshot for a single coin - bids and asks as price, size,…
• l2BookDiffSnapshot — fetch a full-depth L2 order book snapshot for one coin, with height, epoch, and seq to bootstrap…
• candleSnapshot — fetch historical OHLCV candles for a coin and interval over a time window for charting and…
• fundingHistory — fetch a coin’s historical funding rates and premiums over a time window for funding analytics and…
• clearinghouseState — fetch a single user’s perpetuals account state by wallet address.
• spotClearinghouseState — fetch a single user’s spot account balances by wallet address.
• frontendOpenOrders — fetch a user’s currently open orders enriched with frontend metadata.
• activeAssetData — fetch a user’s active trading limits, leverage setting, available size, and mark price for a…
• 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.
• userTwapSliceFillsByTime — fetch a user’s TWAP slice fills within a time window for execution-quality reconciliation on…
• userFunding — fetch a user’s per-coin funding payment history within a time window for funding-only P&L…
• userNonFundingLedgerUpdates — fetch a user’s non-funding USDC ledger history (deposits, withdrawals, transfers, vault flows)…
• subAccounts — fetch a master wallet’s sub-accounts along with their full perp and spot state in a single call.
• webData2 — fetch the composite snapshot the Hyperliquid web app uses for a wallet in a single call.
• userVaultEquities — fetch a user’s locked vault equity positions across all vaults they have deposited into.
• delegatorSummary — get a one-shot snapshot of a user’s HYPE staking position for dashboards and portfolio overviews.
• delegatorHistory — reconstruct the sequence of HYPE staking events behind the totals shown in delegatorSummary.
• delegatorRewards — fetch a user’s current HYPE staking position.
• builderFills — fetch a builder’s most recent attributed trade fills for revenue attribution and order-flow…
• builderFillsByTime — fetch a builder’s attributed trade fills within a time window for revenue attribution and fee…
• allMids — fetch the current mid price for every actively traded asset in a single call.
• perpDexLimits — fetch the open-interest, position-size, and transfer limits for a HIP-3 perp DEX.
• marginTable — fetch the margin-tier (leverage-bracket) table for a given margin table id.
• maxMarketOrderNtls — fetch the maximum market-order notional for each leverage bucket.
• perpsAtOpenInterestCap — list the perp assets currently at their open-interest cap.
• openOrders — list a user’s resting open orders by wallet address.
• historicalOrders — fetch a user’s recent orders - both open and finalized - each with its current status and status…
• orderStatus — look up the status of a single order for a user by order id (oid) or client order id (cloid).
• userRole — fetch a user’s account role.
• userFees — fetch a user’s fee schedule and recent daily trading volume.
• userRateLimit — fetch a user’s API rate-limit usage and cap.
• userAbstraction — fetch a user’s account-abstraction mode.
• extraAgents — list a user’s approved API-agent wallets.
• userToMultiSigSigners — fetch the authorized signers for a multi-sig user.
• maxBuilderFee — fetch the maximum builder fee a user has approved for a given builder.
• delegations — list a user’s active HYPE staking delegations.
• userBorrowLendInterest — fetch a user’s borrow/lend interest accrual history.
• vaultSummaries — list summary information for every vault on the platform.
• vaultDetails — fetch detailed information for a specific vault.
• leadingVaults — list the vaults a user leads.
• spotDeployState — fetch the spot-token deployment state and gas auction for a deployer.
• perpDeployAuctionStatus — fetch the current perp-deploy Dutch-auction status.
• exchangeStatus — fetch the current exchange operational status.
• validatorL1Votes — fetch the pending validator L1 governance votes/actions.
• liquidatable — list accounts currently eligible for liquidation.
• allPerpMetas — perpetuals universe and margin tables for every perp DEX in one request.
• portfolioState — fetch a wallet’s perp state, spot balances, and account-abstraction mode in one request.
• batchClearinghouseState — fetch perpetuals account state for up to 50 wallets in a single request.
• batchSpotClearinghouseState — fetch spot account balances for up to 50 wallets in a single request.

​

WebSocket endpoints

• l2Book — subscribe to real-time L2 order book snapshots for all Hyperliquid assets over WebSocket.
• l2BookDiff — subscribe to real-time L2 order book (initial snapshot + diffs) for all Hyperliquid assets over…
• l2BookDiff2 — subscribe to a diff-only L2 order book stream with per-coin sequence numbers and a server epoch…
• l4Book — subscribe to GoldRush’s order-level Hyperliquid book - initial snapshot of every resting order…
• userFills — stream real-time trade fills for one or more wallets as they execute on HyperCore.
• orderUpdates — stream real-time order lifecycle events (placements, fills, cancels, and rejections) for one or…
• liquidationFills — stream a global, market-wide feed of every liquidation fill on HyperCore.
• allFills — stream every fill on HyperCore in real time for global market analytics and cross-wallet…
• builderFills — stream live attributed fills for one or more builder addresses in real time.
• builderLiquidations — stream liquidation fills attributed to your builder code in real time.
• userNonFundingLedgerUpdates — stream real-time non-funding ledger events (deposits, withdrawals, vault and staking activity) for…