Supported Markets
Understand the assets, timeframes, data schemas, and availability policies available through the PolyTest API.
Assets & timeframes
4 assetsPolyTest tracks prediction markets per asset on Polymarket. Each asset supports a subset of market timeframes (duration from open to resolution). Snapshots are captured at 8× per second on all timeframes. Use coin and market_type to filter in the API.
| Asset | Timeframes |
|---|---|
BTC Bitcoin
| 5m15m1h4h24h |
ETH Ethereum
| 5m15m1h4h24h |
SOL Solana
| 15m1h4h24h |
XRP XRP
| 1h4h24h |
~Snapshots per market = duration × 8 (e.g. 5m ≈ 2,400, 24h ≈ 691,200).
Data Availability
Data availability depends on your plan: Free includes the most recent 24 hours, while Pro and Enterprise have unlimited historical access. For range queries, each request supports a maximum 31-day window.
Free
Last 24 hours
Access to the most recent 24 hours of market and snapshot data.
Pro
PopularUnlimited
Full access to all historical data with no time restrictions.
Enterprise
Unlimited
Full historical access plus custom data availability policies and bulk exports.
Maximum data window: The start_time to end_time span is capped at 31 days per API request. Split larger backfills into multiple requests.
Market Object Schema
Every market returned by the API contains the following fields.
| Field | Type |
|---|---|
market_id | string |
event_id | string |
slug | string |
market_type | string |
coin | string |
start_time | ISO 8601 |
end_time | ISO 8601 |
btc_price_start | number |
btc_price_end | number | null |
winner | string | null |
final_volume | number |
final_liquidity | number |
condition_id | string |
clob_token_up | string |
clob_token_down | string |
resolved_at | ISO 8601 | null |
created_at | ISO 8601 |
updated_at | ISO 8601 |
synced_at | ISO 8601 |
Snapshot Object Schema
Snapshots capture a point-in-time state of a market, including prices, probabilities, and optional orderbook depth.
| Field | Type |
|---|---|
id | integer |
market_id | string |
time | ISO 8601 |
btc_price | number | null |
price_up | number | null |
price_down | number | null |
synced_at | ISO 8601 |
orderbook_up | object | null |
orderbook_down | object | null |
Orderbook fields are only included when you pass include_orderbook=true in your request. Orderbook data is available on Pro and Enterprise plans only.
How Markets Work
Each market represents a binary prediction: will the price of a given cryptocurrency go Up or Down within the market's timeframe?
Market Lifecycle
- 1Market opens —
start_timeis set, trading begins - 2Snapshots are captured 8×/sec — probability prices update in real-time
- 3Market resolves —
winneris set to "Up" or "Down" - 4Data is archived — snapshots remain queryable via API
Probability Prices
price_up and price_down represent market-implied probabilities from 0.00 to 1.00.
A price_up = 0.65 means the market assigns a 65% probability that the asset price will be higher at resolution time.
These prices are derived from the Polymarket orderbook and update with each snapshot.