History

Get market metrics history

Get historical market-level metrics including volume, liquidity, and spread.

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: All metrics are averaged when aggregating to higher resolutions.

Format: JSON only.

get/v1/markets/{id_or_slug}/metrics

Request

  • Base URL: https://api.polymarketdata.co
  • URL: https://api.polymarketdata.co/v1/markets/{id_or_slug}/metrics
  • 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 market-level metrics in the requested resolution.

market_idstring required

Canonical market ID.

resolutionstring required

Applied resolution.

Example response

{
  "data": [
    {
      "liquidity": 45678,
      "spread": 0.015,
      "t": "2025-09-05T10:00:00Z",
      "volume": 1200.5
    },
    {
      "liquidity": 47010,
      "spread": 0.012,
      "t": "2025-09-05T11:00:00Z",
      "volume": 980
    }
  ],
  "market_id": "618831",
  "metadata": {
    "count": 2,
    "limit": 100
  },
  "resolution": "1h"
}

Changes

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