How do I search Polymarket markets programmatically?

GET /v1/markets?q=... returns markets matching a text query. You can also filter by tag, status (open/resolved), and resolution date range.

What metadata does a Polymarket market include?

Market ID, slug, question, outcomes, resolution date, tags, status, creator, and last price. Full schema is documented at marketlens.trade/docs/markets.

Data

Markets

Discover, filter, and retrieve prediction market metadata.

GET/markets

sdkclient.markets.list(**params)

Returns a paginated list of markets matching the given filters.

Parameters

statusstr

Filter by market status: "active", "closed", "resolved", or "pending".

qstr

Full-text search on market question.

event_qstr

Full-text search on parent event title.

event_idstr

Filter by parent event UUID.

series_idstr

Filter by series slug or UUID.

categorystr

Filter by event category.

condition_idstr | list

Filter by Polymarket condition ID(s). Up to 50.

recurringbool

Only markets belonging to a recurring series.

min_volumestr

Minimum lifetime volume in USD.

min_liquiditystr

Minimum current liquidity in USD.

sortstr= "-created_at"

Sort field. Prefix with - for descending.

limitint= 100

Results per page.

cursorstr

Pagination cursor from previous response.

Info

The SDK iterator auto-paginates. Use .to_list() to collect all results or .to_dataframe() for a pandas DataFrame.

markets = client.markets.list(
    q="bitcoin", sort="-volume"
)
for market in markets:
    print(market.question, market.volume)

jsonResponse

{
  "data": [{
    "id": "48e63898-0c55-55bb-...",
    "question": "Will the price of Bitcoin be above $66,000 on March 14?",
    "status": "active",
    "outcomes": [
      { "name": "Yes", "last_price": "0.9990" },
      { "name": "No", "last_price": "0.0010" }
    ],
    "volume": "18486.8551",
    "series_id": "btc-multi-strikes-weekly"
  }],
  "meta": { "cursor": "...", "has_more": true }
}

GET/markets/{market_id}

sdkclient.markets.get(market_id)

Retrieve a single market by UUID.

market = client.markets.get("5916b8f2...")
print(market.question, market.status, market.underlying)

jsonResponse

{
  "id": "5916b8f2-91d6-5438-...",
  "platform": "polymarket",
  "question": "Will Gold (GC) hit (HIGH) $5,500 by end of June?",
  "market_type": "binary",
  "status": "active",
  "outcomes": [
    { "name": "Yes", "index": 0, "last_price": "0.7200" },
    { "name": "No", "index": 1, "last_price": "0.2800" }
  ],
  "volume": "287063.4080",
  "liquidity": "24500.0000",
  "open_time": 1766791758794,
  "close_time": 1782840600000,
  "event_id": "125865",
  "series_id": "what-will-gold-gc-hit",
  "series_recurrence": "monthly",
  "underlying": "GC"
}