POST /v1/data/polymarket/markets/run
Pricing: $0.0005 per market ($0.5 per 1,000).
Ways to call it
- Browse: set
category(optional:status,sortBy,maxResults) - Keyword search: set
query(optional:status,sortBy,maxResults) - By URL or slug: set
urls(optional:sortBy,maxResults)
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
Browse: one of Polymarket’s categories (e.g. Politics, Crypto, Sports). Returns the markets in it, biggest first. No search term needed.Allowed values:
politics (Politics), sports (Sports), crypto (Crypto), finance (Finance), economy (Economy), geopolitics (Geopolitics), tech (Tech), ai (AI), pop-culture (Culture), world (World), elections (Elections), business (Business), science (Science), weather (Weather), earnings (Earnings), esports (Esports).Keyword search: a topic, person, asset or event to find markets about (e.g. bitcoin, election, Fed rates).
By URL: polymarket.com/event/… links (or just the event slug, e.g. what-price-will-bitcoin-hit-before-2027). Returns every market in each event; a link that ends in a market slug returns just that market.
Open markets you can still trade (active, the default) or finished ones with a known outcome (resolved).Allowed values:
active (Active | currently open), resolved (Resolved | completed markets).How markets are ordered. Defaults to total volume (most-traded first).Allowed values:
volume (Total volume (all-time activity)), volume_24hr (24h volume (recent activity)), liquidity (Liquidity (deepest markets)), start_date (Start date (newest markets)), ending_soon (Ending soon (closes soonest)), competitive (Competitive (balanced odds)).Example
Response fields
Each row indata is one market, keyed by these fields.