Skip to main content
GET
/
v1
/
markets
List Markets
curl --request GET \
  --url https://api.polyhistorical.com/v1/markets \
  --header 'X-API-Key: <x-api-key>'
{
  "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>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.polyhistorical.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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 -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
}

​
Market access limits by plan

PlanBTC 5m & 15mBTC 1h & 4hBTC 24hETH (5m, 15m, 1h)SOL (5m, 15m, 1h)
Starter (Free)Last 50Last 24Last 5——
ProAllAllAllAllAll
EnterpriseAllAllAllAllAll