History

Get token price history

Get historical prices (probabilities from 0.0 to 1.0) for a specific token.

Pagination limits:

  • Default limit: 100 points per page
  • Maximum limit: 200 points per page
  • Use cursor from metadata.next_cursor to fetch the next page

Aggregation: Prices are averaged when aggregating to higher resolutions.

Format: JSON only.

get/v1/tokens/{token_id}/prices

Request

  • Base URL: https://api.polymarketdata.co
  • URL: https://api.polymarketdata.co/v1/tokens/{token_id}/prices
  • Auth: API key in header X-API-Key

Path parameters

token_idstring required

Token ID.

Example:12345

Query parameters

start_tsstring required

Inclusive range start. Accepts ISO 8601 timestamp or Unix seconds.

Example:2025-09-01T00:00:00Z
end_tsstring required

Exclusive range end. Accepts ISO 8601 timestamp or Unix seconds.

Example:2025-09-05T00:00:00Z
resolution'1m' | '10m' | '1h' | '6h' | '1d' required

Supported time resolutions for historical endpoints.

Aggregation bucket size.

limitinteger

Maximum number of points to return in this page. Default: 100, max: 200.

Example:100
cursorstring nullable

Opaque cursor from a previous response metadata.next_cursor.

Response

Historical prices for a single token.

market_idstring required

Canonical market ID.

token_idstring required

Requested token ID.

token_labelstring required

Human-readable token label.

resolutionstring required

Applied resolution.

Example response

{
  "data": [
    {
      "p": 0.71,
      "t": "2025-09-05T10:00:00Z"
    },
    {
      "p": 0.73,
      "t": "2025-09-05T11:00:00Z"
    }
  ],
  "market_id": "618831",
  "metadata": {
    "count": 2,
    "limit": 100
  },
  "resolution": "1h",
  "token_id": "12345",
  "token_label": "Yes"
}

Changes

No recorded changes to this operation across all 1 revision of this API.