POST/markets/information

Query markets by information filters

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

Request body

Field	Type	Required
id	integer[]	no
slug	string[]	no
closed	boolean	no
clobTokenIds	string[]	no
conditionIds	string[]	no
liquidityNumMin	number	no
liquidityNumMax	number	no
volumeNumMin	number	no
volumeNumMax	number	no
startDateMin	string	no
startDateMax	string	no
endDateMin	string	no
endDateMax	string	no
relatedTags	boolean	no
tagId	integer	no
cyom	boolean	no
umaResolutionStatus	string	no
gameId	string	no
sportsMarketTypes	string[]	no
rewardsMinSize	number	no
questionIds	string[]	no
includeTags	boolean	no

Example

curl -X POST "https://gamma-api.polymarket.com/markets/information" \
  -H "Content-Type: application/json" \
  -d '{
  "id": [],
  "slug": [],
  "closed": false
}'

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	Filtered markets
422	Validation error

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.