markets

Get markets (keyset)

Get active, non-archived markets with keyset pagination.

get/markets/keyset

Request

  • Base URL: https://gamma-api.polymarket.com (the document declares no server; this is the origin it was published from)
  • URL: https://gamma-api.polymarket.com/markets/keyset
  • Auth: none declared

Query parameters

idinteger[] nullable

Market IDs to return

slugstring[] nullable

Market slugs to return

archivedstring

Filter by archived flag (true/false)

activestring

Filter by active flag (true/false)

decimalizedstring

Filter by decimalized flag (true/false)

closedstring

Filter by closed flag (true/false)

clob_token_idsstring[] nullable

CLOB token IDs to return

position_idsstring[] nullable

Position IDs to return

condition_idsstring[] nullable

Condition IDs to return

request_idsstring[] nullable

V2 oracle request IDs to return (conditionId for binary/incremental neg-risk, onchainEventId for atomic neg-risk)

onchain_event_idsstring[] nullable

V2 on-chain event IDs to return (all markets of each on-chain event)

market_maker_addressstring[] nullable

Market maker addresses to return

liquidity_num_minstring

Minimum liquidity

liquidity_num_maxstring

Maximum liquidity

volume_num_minstring

Minimum volume

volume_num_maxstring

Maximum volume

start_date_minstring

Minimum start date (RFC3339 or YYYY-MM-DD)

start_date_maxstring

Maximum start date (RFC3339 or YYYY-MM-DD)

end_date_minstring

Minimum end date (RFC3339 or YYYY-MM-DD)

end_date_maxstring

Maximum end date (RFC3339 or YYYY-MM-DD)

tag_idinteger[] nullable

Tag IDs to filter by

related_tagsstring

Include markets from related tags (true/false)

tag_matchstring

Tag match mode

cyomstring

Filter by CYOM flag (true/false)

rfq_enabledstring

Filter by RFQ-enabled flag (true/false)

combo_statusstring

Filter by combo status (pending/enabled/disabled)

uma_resolution_statusstring

Filter by UMA resolution status

resolution_status'inactive' | 'active' | 'resolved'

Filter by resolution status (inactive/active/resolved). v2 markets only — v1 markets carry no resolution_status and use uma_resolution_status instead

versionstring[] nullable

Protocol versions to return (v1 or v2). Repeat the parameter for several. Omitted means the server default on public lists (v1 while polymarket-v2 is in its builder integration period)

game_idstring

Filter by game ID

sports_market_typesstring[] nullable

Filter by sports market types

rewards_min_sizestring

Filter by minimum rewards size

question_idsstring[] nullable

Question IDs to return

include_tagstring

Include tag data (true/false)

localestring

Locale used to localize returned content

market_metadata_keystring

Filter by market metadata key

market_metadata_valuestring

Filter by market metadata value

limitinteger

Max results returned

offsetinteger

Number of results to skip

orderstring

Comma-separated field names to sort by

ascendingboolean

Sort ascending when true (default true)

after_cursorstring

Opaque keyset pagination cursor from a previous response

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

next_cursorstring

Changes

No recorded changes to this operation across all 1 revision of this API.