Streaming API Overview

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.

​

Connection Details

​

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 HyperCore fills, liquidations, funding rates, and vault actions in real-time. Includes data not available via the public Hyperliquid API.

​

Available Streams

​

Subscriptions

• OHLCV Tokens Stream: 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.The token_addresses input is limited to a maximum of 5 addresses per subscription.
• OHLCV Pairs Stream: 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.The pair_addresses input is limited to a maximum of 5 addresses per subscription.
• New DEX Pairs Stream: The New DEX Pairs stream provides real-time updates when new liquidity pairs are created on decentralized exchanges (DEXes).
• Update Pairs Stream: The Update Pairs stream provides real-time updates on the prices, volumes, market cap and liquidity of one or many token pairs.The pair_addresses input is limited to a maximum of 5 addresses per subscription.
• Wallet Activity Stream: The Wallet Activity stream provides real-time updates on wallet transactions, token transfers, and interactions with smart contracts.The wallet_addresses input is limited to a maximum of 1000 addresses per subscription on HyperCore, and a maximum of 100 addresses per subscription on EVM chains and Solana.
• Update Tokens Stream: 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.The token_addresses input is limited to a maximum of 5 addresses per subscription.

​

Queries

• Token Search Query: 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: This GraphQL query returns the top 20 trader wallets — ranked by trading volume over the last 30 days — for a specific token, along with detailed information about their holdings, transaction activity, and realized and unrealized profit/loss metrics.
• Wallet PnL by Token Query: 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.
• OHLCV Tokens Query: The OHLCV Tokens query returns historical Open, High, Low, Close prices and Volume for one or many tokens at configurable intervals as a one-shot response. Use this when you need a historical fetch rather than a live stream — the request and response shapes are identical to the OHLCV Tokens Stream subscription. The token_addresses input is limited to a maximum of 5 addresses per query.
• OHLCV Pairs Query: The OHLCV Pairs query returns historical Open, High, Low, Close prices and Volume for one or many token pairs at configurable intervals as a one-shot response. Use this when you need a historical fetch rather than a live stream — the request and response shapes are identical to the OHLCV Pairs Stream subscription. The pair_addresses input is limited to a maximum of 5 addresses per query.

​

Price Feed Sources

1. DEX swap events — prices are derived from onchain trades in specific pools across the supported DEXes. Prices update with each swap event.
2. 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.

​

Access via GoldRush CLI