prediction_market_lookup

io.github.nansen-ai/nansen-mcp · Verify this server

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.