Supported Markets

Understand the assets, timeframes, data schemas, and availability policies available through the PolyTest API.

Assets & timeframes

4 assets

PolyTest 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.

AssetTimeframes
BTC

Bitcoin

coin="btc"

5m15m1h4h24h
ETH

Ethereum

coin="eth"

5m15m1h4h24h
SOL

Solana

coin="sol"

15m1h4h24h
XRP

XRP

coin="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

Popular

Unlimited

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.

FieldType
market_idstring
event_idstring
slugstring
market_typestring
coinstring
start_timeISO 8601
end_timeISO 8601
btc_price_startnumber
btc_price_endnumber | null
winnerstring | null
final_volumenumber
final_liquiditynumber
condition_idstring
clob_token_upstring
clob_token_downstring
resolved_atISO 8601 | null
created_atISO 8601
updated_atISO 8601
synced_atISO 8601

Snapshot Object Schema

Snapshots capture a point-in-time state of a market, including prices, probabilities, and optional orderbook depth.

FieldType
idinteger
market_idstring
timeISO 8601
btc_pricenumber | null
price_upnumber | null
price_downnumber | null
synced_atISO 8601
orderbook_upobject | null
orderbook_downobject | 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

  1. 1Market opens — start_time is set, trading begins
  2. 2Snapshots are captured 8×/sec — probability prices update in real-time
  3. 3Market resolves — winner is set to "Up" or "Down"
  4. 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.