OPopensea
Token Endpoints

Get token OHLCV candles

Changed on

Get OHLCV (Open, High, Low, Close, Volume) candlestick data for a specific token.

get/api/v2/chain/{chain}/token/{address}/ohlcv

Request

Path parameters

chain'base' | 'ethereum' | 'zora' | 'arbitrum' | 'sei' | 'avalanche' | 'polygon' | 'optimism' | 'ape_chain' | 'flow' | 'soneium' | 'ronin' | 'bera_chain' | 'solana' | 'shape' | 'unichain' | 'gunzilla' | 'abstract' | 'animechain' | 'hyperevm' | 'somnia' | 'monad' | 'hyperliquid' | 'megaeth' | 'ink' | 'robinhood' | 'stablechain' required

Blockchain chain identifier. Use the chain slug (e.g., 'ethereum', 'polygon', 'arbitrum', 'optimism', 'base')

Example:ethereum

The blockchain on which to filter the results

addressstring required

The contract address of the token

Query parameters

start_timestring date-time required

Start time for the OHLCV window (ISO 8601)

end_timestring date-time

End time for the OHLCV window (ISO 8601, defaults to now)

bucket_sizestring required

Candle bucket size (1s, 1m, 5m, 15m, 1h, 4h, 1d)

fill_time_windowboolean

Whether to fill empty time windows with zero-volume candles

Response

OK

Changes

  • 2c7935d84f90Revision changes
    • breaking

      removed the enum value b3 from the path request parameter chain

    • breaking

      removed the enum value blast from the path request parameter chain

    • info

      added the new enum value stablechain to the path request parameter chain

    • info

      added the media type */* for the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status