{"uid":"cap_AKA2sch1MAxlN7H0xlxa8","slug":"api-seerium-xyz-ea66b5eb","name":"Seerium Polymarket Prediction Market Scan","description":"Crypto and prediction market intelligence through x402.","url":"https://api.seerium.xyz/v1/prediction/scan","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"limitSnapshots":{"type":"number","minimum":1,"description":"Optional maximum Polymarket prediction-market snapshots to return."},"limitOpportunities":{"type":"number","minimum":1,"description":"Optional maximum prediction-market opportunities to return."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"scope":"prediction","markets":745,"warnings":[],"snapshots":[{"books":{"poly_no_token":{"asks":[{"size":9100,"price":0.53},{"size":7200,"price":0.54}],"bids":[{"size":12400,"price":0.51},{"size":8300,"price":0.5}],"tokenId":"poly_no_token","timestampMs":1760000000000},"poly_yes_token":{"asks":[{"size":9100,"price":0.49},{"size":7200,"price":0.5}],"bids":[{"size":12400,"price":0.47},{"size":8300,"price":0.46}],"tokenId":"poly_yes_token","timestampMs":1760000000000}},"market":{"active":true,"closed":false,"source":"polymarket","tokens":[{"price":0.48,"outcome":"Yes","tokenId":"poly_yes_token"},{"price":0.52,"outcome":"No","tokenId":"poly_no_token"}],"volume":70112309.42,"archived":false,"question":"US x Iran permanent peace deal by May 31, 2026?","eventSlug":"us-x-iran-permanent-peace-deal-by","liquidity":1201662.28,"volume24h":5768589.43,"endDateIso":"2026-05-31T00:00:00.000Z","eventTitle":"US x Iran permanent peace deal by...?","marketSlug":"us-x-iran-permanent-peace-deal-by-may-31-2026","conditionId":"1919425","acceptingOrders":true},"noBook":{"asks":[{"size":9100,"price":0.53},{"size":7200,"price":0.54}],"bids":[{"size":12400,"price":0.51},{"size":8300,"price":0.5}],"tokenId":"poly_no_token","timestampMs":1760000000000},"tokens":[{"price":0.48,"outcome":"Yes","tokenId":"poly_yes_token"},{"price":0.52,"outcome":"No","tokenId":"poly_no_token"}],"noToken":{"price":0.52,"outcome":"No","tokenId":"poly_no_token"},"yesBook":{"asks":[{"size":9100,"price":0.49},{"size":7200,"price":0.5}],"bids":[{"size":12400,"price":0.47},{"size":8300,"price":0.46}],"tokenId":"poly_yes_token","timestampMs":1760000000000},"yesToken":{"price":0.48,"outcome":"Yes","tokenId":"poly_yes_token"},"lastTrades":{"poly_no_token":0.52,"poly_yes_token":0.48}}],"timestamp":1760000000000,"allowShort":false,"opportunities":1,"opportunityList":[{"edge":0.035,"legs":[{"side":"BUY","size":500,"price":0.49,"reason":"spread and liquidity screen passed","outcome":"Yes","tokenId":"poly_yes_token","marketSlug":"us-x-iran-permanent-peace-deal-by-may-31-2026"}],"strategy":"prediction_mispricing","description":"Polymarket opportunity from cached market snapshots and order book spread.","requiresShort":false}]},"meta":{"requestId":"req_example_123","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000,"generatedAt":"2026-03-25T12:00:00.000Z"},"product":{"id":"prediction-scan","name":"Polymarket Prediction Market API","path":"/v1/prediction/scan","price":"$0.1000","method":"GET","accepts":[{"payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000","scheme":"exact","network":"eip155:8453"},{"payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000","scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"service":"seerium-x402-api"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_D2G-hWUn69p9stiFKdqFI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scans Polymarket prediction markets and returns ranked trading opportunities with market snapshots, order books, Seerium signals, and scored opportunity rankings.","exampleAgentPrompt":"Scan Polymarket right now and show me the top 5 ranked trading opportunities and 10 market snapshots — I want to see which prediction markets have the best signals and liquidity.","exampleUseCases":[{"title":"Identify mispriced election outcome contracts","prompt":"Look through Polymarket's election markets right now and find me any prediction contracts that are trading at odds that don't match the Seerium confidence signals — I want to spot the best risk-reward setups before the betting shifts."},{"title":"Monitor liquid prediction markets for day trading","prompt":"Scan Polymarket and give me the top opportunities in markets with really tight spreads and high volume — I'm looking for prediction contracts I can quickly enter and exit with minimal slippage."},{"title":"Find undervalued event outcome bets","prompt":"Search Polymarket for events or outcomes where the current odds seem disconnected from what Seerium's signals suggest — show me the highest-confidence trading opportunities ranked by potential edge and liquidity."}],"resultDescription":"Returns a structured payload containing Polymarket market snapshots (up to limitSnapshots), order book data, Seerium-generated trading signals with confidence scores, and a ranked list of prediction-market opportunities (up to limitOpportunities) filtered by liquidity, spread, and signal strength.","failureModes":["No liquid markets available — returns empty opportunities list","Polymarket data feed delay — snapshots may be stale","Invalid limitSnapshots or limitOpportunities values below minimum of 1 — schema validation error","Payment not fulfilled (x402) — returns 402 Payment Required before data is served","Rate limit exceeded — too many calls in a short window"],"whenToPreferThis":"Use this endpoint when an agent needs a broad, ranked scan of Polymarket prediction markets with Seerium intelligence layered on top — ideal for discovering high-opportunity trades, monitoring market signals, or ingesting order book context without manually querying individual markets. Prefer over raw Polymarket APIs when you want pre-ranked, signal-enriched output ready for agent consumption.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:51:18.273Z","isFirstParty":false}