{"uid":"cap_GpeNl9YiedOrXdI7_1bKd","slug":"live-prediction-market-surface-polymarket-cac56951","name":"Live Prediction-Market Surface (Polymarket)","description":"The live TRADEABLE prediction-market surface, normalised for polling bots. Every liquid Polymarket market above a 24h-volume floor, each with its Yes probability, `edge` (min(yes,1-yes) — 0=resolved, 0.5=coin-flip), 24h volume, and liquidity. Query: min_volume (USD floor, default 1000), uncertain_only (true drops near-resolved), sort (volume|edge|liquidity), limit (1-100). Prices move — poll it; a cached copy is stale. Built for continuous trading loops, not one-shot lookups.","url":"https://x402.shizu.me/pmscan","method":"GET","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["method"],"properties":{"method":{"const":"GET"},"queryParams":{"type":"object","required":["min_volume","sort","limit"],"properties":{"sort":{"type":"string"},"limit":{"type":"string"},"min_volume":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"count":40,"venue":"polymarket","markets":[{"url":"https://polymarket.com/event/...","yes":0.34,"edge":0.34,"ends":"2026-12-31T00:00:00Z","question":"Will X happen by 2027?","liquidity":455381,"volume_24h":254637}],"scanned":399}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NWEBn3QLSkY8wLFtwBqEI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all liquid Polymarket prediction markets above a configurable volume floor, with live Yes probabilities, edge scores, 24h volume, and liquidity — designed for continuous trading loops.","exampleAgentPrompt":"Pull the live Polymarket surface right now — show me the top 25 markets sorted by edge, only the ones that aren't near-resolved, with a minimum 24h volume of $2000.","exampleUseCases":[{"title":"Continuous trading loop for a bot","prompt":"Every 60 seconds, fetch the top 50 Polymarket markets by volume with at least $1000 in 24h volume and only show me the uncertain ones — I need fresh prices for my trading algo."},{"title":"Screening for mispriced markets","prompt":"Show me the 20 Polymarket markets closest to a coin-flip right now — sorted by edge, minimum $5000 in 24h volume — so I can spot any that look mispriced."},{"title":"Liquidity dashboard for active traders","prompt":"Give me the current Polymarket markets sorted by liquidity, top 30, with no volume floor — I want to see everything liquid regardless of how certain the outcome looks."}],"resultDescription":"A ranked list of Polymarket markets each containing: market title, current Yes probability, edge score (min(yes, 1-yes) where 0=resolved and 0.5=coin-flip), 24h USD trading volume, and available liquidity — fresh live data, not cached.","failureModes":["Polymarket API unavailable — returns upstream error","min_volume or limit out of accepted range — returns validation error","uncertain_only with very high min_volume may return empty list if no markets qualify","Stale cache risk if polling interval is too long — data is only fresh at call time"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, filtered, and sorted view of the entire tradeable Polymarket surface in a single call — especially for trading bots that need to scan all liquid markets at once rather than look up a specific market. Prefer over the sibling 'Prediction Market Odds' endpoint when you need edge scoring, volume/liquidity filtering, and are building a continuous polling loop rather than a one-shot odds check.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:58:20.317Z","isFirstParty":false}