Prediction market data
Search markets, read order books, prices and history. Public data, no sign-in.
9 tools. Generated from the Swop MCP server’s own tools/list (server version 0.2.2), so names, inputs and limits match what your client sees.
swop_search_markets
Search prediction markets · No sign-in · /mcp only · Read-only
Search Swop prediction markets (Polymarket-backed) by topic. Supports free-text search over question/event/outcomes/tags, plus live-game and sport filters. Returns market question, slug, outcomes with current prices, CLOB token ids, liquidity, and end date. Prices are 0..1 probabilities per outcome.
| Input | Type | Required | Description |
|---|---|---|---|
query | string | No | Free-text topic search, e.g. "bitcoin", "chiefs", "fed rates" |
tag_id | string | No | Sport/category tag id from swop_get_taxonomy |
live | boolean | No | Only markets whose event is live right now |
limit | integer | No | Max results, default 10 (min 1; max 50) |
offset | integer | No | Pagination offset (min 0) |
swop_get_event_markets
Get all markets for an event · No sign-in · /mcp only · Read-only
Fetch every market for a single event by event slug — moneyline plus alternate spread/total lines and player props for sports, or all outcomes for multi-outcome events. Use after swop_search_markets when the user wants full detail on one game/event.
| Input | Type | Required | Description |
|---|---|---|---|
slug | string | Yes | Event slug from a market result (eventSlug field) (min length 1) |
swop_get_event_live_status
Get live status of an event · No sign-in · /mcp only · Read-only
Check whether an event (e.g. a game) is live, its current period and elapsed time, and whether it has closed. Never infer live status from the clock — use this.
| Input | Type | Required | Description |
|---|---|---|---|
slug | string | Yes | Event slug (min length 1) |
swop_get_orderbook
Get market orderbook · No sign-in · /mcp only · Read-only
Fetch the live CLOB orderbook (bids/asks) for one outcome token of a prediction market. Token ids come from the clobTokenIds field of market results.
| Input | Type | Required | Description |
|---|---|---|---|
tokenId | string | Yes | CLOB token id for one outcome (min length 1) |
swop_get_prices
Get live prices for outcome tokens · No sign-in · /mcp only · Read-only
Batch-fetch current best prices for up to 50 outcome token ids. Returns live book-derived prices (0..1 probabilities). Prefer this over the outcomePrices field on market rows when freshness matters — cached market rows can lag the book.
| Input | Type | Required | Description |
|---|---|---|---|
tokenIds | array of string | Yes | CLOB token ids (min items 1; max items 50) |
swop_get_price_history
Get price history for an outcome token · No sign-in · /mcp only · Read-only
Historical price series for one outcome token. Interval controls the window (e.g. "1d", "1w", "1m", "max"); fidelity is the candle resolution in minutes.
| Input | Type | Required | Description |
|---|---|---|---|
tokenId | string | Yes | CLOB token id (min length 1) |
interval | string | No | Window: 1h, 6h, 1d, 1w, 1m, max (default max) |
fidelity | integer | No | Candle resolution in minutes, default 30 (min 1) |
swop_get_taxonomy
Get sports/category taxonomy · No sign-in · /mcp only · Read-only
Canonical mapping of sports and categories to tag ids, for use as tag_id in swop_search_markets. Also see swop_get_taxonomy_stats for open volume and live-game counts per sport.
No inputs.
swop_get_taxonomy_stats
Get per-sport market stats · No sign-in · /mcp only · Read-only
Open volume and live-event counts per sport/category — useful for "what is popular right now".
No inputs.
swop_check_predictions_access
Check prediction-market availability · No sign-in · /mcp only · Read-only
Check whether prediction-market trading is available (geo-restrictions apply in some regions). Call before suggesting trading actions; market DATA tools work everywhere.
No inputs.