---
title: "Get token price history"
method: GET
path: "/api/v2/chain/{chain}/token/{address}/price_history"
tags: ["Token Endpoints"]
---

# Get token price history

`GET /api/v2/chain/{chain}/token/{address}/price_history`

## Request

- Base URL: `https://api.opensea.io`
- URL: `https://api.opensea.io/api/v2/chain/{chain}/token/{address}/price_history`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/chain/:chain/token/:address/price_history/get.ts> (a function with typed inputs; its response is checked against the schema)

Get historical price data for a specific token.

## 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')
- `address` string, required

## Query parameters

- `start_time` string, date-time, required
- `end_time` string, date-time
- `bucket_size` string

## Response `200`

OK

- PriceHistoryResponse: List of price history data points
  - `prices` PriceHistoryPointResponse[], required: List of price history points
    - `time` number, double, required: Timestamp of the price point
    - `usd_price` string, required: Price in USD

## Other responses

- `400`: For error reasons, review the response data.
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal server error. Please open a support ticket so OpenSea can investigate.

## Changes

- **2026-11-03** `2c7935d84f90`: 2 breaking, 6 info
  - removed the enum value `b3` from the `path` request parameter `chain`
  - removed the enum value `blast` from the `path` request parameter `chain`
  - added the new enum value `stablechain` to the `path` request parameter `chain`
  - added the media type `*/*` for the response with the status `400`
  - …4 more

[Operation history](https://skmtc.dev/opensea/apis/opensea-api/changes/api/v2/chain/:chain/token/:address/price_history/get.md)

---

[API](https://skmtc.dev/opensea/apis/opensea-api.md) - [All operations](https://skmtc.dev/opensea/apis/opensea-api/llms.txt) - [OpenAPI document](https://skmtc.dev/opensea/apis/opensea-api/revisions/2c7935d84f90?raw)