GET/markets

List markets

Base URL: https://gamma-api.polymarket.com
Auth: Public, no key
Rate limit: 300 req / 10s (30 per second)
Limit applies to: /markets

Things to know

At 300 requests per 10 seconds this is the tightest limit most integrations hit. Market metadata rarely changes during a market's life, so cache it instead of re-listing in a loop.

Parameters

Name	In	Type	Required	Description
limit	query	integer	no
offset	query	integer	no
order	query	string	no	Comma-separated list of fields to order by
ascending	query	boolean	no
id	query	integer[]	no
slug	query	string[]	no
clob_token_ids	query	string[]	no
condition_ids	query	string[]	no
liquidity_num_min	query	number	no
liquidity_num_max	query	number	no
volume_num_min	query	number	no
volume_num_max	query	number	no
start_date_min	query	string	no
start_date_max	query	string	no
end_date_min	query	string	no
end_date_max	query	string	no
tag_id	query	integer	no
related_tags	query	boolean	no
cyom	query	boolean	no
uma_resolution_status	query	string	no
game_id	query	string	no
sports_market_types	query	string[]	no
rewards_min_size	query	number	no
question_ids	query	string[]	no
include_tag	query	boolean	no
closed	query	boolean	no

Example

curl -X GET "https://gamma-api.polymarket.com/markets"

Returns a list of objects with these fields

Field	Type	Description
id	string
question	string
conditionId	string
slug	string
twitterCardImage	string
resolutionSource	string
endDate	string
category	string
liquidity	string
sponsorName	string
sponsorImage	string
startDate	string
xAxisValue	string
yAxisValue	string
denominationToken	string
fee	string
image	string
icon	string
lowerBound	string
upperBound	string
description	string
outcomes	string
outcomePrices	string
volume	string
active	boolean
marketType	string
formatType	string
lowerBoundDate	string
upperBoundDate	string
closed	boolean
createdBy	integer
updatedBy	integer
createdAt	string
updatedAt	string
closedTime	string
wideFormat	boolean
new	boolean
mailchimpTag	string
featured	boolean
archived	boolean

Responses

Status	Meaning
200	List of markets

Related endpoints

Polymarket's API serves current state only, so it cannot show what a market's book looked like after it resolved. PolyTest records Up/Down markets while they run and keeps the snapshots. Try it free, or read the full rate limit reference.

From Polymarket's published OpenAPI spec and rate-limit tables, synced 2026-10-04.