List Markets

List all markets with filtering and pagination

GET /v1/markets

List Markets

cURL

curl --request GET \
  --url https://api.polyhistorical.com/v1/markets \
  --header 'X-API-Key: <x-api-key>'

200

{
  "markets": [
    {}
  ],
  "total": 123,
  "limit": 123,
  "offset": 123,
  "warning": "<string>",
  "slug": "<string>",
  "market_id": "<string>",
  "event_id": "<string>",
  "market_type": "<string>",
  "start_time": "<string>",
  "end_time": "<string>",
  "coin_price_start": 123,
  "coin_price_end": 123,
  "condition_id": "<string>",
  "clob_token_up": "<string>",
  "clob_token_down": "<string>",
  "winner": "<string>",
  "final_volume": 123,
  "final_liquidity": 123,
  "resolved_at": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>"
}

List Markets

Returns markets sorted by start_time descending (newest first).

Request

https://api.polyhistorical.com/v1/markets

Headers

X-API-Key · string · required

Your API key. See Authentication.

Query parameters

coin · string · required

Cryptocurrency to query. Supported: BTC, ETH, SOL

limit · integer · default: "100"

Number of results to return (1-100)

offset · integer · default: "0"

Pagination offset

market_type · string

Filter by market type: 5m, 15m, 1hr (all coins), 4hr, 24hr (BTC only)

resolved · boolean

Filter by resolution status. false for active markets, true for resolved.

start_time · string

Filter markets starting after this time. Accepts epoch milliseconds or ISO 8601.

end_time · string

Filter markets starting before this time. Accepts epoch milliseconds or ISO 8601.

Response

markets · array

Array of market objects

total · integer

Total number of markets matching the filter

limit · integer

Number of results returned

offset · integer

Current pagination offset

warning · string

Warning message if applicable (null otherwise)

Market object fields

slug · string

Market slug identifier

market_id · string

External market ID

event_id · string

External event ID

market_type · string

Market interval — 5m, 15m, 1hr (all coins), 4hr, 24hr (BTC only)

start_time · string

Market start time (ISO 8601)

end_time · string

Market end time (ISO 8601)

coin_price_start · number

Coin price at market start (null if not yet recorded)

coin_price_end · number

Coin price at market end (null if unresolved)

condition_id · string

Polymarket condition ID

clob_token_up · string

CLOB token ID for the “Up” outcome

clob_token_down · string

CLOB token ID for the “Down” outcome

winner · string

Winning outcome (null if unresolved)

final_volume · number

Final trading volume (null if unresolved)

final_liquidity · number

Final liquidity (null if unresolved)

resolved_at · string

Resolution timestamp (null if unresolved)

created_at · string

Record creation timestamp

updated_at · string

Record last updated timestamp

Examples

Get active 5-minute BTC markets

cURL

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.polyhistorical.com/v1/markets?coin=BTC&market_type=5m&resolved=false&limit=10"

Response

{
  "markets": [
    {
      "slug": "btc-updown-5m-1774975800",
      "winner": "Down",
      "market_id": "1793728",
      "event_id": "325933",
      "market_type": "5m",
      "start_time": "2026-03-31T16:50:00Z",
      "end_time": "2026-03-31T16:55:00Z",
      "coin_price_start": 67701.82777476,
      "condition_id": "0x740cfdbafa8d1b1d51729da79b05e641158d3a7c889175dab1eab20a2c92b5cc",
      "clob_token_up": "83511279567738325562016865404511480598726292757090195771777541218161914729159",
      "clob_token_down": "66091509674921971407227514952521456996907573303653223323107401767726760115252",
      "final_volume": 202849.44,
      "final_liquidity": 12435.04,
      "coin_price_end": 67611.61304387,
      "resolved_at": "2026-03-31T16:55:25Z",
      "created_at": "2026-03-31T16:50:00.943587Z",
      "updated_at": "2026-03-31T17:21:20.768590Z"
    }
  ],
  "total": 2289,
  "limit": 50,
  "offset": 0,
  "warning": null
}

Data access limits by plan

Plan	BTC 5m & 15m	BTC 1h & 4h	BTC 24h	ETH/SOL Polymarket	Binance Spot	Binance Futures
Starter (Free)	Last 50	Last 24	Last 5	—	—	—
Pro	All	All	All	All	Included	Included
Enterprise	All	All	All	All	Included	Included