Search Markets

Full-text search across all Polymarket markets. Returns matching markets with metadata.

Search market questions by keyword. Returns matching markets with metadata, volume, and resolution status.

Request

GET /v3/markets/search

Query parameters

Parameter	Type	Default	Description
q	string	required	Search query (matched against market question)
limit	integer	100	Max 1000
offset	integer	0	Pagination offset

Example

curl "https://api.polynode.dev/v3/markets/search?q=bitcoin&limit=1"

{
  "columns": ["condition_id", "question", "slug", "category", "volume_all_time", "active", "closed", "winning_outcome_index", "tag_slugs"],
  "rows": [
    [
      "0x58c931c00e31fd20d02aade0c1e287e46a15b6da514c3ac3624e956e41bc45d0",
      "Will the price of Bitcoin be above $72,000 on February 13?",
      "bitcoin-above-72k-on-february-13",
      null,
      "999989.65550899994559586048126220703125",
      true,
      true,
      1,
      ["bitcoin", "weekly", "multi-strikes", "crypto", "crypto-prices", "recurring", "hide-from-new"]
    ]
  ],
  "rows_returned": 1,
  "has_more": true,
  "elapsed_ms": 12
}

Response fields

Field	Type	Description
condition_id	string	Market condition ID
question	string	Market question text
slug	string	URL slug
category	string	Market category
volume_all_time	string	Total volume traded
active	boolean	Whether the market is active
closed	boolean	Whether the market is closed
winning_outcome_index	integer	Which outcome won (null if unresolved)
tag_slugs	array	Category tags