Connection Details
The Streaming API uses the GraphQL over WebSocket protocol. The recommended approach is to use the official TypeScript Client SDK which manages all WebSocket connections automatically.
Use Cases
Trading Bots
Power your bots with new pairs, pair liquidity changes, OHLCV pricing data,
and wallet activity to copy trade.
Gaming
Stream inventory balances and onchain game state right into your game engine
with no lag or polling.
AI Agents
Power your AI Agents with streaming wallet information to build novel
co-pilot apps.
Perps & Derivatives
Stream Hyperliquid fills, liquidations, funding rates, and vault actions in
real-time. Includes data not available via the public Hyperliquid API.
Available Streams
The GoldRush Streaming API offers the following streams:Subscriptions
- OHLCV Tokens Stream: Beta The OHLCV Tokens stream provides real-time updates on the Open, High, Low, Close prices and Volume of one or many tokens at configurable intervals.
- OHLCV Pairs Stream: Beta The OHLCV Pairs stream provides real-time updates on the Open, High, Low, Close prices and Volume of one or many token pairs at configurable intervals.
- New DEX Pairs Stream: Beta The New DEX Pairs stream provides real-time updates when new liquidity pairs are created on decentralized exchanges (DEXes).
- Update Pairs Stream: Beta The Update Pairs stream provides real-time updates on the prices, volumes, market cap and liquidity of one or many token pairs.
- Wallet Activity Stream: Beta The Wallet Activity stream provides real-time updates on wallet transactions, token transfers, and interactions with smart contracts.
- Update Tokens Stream: Beta The Update Tokens stream provides real-time updates on the prices, volumes, market cap and liquidity of one or many tokens by tracking the highest-volume pool for each token.
Queries
- Token Search Query: Beta This GraphQL query lets you discover actively traded tokens that match a keyword or ticker symbol. Each result includes pricing, volume marketcap, and base/quote metadata. Use it to build comprehensive token search features.
- Top Trader Wallets for Token Query: Beta This GraphQL query provides a list of wallets with the highest trading volume for a specific token over the last 30 days, along with detailed information about their holdings, transaction activity, realized and unrealized profit/loss metrics.
- Wallet PnL by Token Query: Beta This GraphQL query provides detailed financial metrics, including unrealized and realized profit and loss (PnL), current balance, and transaction insights for each token held by a specific wallet address.
Price Feed Sources
Price feeds used in the GoldRush Streaming API are sourced in the following ways:- DEX swap events — prices are derived from onchain trades in specific pools across the supported DEXes. Prices update with each swap event.
- Onchain oracle price feeds — on select chains and for specific tokens, prices are pushed onchain by oracle providers (e.g. Redstone Bolt on MegaETH), delivering CEX-aggregated prices at much higher update frequencies.