Skip to main content
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 under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
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).
string
Keyword search: a topic, person, asset or event to find markets about (e.g. bitcoin, election, Fed rates).
string[]
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.
string
default:"active"
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).
string
default:"volume"
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)).
integer
default:"100"
How many markets to return in total. Defaults to 100; use 0 for all.

Example

Response fields

Each row in data is one market, keyed by these fields.

Example response

Abridged: long text and lists are shortened.