Skip to main content
GET
Get a market's price to beat

Authorizations

Authorization
string
header
required

Raw database-backed API key.

Query Parameters

id
string
required

A supported Polymarket crypto up/down market slug, a condition ID formatted as 0x followed by exactly 64 hexadecimal characters, or an unsigned U256 token ID formatted as a base-10 integer. The 0x prefix is required for condition IDs so decimal values are always interpreted as token IDs.

Required string length: 1 - 255

Response

Market and price-to-beat availability details.

slug
string
required
status
enum<string>
required

Availability of the immutable opening price. Scheduled and pending responses are retryable; unavailable responses are not.

Available options:
scheduled,
pending,
available,
unavailable
market_state
enum<string>
required
Available options:
upcoming,
live,
ended
price_to_beat
number<double> | null
required

Immutable USD reference price at market start.

currency
enum<string>
required
Available options:
USD
crypto
enum<string>
required
Available options:
BTC,
ETH,
SOL,
XRP,
BNB,
DOGE,
HYPE,
ZEC
interval
enum<string>
required
Available options:
5m,
15m,
1h,
4h,
1d
price_source
enum<string>
required
Available options:
chainlink,
binance
twap_window
enum<string> | null
required

Chainlink TWAP window the market resolves against. Null for markets that started before the TWAP cutoff and for intervals with no TWAP feed (1h, 1d), which use a spot or Binance price instead.

The window an interval maps to is itself time-dependent: 5m markets use 30s until 2026-08-14T00:00:00Z and 60s from then on, decided on market start time; 15m and 4h use 60s throughout.

Available options:
30s,
60s
resolution_source
string | null
required
start_time
integer<int64>
required
end_time
integer<int64>
required
start_time_iso
string<date-time>
required
end_time_iso
string<date-time>
required
retryable
boolean
required
observed_at
string<date-time>
required
available_at
string<date-time>

Earliest expected availability; present for scheduled markets.

retry_after_seconds
integer<int64>

Suggested retry delay; present for scheduled and pending markets.

Required range: x >= 1