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. This documentation follows our standard streaming API structure.

Credit Cost

TBD

Supported Chains

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

This stream is currently in Beta. It is stable for testing and evaluation but may undergo changes in schema or behavior as we continue to improve it. No API credits are currently charged.

We welcome your feedback so please reach out to us directly to report issues or request features.

Supported Token Price Feeds

In addition to DEX-sourced prices, this stream supports institutional-grade price feeds from the following providers:

Provider	Description
Redstone Bolt	Ultra-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 Name	Asset	Chain Name
REDSTONE-BTC	Bitcoin	MEGAETH_MAINNET
REDSTONE-ETH	Ethereum	MEGAETH_MAINNET
REDSTONE-SOL	Solana	MEGAETH_MAINNET
REDSTONE-BNB	BNB	MEGAETH_MAINNET
REDSTONE-XRP	XRP	MEGAETH_MAINNET
REDSTONE-ADA	Cardano	MEGAETH_MAINNET
REDSTONE-DOGE	Dogecoin	MEGAETH_MAINNET
REDSTONE-USDT	Tether	MEGAETH_MAINNET
REDSTONE-USDC	USD Coin	MEGAETH_MAINNET

Parameters

chain_name · enum · required

Blockchain network to filter events

Type: 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 candle

Type: OhlcvTimeInterval

timeframe · enum · required

How far back to fetch historical OHLCV data

Type: 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 token

Type: TokenContractMetadata

Show properties

contract_name · string

Name of the token contract

contract_address · string

Address of the token contract

contract_decimals · int

Number of decimal places for the token

contract_ticker_symbol · string

Ticker symbol of the token

volume · float

Trading volume during the interval

timeframe · enum

The requested timeframe

Type: 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 pool

Type: TokenContractMetadata

Show properties

contract_name · string

Name of the token contract

contract_address · string

Address of the token contract

contract_decimals · int

Number of decimal places for the token

contract_ticker_symbol · string

Ticker symbol of the token

interval · enum

The candle interval

Type: 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 exists

Type: ChainName

open · float

Opening price for the interval

timestamp · string

Candle timestamp (ISO-8601)