List Markets

curl --request GET \
  --url https://api.polyhistorical.com/v1/markets

{
  "markets": [
    {}
  ],
  "total": 123,
  "limit": 123,
  "offset": 123,
  "slug": "<string>",
  "market_id": "<string>",
  "event_id": "<string>",
  "market_type": "<string>",
  "start_time": "<string>",
  "end_time": "<string>",
  "btc_price_start": 123,
  "btc_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>"
}

GET

markets

List Markets

curl --request GET \
  --url https://api.polyhistorical.com/v1/markets

{
  "markets": [
    {}
  ],
  "total": 123,
  "limit": 123,
  "offset": 123,
  "slug": "<string>",
  "market_id": "<string>",
  "event_id": "<string>",
  "market_type": "<string>",
  "start_time": "<string>",
  "end_time": "<string>",
  "btc_price_start": 123,
  "btc_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

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

Query parameters

coin

string

required

Cryptocurrency to query. Supported: BTC, ETH, SOL

limit

integer

default:"50"

Number of results to return (1-100)

offset

integer

default:"0"

Pagination offset

market_type

string

Filter by market type: 5m, 15m, 1hr, 4hr, 24hr

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

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, 4hr, 24hr)

start_time

string

Market start time (ISO 8601)

end_time

string

Market end time (ISO 8601)

btc_price_start

number

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

btc_price_end

number

BTC 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 -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-1774581000",
      "market_id": "1724470",
      "event_id": "308810",
      "market_type": "5m",
      "start_time": "2026-03-27T03:10:00Z",
      "end_time": "2026-03-27T03:15:00Z",
      "btc_price_start": null,
      "btc_price_end": null,
      "condition_id": "0xabc123",
      "clob_token_up": "71321",
      "clob_token_down": "71322",
      "winner": null,
      "final_volume": null,
      "final_liquidity": null,
      "resolved_at": null,
      "created_at": "2026-03-27T03:09:00Z",
      "updated_at": "2026-03-27T03:09:00Z"
    }
  ],
  "total": 1462,
  "limit": 10,
  "offset": 0
}

Market access limits by plan

Plan	BTC 5m & 15m	BTC 1h & 4h	BTC 24h
Starter (Free)	Last 50	Last 24	Last 5
Pro	All	All	All
Enterprise	All	All	All

Overview Get Market

⌘I

Getting Started

API Reference

Guides

List Markets

List Markets

Request

Query parameters

Response

Market object fields

Examples

Get active 5-minute BTC markets

Response

Market access limits by plan

Getting Started

API Reference

Guides

​List Markets

​Request

​Query parameters

​Response

​Market object fields

​Examples

​Get active 5-minute BTC markets

​Response

​Market access limits by plan

List Markets

Request

Query parameters

Response

Market object fields

Examples

Get active 5-minute BTC markets

Response

Market access limits by plan