Find PREDICTION MARKETS - Polymarket betting / wagering markets, event contracts,
binary yes-no questions - by TITLE TEXT or by CATEGORY (sports, politics, crypto,
esports, weather, stocks, mentions, entertainment), and resolve them to a
Question_Id. CALL THIS FIRST whenever a request names a prediction market, a bet,
a wager or an event outcome in words rather than by id, before any odds /
probability / trade / settlement query. One row per market.
NOT live odds or implied probability -> use polymarket_market_odds.
NOT the individual bets / fills of a market -> use polymarket_market_trades.
NOT a volume ranking across many markets -> use polymarket_top_markets.
For one market's full detail (outcome / conditional token ids, oracle, collateral,
resolution rules) -> polymarket_market_info.
Polymarket on Polygon, history from September 2025 onward, down to the second.
The title search is case-insensitive AND accent/alphabet-aware, so "munchen",
"MUNCHEN" and "Munchen"-with-accent all reach the same titles. Leave `query` empty
and pass `category` and/or `after_time` to simply browse a slice of the market
list. Narrow with `status` (open = no resolution recorded yet; resolved = the
oracle has reported) and with `after_time` / `before_time`, which bound the
market's CREATION.
`category` is a coarse subject bucket derived from the market's own resolution
source and wording - use it for "what sports markets are open", "show me the
political / election markets", "crypto price markets". Values: sports, crypto,
esports, politics, weather, stocks (equities, commodities, macro), mentions
("will X say Y" / tweet-count markets), entertainment (awards, music, film),
other. It is a best-effort classification, not an official Polymarket taxonomy:
sports and crypto together are about 75 % of all markets, politics and
entertainment are small, and a market whose subject cannot be recognised is
reported as `other` (about 7 %). An empty value applies no category filter;
an unrecognised non-empty value is rejected. Every returned row carries its Category, so you can always see
how a market was classified. Category is NOT a filter on the outcome.
Each row returns Question_Id (the id every other polymarket_* tool takes), Title,
Status, Category, Created_Time, Resolved_Time and Resolved_Outcome (the winning
outcome - empty while the market is open), Outcomes (the outcome labels),
Condition_Id, Market_Id, Group_Id + Group_Title (markets belonging to one event
share a group) and Resolution_Source (the reference the market settles against).
The outcome ASSET IDS - needed to look at a single outcome - are deliberately not
in this list; get them from polymarket_market_info.
Created_Time is the market's on-chain registration; for markets whose registration
is not in the recorded history it falls back to the market's own creation timestamp,
capped at its first recorded event. Rows come back newest-created first, with the
question id as a stable tie-break - many markets are created in the same second.
A category filter costs roughly twice a plain title search, so when you already
know the wording prefer a specific `query` (a name, a number, a date) over
category plus a large `limit`.
