{"uid":"cap_ih8m3NF49EmB-GD5HeFCV","slug":"api-seerium-xyz-9e0950a2","name":"Seerium Polymarket Advanced Screener","description":"Crypto and prediction market intelligence through x402.","url":"https://api.seerium.xyz/v1/pro/screener","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":{"limit":{"type":"number","minimum":1,"description":"Optional maximum advanced screener rows to return. Defaults to 200."},"preset":{"enum":["top_movers","top_setups"],"type":"string","description":"Optional advanced prediction-market screener preset for top movers or top setups."},"sortBy":{"type":"string","description":"Optional metric to sort by, such as setupScore, liquidity, volume, momentumMedium, or mispricingScore. Defaults to setupScore."},"source":{"type":"string","description":"Optional market source filter, for example polymarket."},"sortDir":{"enum":["asc","desc"],"type":"string","description":"Optional sort direction. Defaults to desc."},"maxSpread":{"type":"number","description":"Optional maximum order book spread."},"minLiquidity":{"type":"number","description":"Optional minimum prediction-market liquidity in USD."},"minConfidence":{"type":"number","description":"Optional minimum Seerium agent confidence score."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"rows":[{"source":"polymarket","spread":0.01,"volume":5768589.43,"marketId":"1919425","liquidity":1201662.28,"updatedAt":"2026-03-25T11:59:30.000Z","marketName":"US x Iran permanent peace deal by May 31, 2026?","setupScore":15,"volatility":0,"momentumShort":-0.005,"slippageProxy":0.00912,"momentumMedium":0,"agentConfidence":0,"mispricingScore":0.02}]},"meta":{"requestId":"req_example_123","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000,"generatedAt":"2026-03-25T12:00:00.000Z"},"product":{"id":"pro-screener","name":"Polymarket Pro Screener API","path":"/v1/pro/screener","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":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":5,"preset":"top_setups","sortBy":"setupScore","source":"polymarket","sortDir":"desc"}}},"response":{"data":{"rows":[{"source":"polymarket","spread":0.001,"volume":2124496.431,"marketId":"558959","liquidity":7781773.24393,"updatedAt":"2026-06-07T04:27:44.480Z","marketName":"Will Iran win the 2026 FIFA World Cup?","setupScore":15,"volatility":0,"momentumShort":-0.0005,"slippageProxy":0.000358,"momentumMedium":0,"agentConfidence":0,"mispricingScore":0.002},{"source":"polymarket","spread":0.001,"volume":1634584.593,"marketId":"558981","liquidity":4527221.76117,"updatedAt":"2026-06-07T04:27:44.480Z","marketName":"Will Congo DR win the 2026 FIFA World Cup?","setupScore":15,"volatility":0,"momentumShort":-0.0005,"slippageProxy":0.00047,"momentumMedium":0,"agentConfidence":0,"mispricingScore":0.002},{"source":"polymarket","spread":0.001,"volume":1411333.418628,"marketId":"558963","liquidity":2515193.14789,"updatedAt":"2026-06-07T04:27:44.480Z","marketName":"Will Morocco win the 2026 FIFA World Cup?","setupScore":15,"volatility":0,"momentumShort":-0.0005,"slippageProxy":0.000631,"momentumMedium":0,"agentConfidence":0,"mispricingScore":0.002},{"source":"polymarket","spread":0.001,"volume":1407359.422146,"marketId":"558961","liquidity":4369847.77297,"updatedAt":"2026-06-07T04:27:44.480Z","marketName":"Will South Korea win the 2026 FIFA World Cup?","setupScore":15,"volatility":0,"momentumShort":-0.0005,"slippageProxy":0.000478,"momentumMedium":0,"agentConfidence":0,"mispricingScore":0.002},{"source":"polymarket","spread":0.001,"volume":1393837.049546,"marketId":"558945","liquidity":1593221.79448,"updatedAt":"2026-06-07T04:27:44.480Z","marketName":"Will Mexico win the 2026 FIFA World Cup?","setupScore":15,"volatility":0,"momentumShort":-0.0005,"slippageProxy":0.000792,"momentumMedium":0,"agentConfidence":0,"mispricingScore":0.002}]},"meta":{"requestId":"86819e74-60aa-49ad-8866-3f4b69c8caa9","totalRows":840,"updatedAt":"2026-06-07T04:27:44.480Z","dataSource":"prediction-cache","sourceRows":840,"freshnessMs":261624,"generatedAt":"2026-06-07T04:32:06.104Z","returnedRows":5},"product":{"id":"pro-screener","name":"Polymarket Pro Screener API","path":"/v1/pro/screener","price":"$0.0050","method":"GET","accepts":[{"payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.0050","scheme":"exact","network":"eip155:8453"},{"payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.0050","scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"service":"seerium-x402-api"}},"exampleRequest":{"limit":5,"preset":"top_setups","sortBy":"setupScore","source":"polymarket","sortDir":"desc"},"tags":["x402"],"displayCostAmount":"0.005","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.005/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_jOGlWvRj0GOCsfTfts8Qp","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":"Ranks and filters Polymarket prediction-market setups by setup score, confidence, liquidity, spread, volume, momentum, and mispricing to surface the best trading opportunities.","exampleAgentPrompt":"Show me the top 10 Polymarket setups right now using the top_setups preset, sorted by setupScore descending, with at least $500 in liquidity and a minimum confidence of 0.6 — keep the spread under 0.1.","exampleUseCases":[{"title":"Spot highest-momentum prediction markets daily","prompt":"What are the biggest movers on Polymarket today? Show me the top 20 markets ranked by momentum, but only include ones with at least $1000 in liquidity and under 0.15 spread — I want to see where the action is happening."},{"title":"Find underpriced bets with strong signals","prompt":"Hunt down Polymarket opportunities that look mispriced right now. Give me markets scoring above 0.7 confidence with high setup scores, filter to ones with decent liquidity, and sort by mispricing — I'm looking for edge where the odds don't match the fundamentals."},{"title":"Screen liquid markets for swing trading","prompt":"I need a quick scan of Polymarket's best liquid markets for short-term trading. Show me setups with at least $2000 liquidity, tight spreads under 0.12, and rank them by both momentum and setup score — focus on markets where I can actually get size in and out."}],"resultDescription":"Returns a ranked list of Polymarket prediction-market rows, each scored by Seerium's proprietary setup score, confidence, liquidity, spread, volume, momentum, and mispricing metrics, allowing agents to identify the highest-quality trading opportunities at a glance.","failureModes":["Invalid preset value returns 400 error","minLiquidity or minConfidence out of valid range returns 400","No markets match filters returns empty result set","Payment not included or insufficient returns 402","Source filter for unsupported market returns empty or error","sortBy field name not recognized returns 400"],"whenToPreferThis":"Use this endpoint when you need a ranked, filtered screener view of Polymarket setups with composite scoring (setup score, momentum, mispricing) rather than raw market data. Prefer this over the basic Polymarket scan when you want agent-ready ranked opportunities with Seerium's proprietary signals applied. Use the preset parameter for quick top_movers or top_setups views, or build a custom filter with minLiquidity, minConfidence, and maxSpread.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:31:58.573Z","isFirstParty":false}