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. This documentation follows our standard streaming API structure. The pair_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
• ROBINHOOD_MAINNET
• SOLANA_MAINNET

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

Parameters

chain_name · enum · required

Blockchain network to filter events

Type: 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 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 ohlcvCandlesForPair endpoint to receive the pricing events.

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