Skip to main content
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.

Credit Cost

1 per call

Supported Chains

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

​
Parameters

​
chain_name
enum
required
Blockchain network to filter eventsType: ChainName
​
pair_addresses
array<string>
required
Array of pair 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

​
Query

You can query the ohlcvCandlesForPair endpoint to fetch a historical batch of OHLCV candles in a single response. 
query {
  ohlcvCandlesForPair(
    chain_name: BASE_MAINNET
    pair_addresses: [
      "0x9c087Eb773291e50CF6c6a90ef0F4500e349B903"
      "0x4b0Aaf3EBb163dd45F663b38b6d93f6093EBC2d3"
    ]
    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": {
    "ohlcvCandlesForPair": [
      {
        "chain_name": "BASE_MAINNET",
        "pair_address": "0x4b0Aaf3EBb163dd45F663b38b6d93f6093EBC2d3",
        "interval": "ONE_MINUTE",
        "timeframe": "ONE_HOUR",
        "timestamp": "2025-05-29T19:53:00Z",
        "open": 4113151.389790023,
        "high": 4196665.022060752,
        "low": 4113151.389790023,
        "close": 4196665.022060752,
        "volume": 325.7615900713698,
        "volume_usd": 0.2079461510855417,
        "quote_rate": 4196665.022060752,
        "quote_rate_usd": 0.0006319231563715365,
        "quote_token": {
          "contract_name": "Wrapped Ether",
          "contract_symbol": "WETH",
          "contract_address": "0x4200000000000000000000000000000000000006",
          "contract_decimals": 18
        },
        "base_token": {
          "contract_name": "Toshi",
          "contract_symbol": "TOSHI",
          "contract_address": "0xac1bd2486aaf3b5c0fc3fd868558b082a531b2b4",
          "contract_decimals": 18
        }
      }
    ]
  }
}

​
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)