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.

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. This documentation follows our standard streaming API structure. The token_addresses input is limited to a maximum of 5 addresses per subscription.

Credit Cost

1 per minute

Supported Chains

  • BASE_MAINNET
  • BSC_MAINNET
  • ETH_MAINNET
  • HYPERCORE_MAINNET
  • HYPEREVM_MAINNET
  • MEGAETH_MAINNET
  • MONAD_MAINNET
  • POLYGON_MAINNET
  • SOLANA_MAINNET

​
Supported Token Price Feeds

In addition to DEX-sourced prices, this stream supports institutional-grade price feeds from the following providers:
ProviderDescription
Redstone BoltUltra-low-latency CEX price feeds updated every 2.4 ms (~400 updates/sec). Bolt nodes are co-located with chain sequencer infrastructure and aggregate prices from Binance, Coinbase, OKX, Bitget, and Kraken.
Pass the feed name in the token_addresses array with chain_name set to the feed’s chain name.
Feed NameAssetChain Name
REDSTONE-BTCBitcoinMEGAETH_MAINNET
REDSTONE-ETHEthereumMEGAETH_MAINNET
REDSTONE-SOLSolanaMEGAETH_MAINNET
REDSTONE-BNBBNBMEGAETH_MAINNET
REDSTONE-XRPXRPMEGAETH_MAINNET
REDSTONE-ADACardanoMEGAETH_MAINNET
REDSTONE-DOGEDogecoinMEGAETH_MAINNET
REDSTONE-USDTTetherMEGAETH_MAINNET
REDSTONE-USDCUSD CoinMEGAETH_MAINNET

​
Parameters

​
chain_name
enum
required
Blockchain network to filter eventsType: ChainName
​
token_addresses
array<string>
required
Array of token addresses on supported DEXes and chains to track
​
interval
enum
required
Time interval between each OHLCV candleType: OhlcvTimeInterval
​
timeframe
enum
required
How far back to fetch historical OHLCV dataType: OhlcvTimeFrame
​
limit
int
Maximum number of items returned per stream message to control payload size

​
Subscription

You can subscribe to the ohlcvCandlesForToken endpoint to receive the pricing events. 
subscription {
  ohlcvCandlesForToken(
    chain_name: BASE_MAINNET
    token_addresses: ["0x4B6104755AfB5Da4581B81C552DA3A25608c73B8"]
    interval: ONE_MINUTE
    timeframe: ONE_HOUR
    limit: 1000
  ) {
    pair_address
    base_token {
      contract_name
      contract_address
      contract_decimals
      contract_ticker_symbol
    }
    volume
    timeframe
    high
    quote_rate
    low
    quote_rate_usd
    quote_token {
      contract_name
      contract_address
      contract_decimals
      contract_ticker_symbol
    }
    interval
    id
    volume_usd
    close
    chain_name
    open
    timestamp
  }
}

​
Response Format

Here’s an example of the response data structure: 
{
  "data": {
    "ohlcvCandlesForToken": [
      {
        "chain_name": "BASE_MAINNET",
        "interval": "ONE_MINUTE",
        "timeframe": "ONE_HOUR",
        "timestamp": "2025-06-27T22:24:00Z",
        "open": 0.000604418526534047,
        "high": 0.000604638206820701,
        "low": 0.000604013151624892,
        "close": 0.000604638206820701,
        "volume": 1.4980526133065126,
        "volume_usd": 6004669.256018968,
        "quote_rate": 0.000604638206820701,
        "quote_rate_usd": 4007551.6142841205,
        "base_token": {
          "contract_name": "Virtual Protocol",
          "contract_address": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
          "contract_decimals": 18,
          "contract_ticker_symbol": "VIRTUAL"
        }
      }
    ]
  }
}

​
Field Descriptions

​
pair_address
string
The address of the primary DEX pool with the most liquidity for the token
​
base_token
object
Information about the queried tokenType: TokenContractMetadata
​
volume
float
Trading volume during the interval
​
timeframe
enum
The requested timeframeType: OhlcvTimeFrame
​
high
float
Highest price during the interval
​
quote_rate
float
Exchange rate between base and quote tokens
​
low
float
Lowest price during the interval
​
quote_rate_usd
float
USD value of the quote rate
​
quote_token
object
Information about the paired token of the primary DEX poolType: TokenContractMetadata
​
interval
enum
The candle intervalType: OhlcvTimeInterval
​
id
string
Unique identifier for this candle
​
volume_usd
float
Trading volume in USD
​
close
float
Closing price for the interval
​
chain_name
enum
The blockchain network where the token existsType: ChainName
​
open
float
Opening price for the interval
​
timestamp
string
Candle timestamp (ISO-8601)