# Prediction market data (/docs/mcp/tool-reference/prediction-market-data)

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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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._
