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. Case-insensitive substring match against the question, slug, and event_title fields. Multiple words are AND-matched.
limit	integer	100	Max 300
offset	integer	0	Pagination offset

How matching works

• ?q=bitcoin matches any market whose question, slug, or event title contains the substring bitcoin (any case).
• ?q=trump pardon matches questions containing both substrings, in any order.
• Punctuation in the query is preserved (?q=$72,000 matches the literal characters).
• Results are ordered by volume_all_time DESC so higher-traded markets surface first.

Example

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

{
  "data": [
    {
      "active": true,
      "category": null,
      "closed": true,
      "condition_id": "0x58c931c00e31fd20d02aade0c1e287e46a15b6da514c3ac3624e956e41bc45d0",
      "question": "Will the price of Bitcoin be above $72,000 on February 13?",
      "slug": "bitcoin-above-72k-on-february-13",
      "tag_slugs": [
        "Crypto",
        "Bitcoin",
        "Crypto Prices",
        "Recurring",
        "Hide From New",
        "Weekly",
        "Multi Strikes"
      ],
      "volume_all_time": "999989.65550899994559586048126220703125",
      "winning_outcome_index": 1
    }
  ],
  "elapsed_ms": 668,
  "has_more": true,
  "limit": 1,
  "offset": 0,
  "rows_returned": 1
}

Response fields (per row in data)

Field	Type	Nullable	Description
condition_id	string	no	Market condition ID
question	string	no	Market question text
slug	string	no	URL slug
category	string	yes	Optional category label
volume_all_time	string (decimal)	no	Total volume in USD at full precision
active	boolean	no	Currently active
closed	boolean	no	No longer accepting orders
winning_outcome_index	integer	yes	Which outcome won (null if unresolved)
tag_slugs	array<string>	yes	Tags in canonical (Title Case) form