{"uid":"cap_Qoa8tyM2GYxmFJ9y_rgxn","slug":"polymarket-snapshot-market-search-f67ab69a","name":"Polymarket Snapshot Market Search","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.","url":"https://polymarket-snapshot.x402supply.com/tools/search_markets?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":10,"maximum":25,"minimum":1},"order":{"enum":["volume24hr","liquidity","endDate"],"type":"string","default":"volume24hr"},"query":{"type":"string","maxLength":200,"minLength":1},"active":{"type":"boolean","default":true}}},"responseSchema":{"type":"json","example":{"asOf":"2026-10-09T15:41:09.090Z","count":2,"query":"bitcoin","source":["https://gamma-api.polymarket.com/public-search?q=bitcoin&limit_per_type=2&events_status=active"],"markets":[{"id":"5207028","slug":"bitcoin-above-84k-on-october-9-2026","active":true,"closed":false,"endDate":"2026-10-09T16:00:00Z","outcomes":[{"name":"Yes","price":0.0015,"tokenId":"19237762638725087250431461906504177217210669994224395220619355341866160991623"},{"name":"No","price":0.9985,"tokenId":"93618513453377158964239064041600906714858234857183117432206005018664887747326"}],"question":"Will the price of Bitcoin be above $84,000 on October 9?","resolved":false,"liquidity":32376.21131,"volume24hr":269998.3403630001,"volumeTotal":284993.617939,"resolvedOutcome":null},{"id":"5207026","slug":"bitcoin-above-82k-on-october-9-2026","active":true,"closed":false,"endDate":"2026-10-09T16:00:00Z","outcomes":[{"name":"Yes","price":0.9985,"tokenId":"76275224781672571834510870490547558994817468433622601301060687031724197252736"},{"name":"No","price":0.0015,"tokenId":"108082883404059740358158280426412241943168347279841724118483048088071392041003"}],"question":"Will the price of Bitcoin be above $82,000 on October 9?","resolved":false,"liquidity":28428.87938,"volume24hr":175374.7637170001,"volumeTotal":212454.7067089999,"resolvedOutcome":null}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Oj5FGqwK2Ai7Xo_VpqhK0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Polymarket prediction markets by text query and returns current outcome prices, volume, liquidity, end date, and resolution status.","exampleAgentPrompt":"Search Polymarket for the top 5 active prediction markets about the 2024 US presidential election, sorted by liquidity, and show me the current outcome prices and end dates.","exampleUseCases":[{"title":"Political event probability check","prompt":"What are the current Polymarket odds for the Fed cutting interest rates this year? Show me the top 10 active markets sorted by volume."},{"title":"Crypto market sentiment research","prompt":"Find me the most liquid active prediction markets on Polymarket about Bitcoin price or ETF approval — give me the outcome prices and how much volume they've done in the last 24 hours."},{"title":"Resolved market outcome verification","prompt":"Search Polymarket for any markets about the 2024 Super Bowl winner and tell me which ones have been resolved and what the final outcome was."}],"resultDescription":"Returns a list of matching Polymarket prediction markets, each including current outcome prices (probabilities), 24-hour trading volume, liquidity depth, market end date, and resolution status. Results are ordered by the specified sort field (volume24hr, liquidity, or endDate) and limited to the requested count.","failureModes":["Empty results if query matches no markets — returns empty list rather than an error","Query too long (over 200 characters) — validation error","Limit out of range (below 1 or above 25) — validation error","Payment failure — 402 response if USDC payment is not included or insufficient","Stale data if Polymarket snapshot is not recently updated — prices may lag real-time","Invalid order enum value — schema validation error"],"whenToPreferThis":"Choose this endpoint when you need to discover or look up Polymarket prediction markets by topic and retrieve live-ish market data including probabilities, volume, and liquidity. Prefer this over manual Polymarket browsing or scraping when building agents that need programmatic access to prediction market data. Best for research, monitoring sentiment on events, or building dashboards. Not suitable for placing trades or executing transactions — this is read-only market data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T18:30:39.213Z","isFirstParty":false,"canonicalSlug":"polymarket-snapshot-market-search-f67ab69a"}