Skip to main content

Documentation Index

Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

Drop-in Hyperliquid API replacement

Same /info request body. Change one URL and one header to remove rate limits and unlock more data. Hosted at hypercore.goldrushdata.com.

Real-time Streaming

Wallet firehose, OHLCV for every HIP-3 and HIP-4 market the moment it goes live, and pre-decoded liquidations and vault events.

Pipeline to your warehouse

Land hl_fills, hl_trades, hl_orders, hl_funding, and more directly in ClickHouse, BigQuery, Postgres, Kafka, or S3.

HyperEVM coverage

Token balances, transfers, approvals, NFTs, and gas for HyperEVM - same shape as every other EVM chain on GoldRush.

​
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.
  • 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

SurfaceWhat you getWhere to start
Hyperliquid Info APIDrop-in replacement for POST https://api.hyperliquid.xyz/info with POST https://hypercore.goldrushdata.com/info. Same request body, no rate limits, faster orderbook reads, batched user state, builder-attribution data.Info API Overview
Streaming APIReal-time walletTxs, ohlcvCandlesForPair, ohlcvCandlesForToken over GraphQL/WebSocket. Pre-decoded HyperCore events.Wallet firehose, HIP-3 markets, HIP-4 outcomes
Pipeline APIPush hl_fills, hl_trades, hl_orders, hl_funding, hl_misc_events into your warehouse continuously.HyperCore normalizers, Stream Hyperliquid trades to ClickHouse
Foundational APIHyperEVM token balances, transfers, approvals, NFTs, gas, blocks.HyperEVM chain page
Live analyticsHIP-3 Market Screener, Liquidation Cascade Map, Market Health Score at hyperliquid.goldrush.dev.Live tools

​
Infrastructure

  • 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 block 676,607,001 (2025-07-27T01:49:59Z). HyperEVM coverage goes back to genesis.

​
Quickstart

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

Upgrade from the public Hyperliquid API

Already using api.hyperliquid.xyz/info? Change the URL and add one header.

Watch wallets

Subscribe to thousands of HyperCore wallets in one connection.

Pipe orderbook fills into your warehouse

Stream hl_fills into ClickHouse, BigQuery, or Postgres.