Sign in

v1

latestOpenAPI 3.1.02026-07-2657157254.1 KB
polymarket

Get Markets

List markets with filtering and sorting.

Consolidates active and closed markets into a single endpoint. Use status=open for active markets only.

Rolling metrics (volume_1d/7d/30d, trades, OI) are refreshed hourly.

get/v2/polymarket/markets/keyset

Query parameters

status'open' | 'closed'

Filter by status: open or closed

min_pricenumber nullable

Minimum price

Minimum price

max_pricenumber nullable

Maximum price

Maximum price

min_open_interestnumber nullable

Minimum open interest (USD)

Minimum open interest (USD)

min_volumenumber nullable

Minimum volume (USD)

Minimum volume (USD)

tagsstring[] nullable

Filter by tag(s)

Filter by tag(s)

event_slugstring[] nullable

Filter by event slug(s)

Filter by event slug(s)

searchstring nullable

Search in title (minimum 3 characters)

Search in title (minimum 3 characters)

condition_idstring[] nullable

Filter by condition ID(s)

Filter by condition ID(s)

question_idstring[] nullable

Filter by question ID(s)

Filter by question ID(s)

market_idstring[] nullable

Filter by market ID(s)

Filter by market ID(s)

market_slugstring[] nullable

Filter by market slug(s)

Filter by market slug(s)

token_idstring[] nullable

Filter by token ID(s) - matches either side_a or side_b

Filter by token ID(s) - matches either side_a or side_b

predexon_idstring[] nullable

Filter by predexon ID(s) - matches either side_a or side_b

Filter by predexon ID(s) - matches either side_a or side_b

end_afterinteger nullable

Filter to markets ending after this Unix timestamp

Filter to markets ending after this Unix timestamp

end_beforeinteger nullable

Filter to markets ending at or before this Unix timestamp

Filter to markets ending at or before this Unix timestamp

sort'volume' | 'open_interest' | 'price_desc' | 'price_asc' | 'expiration' | 'expiration_asc' | 'created' | 'created_asc' | 'relevance' | 'volume_1d' | 'volume_7d' | 'volume_30d' | 'trades_1d' | 'trades_7d' | 'trades_30d' | 'oi_change_1d' | 'oi_change_7d' | 'oi_change_30d'

Sort by

limitinteger

Number of markets to return

Number of markets to return

pagination_keystring nullable

Cursor returned from the previous response

Cursor returned from the previous response

offsetinteger

Deprecated. Offset pagination has been removed; only 0 is accepted.

Deprecated. Offset pagination has been removed; only 0 is accepted.

min_volume_1dnumber nullable

Minimum rolling 1-day volume (USD)

Minimum rolling 1-day volume (USD)

min_volume_7dnumber nullable

Minimum rolling 7-day volume (USD)

Minimum rolling 7-day volume (USD)

min_volume_30dnumber nullable

Minimum rolling 30-day volume (USD)

Minimum rolling 30-day volume (USD)

min_trades_1dinteger nullable

Minimum rolling 1-day trade count

Minimum rolling 1-day trade count

min_trades_7dinteger nullable

Minimum rolling 7-day trade count

Minimum rolling 7-day trade count

min_trades_30dinteger nullable

Minimum rolling 30-day trade count

Minimum rolling 30-day trade count

Response

Successful Response