History

Get market token prices history

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

This endpoint always returns prices for all tokens in the market. Use /v1/tokens/{token_id}/prices for single-token queries.

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/markets/{id_or_slug}/prices

Request

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

Path parameters

id_or_slugstring required

Market ID or market slug.

Example:618831

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 all tokens in the market.

market_idstring required

Canonical market ID.

resolutionstring required

Applied resolution.

tokensobject required

Mapping of token label to token ID.

dataobject required

Time series points grouped by token label.

Example response

{
  "data": {
    "No": [
      {
        "p": 0.29,
        "t": "2025-09-05T10:00:00Z"
      },
      {
        "p": 0.27,
        "t": "2025-09-05T11:00:00Z"
      }
    ],
    "Yes": [
      {
        "p": 0.71,
        "t": "2025-09-05T10:00:00Z"
      },
      {
        "p": 0.73,
        "t": "2025-09-05T11:00:00Z"
      }
    ]
  },
  "market_id": "618831",
  "metadata": {
    "count": 4,
    "limit": 100
  },
  "resolution": "1h",
  "tokens": {
    "No": "12346",
    "Yes": "12345"
  }
}

Changes

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