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.

Credit Cost

1 per call

Supported Chains

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

Estimate your monthly cost for this API using the Pricing Calculator.

Supported Token Price Feeds

In addition to DEX-sourced prices, this query 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

Query

You can query the ohlcvCandlesForToken endpoint to fetch a historical batch of OHLCV candles in a single response.

query {
  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)