Skip to main content
GET
List Markets

List Markets

Returns markets sorted by start_time descending (newest first).

Request

Headers

string
required
Your API key. See Authentication.

Query parameters

string
required
Cryptocurrency to query. Supported: BTC, ETH, SOL
integer
default:"100"
Number of results to return (1-100)
integer
default:"0"
Pagination offset
string
Filter by market type: 5m, 15m, 1hr (all coins), 4hr, 24hr (BTC only)
boolean
Filter by resolution status. false for active markets, true for resolved.
string
Filter markets starting after this time. Accepts epoch milliseconds or ISO 8601.
string
Filter markets starting before this time. Accepts epoch milliseconds or ISO 8601.

Response

array
Array of market objects
integer
Total number of markets matching the filter
integer
Number of results returned
integer
Current pagination offset
string
Warning message if applicable (null otherwise)

Market object fields

string
Market slug identifier
string
External market ID
string
External event ID
string
Market interval — 5m, 15m, 1hr (all coins), 4hr, 24hr (BTC only)
string
Market start time (ISO 8601)
string
Market end time (ISO 8601)
number
Coin price at market start (null if not yet recorded)
number
Coin price at market end (null if unresolved)
string
Polymarket condition ID
string
CLOB token ID for the “Up” outcome
string
CLOB token ID for the “Down” outcome
string
Winning outcome (null if unresolved)
number
Final trading volume (null if unresolved)
number
Final liquidity (null if unresolved)
string
Resolution timestamp (null if unresolved)
string
Record creation timestamp
string
Record last updated timestamp

Examples

Get active 5-minute BTC markets

Response

Data access limits by plan