{"openapi":"3.1.0","info":{"title":"polymarket-snapshot","version":"0.1.0","description":"Searches Polymarket prediction markets by text and returns current outcome prices, volume, liquidity, end date and resolution status. Read-only market data, not financial advice.; Fetches one Polymarket market by slug or id, optionally with best bid/ask, spread and top 5 order-book levels per outcome. Read-only market data, not financial advice.","x-guidance":"Read-only Polymarket prediction-market data. Not financial advice; this service never places orders and prices are a point-in-time snapshot that can change within seconds. `search_markets` takes a text `query` (1-200 chars) plus optional `active` (default true), `limit` (1-25, default 10) and `order` (volume24hr | liquidity | endDate, default volume24hr) and returns matching markets with current outcome prices (YES/NO or multi-outcome), volume24hr, volumeTotal, liquidity, endDate, closed/resolved status and the resolved outcome if any. Ordering is applied to the matches Polymarket returns for the query. `get_market` takes exactly one of `slug` or `id` and returns the same fields; set `includeBook:true` to also get best bid, best ask, spread and the top 5 order-book levels per outcome token from the Polymarket CLOB. Every response carries `source` URLs and an `asOf` ISO timestamp. Bad input returns `bad_request` (400); an unknown slug/id returns `not_found` (404); Polymarket 429/5xx/network/timeout failures return `upstream_failed` (502); a query with no matches returns an empty `markets` array, not an error.","contact":{"email":"jeff@fosterinstruments.com"}},"servers":[{"url":"https://polymarket-snapshot.x402supply.com"}],"paths":{"/mcp":{"post":{"operationId":"polymarket-snapshot_call","summary":"Call polymarket-snapshot via MCP tools/call","tags":["polymarket-snapshot"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method","params"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"method":{"const":"tools/call"},"params":{"type":"object","required":["name","arguments"],"properties":{"name":{"const":"search_markets"},"arguments":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":200},"active":{"type":"boolean","default":true},"limit":{"type":"integer","minimum":1,"maximum":25,"default":10},"order":{"type":"string","enum":["volume24hr","liquidity","endDate"],"default":"volume24hr"}},"required":["query"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},{"type":"object","required":["jsonrpc","id","method","params"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"method":{"const":"tools/call"},"params":{"type":"object","required":["name","arguments"],"properties":{"name":{"const":"get_market"},"arguments":{"type":"object","properties":{"slug":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$"},"id":{"type":"string","pattern":"^\\d{1,18}$"},"includeBook":{"type":"boolean","default":false}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}}]}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"JSON-RPC 2.0 response envelope. `result.content[0].text` is a JSON-encoded string matching the schema in `x-mcp-result-schema`.","properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"result":{"type":"object","properties":{"content":{"type":"array","items":{"type":"object","properties":{"type":{"const":"text"},"text":{"type":"string"}}}}}}},"x-mcp-result-schema":{"type":"object","required":["query","count","markets","source","asOf"],"properties":{"query":{"type":"string"},"count":{"type":"integer"},"markets":{"type":"array","items":{"type":"object","required":["id","slug","question","outcomes","closed","resolved"],"properties":{"id":{"type":"string"},"slug":{"type":"string"},"question":{"type":"string"},"outcomes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"price":{"type":["number","null"]},"tokenId":{"type":["string","null"]},"book":{"type":["object","null"]}}}},"volume24hr":{"type":["number","null"]},"volumeTotal":{"type":["number","null"]},"liquidity":{"type":["number","null"]},"endDate":{"type":["string","null"]},"active":{"type":"boolean"},"closed":{"type":"boolean"},"resolved":{"type":"boolean"},"resolvedOutcome":{"type":["string","null"]}}}},"source":{"type":"array","items":{"type":"string"}},"asOf":{"type":"string"}}}},{"type":"object","description":"JSON-RPC 2.0 response envelope. `result.content[0].text` is a JSON-encoded string matching the schema in `x-mcp-result-schema`.","properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"result":{"type":"object","properties":{"content":{"type":"array","items":{"type":"object","properties":{"type":{"const":"text"},"text":{"type":"string"}}}}}}},"x-mcp-result-schema":{"type":"object","required":["market","source","asOf"],"properties":{"market":{"type":"object","required":["id","slug","question","outcomes","closed","resolved"],"properties":{"id":{"type":"string"},"slug":{"type":"string"},"question":{"type":"string"},"outcomes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"price":{"type":["number","null"]},"tokenId":{"type":["string","null"]},"book":{"type":["object","null"]}}}},"volume24hr":{"type":["number","null"]},"volumeTotal":{"type":["number","null"]},"liquidity":{"type":["number","null"]},"endDate":{"type":["string","null"]},"active":{"type":"boolean"},"closed":{"type":"boolean"},"resolved":{"type":"boolean"},"resolvedOutcome":{"type":["string","null"]}}},"source":{"type":"array","items":{"type":"string"}},"asOf":{"type":"string"}}}}]}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]}}},"/tools/search_markets":{"post":{"operationId":"polymarket-snapshot_search_markets_http","summary":"Searches Polymarket prediction markets by text and returns current outcome prices, volume, liquidity, end date and resolution status. Read-only market data, not financial advice.","tags":["polymarket-snapshot"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":200},"active":{"type":"boolean","default":true},"limit":{"type":"integer","minimum":1,"maximum":25,"default":10},"order":{"type":"string","enum":["volume24hr","liquidity","endDate"],"default":"volume24hr"}},"required":["query"],"additionalProperties":false},"example":{"query":"bitcoin","limit":2}}}},"responses":{"200":{"description":"Tool result (plain JSON, not MCP-wrapped)","content":{"application/json":{"schema":{"type":"object","required":["query","count","markets","source","asOf"],"properties":{"query":{"type":"string"},"count":{"type":"integer"},"markets":{"type":"array","items":{"type":"object","required":["id","slug","question","outcomes","closed","resolved"],"properties":{"id":{"type":"string"},"slug":{"type":"string"},"question":{"type":"string"},"outcomes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"price":{"type":["number","null"]},"tokenId":{"type":["string","null"]},"book":{"type":["object","null"]}}}},"volume24hr":{"type":["number","null"]},"volumeTotal":{"type":["number","null"]},"liquidity":{"type":["number","null"]},"endDate":{"type":["string","null"]},"active":{"type":"boolean"},"closed":{"type":"boolean"},"resolved":{"type":"boolean"},"resolvedOutcome":{"type":["string","null"]}}}},"source":{"type":"array","items":{"type":"string"}},"asOf":{"type":"string"}}},"example":{"query":"bitcoin","count":2,"markets":[{"id":"5207028","slug":"bitcoin-above-84k-on-october-9-2026","question":"Will the price of Bitcoin be above $84,000 on October 9?","outcomes":[{"name":"Yes","price":0.0015,"tokenId":"19237762638725087250431461906504177217210669994224395220619355341866160991623"},{"name":"No","price":0.9985,"tokenId":"93618513453377158964239064041600906714858234857183117432206005018664887747326"}],"volume24hr":269998.34036300005,"volumeTotal":284993.61793899996,"liquidity":32376.21131,"endDate":"2026-10-09T16:00:00Z","active":true,"closed":false,"resolved":false,"resolvedOutcome":null},{"id":"5207026","slug":"bitcoin-above-82k-on-october-9-2026","question":"Will the price of Bitcoin be above $82,000 on October 9?","outcomes":[{"name":"Yes","price":0.9985,"tokenId":"76275224781672571834510870490547558994817468433622601301060687031724197252736"},{"name":"No","price":0.0015,"tokenId":"108082883404059740358158280426412241943168347279841724118483048088071392041003"}],"volume24hr":175374.76371700005,"volumeTotal":212454.7067089999,"liquidity":28428.87938,"endDate":"2026-10-09T16:00:00Z","active":true,"closed":false,"resolved":false,"resolvedOutcome":null}],"source":["https://gamma-api.polymarket.com/public-search?q=bitcoin&limit_per_type=2&events_status=active"],"asOf":"2026-10-09T15:41:09.090Z"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]}}},"/tools/get_market":{"post":{"operationId":"polymarket-snapshot_get_market_http","summary":"Fetches one Polymarket market by slug or id, optionally with best bid/ask, spread and top 5 order-book levels per outcome. Read-only market data, not financial advice.","tags":["polymarket-snapshot"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$"},"id":{"type":"string","pattern":"^\\d{1,18}$"},"includeBook":{"type":"boolean","default":false}},"additionalProperties":false},"example":{"slug":"bitcoin-above-84k-on-october-9-2026","includeBook":false}}}},"responses":{"200":{"description":"Tool result (plain JSON, not MCP-wrapped)","content":{"application/json":{"schema":{"type":"object","required":["market","source","asOf"],"properties":{"market":{"type":"object","required":["id","slug","question","outcomes","closed","resolved"],"properties":{"id":{"type":"string"},"slug":{"type":"string"},"question":{"type":"string"},"outcomes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"price":{"type":["number","null"]},"tokenId":{"type":["string","null"]},"book":{"type":["object","null"]}}}},"volume24hr":{"type":["number","null"]},"volumeTotal":{"type":["number","null"]},"liquidity":{"type":["number","null"]},"endDate":{"type":["string","null"]},"active":{"type":"boolean"},"closed":{"type":"boolean"},"resolved":{"type":"boolean"},"resolvedOutcome":{"type":["string","null"]}}},"source":{"type":"array","items":{"type":"string"}},"asOf":{"type":"string"}}},"example":{"market":{"id":"5207028","slug":"bitcoin-above-84k-on-october-9-2026","question":"Will the price of Bitcoin be above $84,000 on October 9?","outcomes":[{"name":"Yes","price":0.0015,"tokenId":"19237762638725087250431461906504177217210669994224395220619355341866160991623"},{"name":"No","price":0.9985,"tokenId":"93618513453377158964239064041600906714858234857183117432206005018664887747326"}],"volume24hr":269998.34036300005,"volumeTotal":284993.61793899996,"liquidity":32376.21131,"endDate":"2026-10-09T16:00:00Z","active":true,"closed":false,"resolved":false,"resolvedOutcome":null},"source":["https://gamma-api.polymarket.com/markets?slug=bitcoin-above-84k-on-october-9-2026"],"asOf":"2026-10-09T15:41:09.333Z"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]}}}}}