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

Credit Cost

TBD

Supported Chains

  • BASE_MAINNET
  • BSC_MAINNET
  • ETH_MAINNET
  • HYPEREVM_MAINNET
  • MEGAETH_MAINNET
  • MONAD_MAINNET
  • POLYGON_MAINNET
  • SOLANA_MAINNET
  • SONIC_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.

​
Parameters

​
chain_name
enum
required
Chain name to filter events (e.g. BASE_MAINNET, ETH_MAINNET, BSC_MAINNET, SOLANA_MAINNET)Available values: BASE_MAINNET, BSC_MAINNET, ETH_MAINNET, HYPERCORE_MAINNET, HYPEREVM_MAINNET, MEGAETH_MAINNET, MONAD_MAINNET, POLYGON_MAINNET, SOLANA_MAINNET
​
pair_addresses
array<string>
required
Array of pair addresses on supported DEXes and chains to track
​
interval
enum
required
Frequency of OHLCV data updates, ranging from sub-second to one dayAvailable values: ONE_SECOND, FIVE_SECONDS, FIFTEEN_SECONDS, ONE_MINUTE, FIVE_MINUTES, FIFTEEN_MINUTES, ONE_HOUR, FOUR_HOURS, ONE_DAY
​
timeframe
enum
required
Historical lookback period for OHLCV data, ranging from one minute to one monthAvailable values: ONE_MINUTE, FIVE_MINUTES, FIFTEEN_MINUTES, ONE_HOUR, FOUR_HOURS, ONE_DAY, FIVE_DAYS, SEVEN_DAYS, THIRTY_DAYS
​
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.

​
Basic Subscription Query

subscription {
  ohlcvCandlesForPair(
    chain_name: BASE_MAINNET
    pair_addresses: ["0x9c087Eb773291e50CF6c6a90ef0F4500e349B903"]
    interval: ONE_MINUTE
    timeframe: ONE_HOUR
  ) {
    chain_name
    pair_address
    interval
    timeframe
    timestamp
    open
    high
    low
    close
    volume
    volume_usd
    quote_rate
    quote_rate_usd
  }
}

​
Complete Subscription Query

subscription {
  ohlcvCandlesForPair(
    chain_name: BASE_MAINNET
    pair_addresses: [
      "0x9c087Eb773291e50CF6c6a90ef0F4500e349B903"
      "0x4b0Aaf3EBb163dd45F663b38b6d93f6093EBC2d3"
    ]
    interval: ONE_MINUTE
    timeframe: ONE_HOUR
    limit: 1000
  ) {
    chain_name
    pair_address
    interval
    timeframe
    timestamp
    open
    high
    low
    close
    volume
    volume_usd
    quote_rate
    quote_rate_usd
    base_token {
      contract_name
      contract_address
      contract_decimals
      contract_ticker_symbol
    }
    quote_token {
      contract_name
      contract_address
      contract_decimals
      contract_ticker_symbol
    }
  }
}

​
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

​
chain_name
string
The blockchain network where the pair exists
​
pair_address
string
The address of the DEX pair
​
interval
enum
The candle interval
​
timeframe
enum
The requested timeframe
​
timestamp
string
ISO timestamp for the candle
​
open
float
Opening price for the interval
​
high
float
Highest price during the interval
​
low
float
Lowest price during the interval
​
close
float
Closing price for the interval
​
volume
float
Trading volume during the interval
​
volume_usd
float
Trading volume in USD
​
quote_rate
float
Exchange rate between base and quote tokens
​
quote_rate_usd
float
USD value of the quote rate
​
base_token
object
Information about the base token in the pair
​
quote_token
object
Information about the quote token in the pair