Skip to main content
GET
/
v1
/
markets
/
{slug}
Get Market
curl --request GET \
  --url https://api.polyhistorical.com/v1/markets/{slug}
{
  "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 Market

Returns detailed data for a single market identified by its slug.

​
Request

GET https://api.polyhistorical.com/v1/markets/{slug}

​
Path parameters

​
slug
string
required
The market slug, e.g. btc-updown-5m-1774581000

​
Query parameters

​
coin
string
required
Cryptocurrency to query. Supported: BTC, ETH, SOL

​
Response

Returns a single market object.
​
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

​
Example

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.polyhistorical.com/v1/markets/btc-updown-5m-1774581000?coin=BTC"

​
Response

{
  "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": 87234.50,
  "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:10:05Z"
}