OPopensea
Token Endpoints

Get token price history

Changed on

Get historical price data for a specific token.

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

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 price history window (ISO 8601)

end_timestring date-time

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

bucket_sizestring

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

Response

OK

Example response

{
  "prices": [
    {
      "usd_price": "1.0"
    }
  ]
}

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