gamma_search_public
Search Polymarket markets by describing a topic in plain text. Returns normalized markets to refine further with exact slug lookups.
Instructions
Search Polymarket discovery data by free-text topic.
Use this tool when you know a topic or phrase but do not yet know the exact market slug. This is the best first step for queries like "Fed decision", "NBA finals", or "election odds".
Prefer this tool over get_market_by_slug when you only have a natural
language description. Prefer list_markets when you already have a more
structured filter such as a known tag or exact slug.
The query should be plain human text, not a full URL. The result
returns normalized markets that can be followed up with
get_market_by_slug for a more precise single-market lookup. If you need
live pricing or the order book next, use the CLOB public server after you
obtain the market's token IDs.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| args | Yes | Structured free-text search arguments. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| markets | No | ||
| count | Yes | Return the number of matching markets. Returns: int: Number of returned markets. Raises: None. Examples: >>> SearchMarketsOutput(query="x", markets=[]).count 0 |