Supported Markets

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

Assets & timeframes

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

Asset	API param	Timeframes	Snapshot freq.
BTC Bitcoin `coin="btc"`	`coin="btc"`	5m15m1hr4hr24hr	8×/sec
ETH Ethereum `coin="eth"`	`coin="eth"`	5m15m1hr	8×/sec
SOL Solana `coin="sol"`	`coin="sol"`	5m15m1hr	8×/sec
XRP XRP Coming Soon Collecting data `coin="xrp"`	`coin="xrp"`	5m15m1hr4hr24hr	8×/sec
DOGE Dogecoin Coming Soon Collecting data `coin="doge"`	`coin="doge"`	5m15m1hr4hr24hr	8×/sec
BNB BNB Coming Soon Collecting data `coin="bnb"`	`coin="bnb"`	5m15m1hr4hr24hr	8×/sec

~Snapshots per market = duration × 8 (e.g. 5m ≈ 2,400, 24h ≈ 691,200).

Data Availability

Data availability depends on your plan: Builder (and the 3-day free trial, which includes it in full) covers a recent window, while Pro and Enterprise have unlimited historical access. For range queries, each request supports a maximum 31-day window.

Builder

14 days

Access to approximately 14 days of historical market and snapshot data — including during the 3-day free trial.

Pro

Popular

Unlimited

Full access to historical data.

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. Older data is purged after 31 days.

Market Object Schema

Every market returned by the API contains the following fields.

Field	Type	Description
`market_id`	`string`	Unique numeric identifier for the market
`event_id`	`string`	Parent event ID on Polymarket
`slug`	`string`	Human-readable URL slug (e.g. btc-updown-5m-1772689200)
`market_type`	`string`	Duration type: 5m \| 15m \| 1h \| 4h \| 24h
`coin`	`string`	Cryptocurrency: btc \| eth \| sol \| xrp \| doge \| bnb
`start_time`	`ISO 8601`	When the market opened for trading
`end_time`	`ISO 8601`	When the market resolved
`price_start`	`number`	Asset spot price at market open
`price_end`	`number \| null`	Asset spot price at market close (null if unresolved)
`winner`	`string \| null`	Outcome: "Up" or "Down" (null if unresolved)
`final_volume`	`number`	Total trading volume in the market
`final_liquidity`	`number`	Total liquidity at market close
`condition_id`	`string`	On-chain condition identifier
`clob_token_up`	`string`	CLOB token ID for the "Up" outcome
`clob_token_down`	`string`	CLOB token ID for the "Down" outcome
`resolved_at`	`ISO 8601 \| null`	Timestamp of market resolution
`created_at`	`ISO 8601`	When the record was created in PolyTest
`updated_at`	`ISO 8601`	Last update timestamp

Snapshot Object Schema

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

Field	Type	Description
`id`	`integer`	Unique row identifier
`market_id`	`string`	Parent market ID (foreign key)
`time`	`ISO 8601`	Timestamp of this snapshot
`spot_price`	`number \| null`	Asset spot price at snapshot time
`price_up`	`number \| null`	Probability of "Up" outcome (0.00–1.00)
`price_down`	`number \| null`	Probability of "Down" outcome (0.00–1.00)
`orderbook_up`	`object \| null`	Full orderbook for "Up" token (when requested)
`orderbook_down`	`object \| null`	Full orderbook for "Down" token (when requested)

Orderbook fields are only included when you pass include_orderbook=true in your request. Orderbook data is available on Builder, 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_time is set, trading begins
2Snapshots are captured 8×/sec — probability prices update in real-time
3Market resolves — winner is 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.