List Markets
Polymarket
List Markets
List all markets with filtering and pagination
GET
List Markets
List Markets
Returns markets sorted bystart_time descending (newest first).
Request
Headers
string
required
Your API key. See Authentication.
Query parameters
string
required
Cryptocurrency to query. Supported:
BTC, ETH, SOLinteger
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