The OHLCV Tokens stream provides real-time updates on the Open, High, Low, Close prices and Volume of one or many tokens at configurable intervals. This documentation follows our standard streaming API structure.

Credit Cost

TBD

Supported Chains

  • BASE_MAINNET
  • BSC_MAINNET
  • ETH_MAINNET
  • SONIC_MAINNET

Supported DEXes

  • UNISWAP_V2
  • UNISWAP_V3
  • UNISWAP_V4
  • PANCAKESWAP_V2
  • SHADOW_V2
  • SHADOW_V3
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

ParameterTypeRequiredDescription
chain_nameenumYesChain name to filter events (e.g. BASE_MAINNET, ETH_MAINNET, BSC_MAINNET)
token_addressesarray<string>YesArray of token addresses on supported DEXes and chains to track
intervalenumYesFrequency of OHLCV data updates, ranging from sub-second to one day
timeframeenumYesHistorical lookback period for OHLCV data, ranging from one minute to one month
limitintNoMaximum number of items returned per stream message to control payload size

​
Subscription

You can subscribe to the ohlcvCandlesForToken endpoint to receive the pricing events.

​
Basic Subscription Query

subscription {
  ohlcvCandlesForToken(
    chain_name: BASE_MAINNET
    token_addresses: ["0x4B6104755AfB5Da4581B81C552DA3A25608c73B8"]
    interval: ONE_MINUTE
    timeframe: ONE_HOUR
  ) {
    chain_name
    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
    }
  }
}

​
Complete Subscription Query

subscription {
  ohlcvCandlesForToken(
    chain_name: BASE_MAINNET
    token_addresses: [
      "0x4B6104755AfB5Da4581B81C552DA3A25608c73B8"
    ]
    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": {
    "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

FieldTypeDescription
chain_namestringThe blockchain network where the token exists
pair_addressstringThe address of the primary DEX pool with the most liquidity for the token
intervalenumThe candle interval
timeframeenumThe requested timeframe
timestampstringISO timestamp for the candle
openfloatOpening price for the interval
highfloatHighest price during the interval
lowfloatLowest price during the interval
closefloatClosing price for the interval
volumefloatTrading volume during the interval
volume_usdfloatTrading volume in USD
quote_ratefloatExchange rate between base and quote tokens
quote_rate_usdfloatUSD value of the quote rate
base_tokenobjectInformation about the queried token
quote_tokenobjectInformation about the paired token of the primary DEX pool

​
GraphQL Playground