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
  • 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.

​
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

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