Search Polymarket for events and markets by name, topic, URL, or slug.
**PM building blocks:**
- An **event** is a grouped prediction topic containing many child markets.
- A **market** is one tradable outcome with its own `marketId`.
- Example: `2026 NCAA Tournament Winner` is an event; `Will Duke win the
2026 NCAA Tournament?` is a market. Detail tools require `marketId`,
not `eventId`.
**When to use:**
- First tool when the user asks about a specific PM topic, event, slug, or
Polymarket URL but does not provide `marketId`.
- Optionally provide `queryVariant` as a cleaner short keyword version.
- Set `includeEventMarkets` to true to also return child markets for the
best-matching event.
- Do NOT use `general_search` for prediction markets.
- Results include current outcome prices, last trade price, and bid/ask
inline — for a quick probability check you may not need
`prediction_market_ohlcv`. For price *history* or dated moves, still
use `prediction_market_ohlcv`.
**Query tips:**
- Uses Polymarket's search API — natural language queries work well.
- Prefer short 1–3 keyword queries for best results.
- Avoid broad multi-topic queries like `bitcoin ethereum politics`.
**Output rules:**
- If lookup returns no suitable market or a mismatched timeframe, say so
explicitly — do not silently substitute a nearby market.