{"uid":"cap_q-0Z1cSmZOrNu1WRhvY0e","slug":"seerium-polymarket-reward-plans-optimizer-de81dc79","name":"Seerium Polymarket Reward Plans Optimizer","description":"Crypto and prediction market intelligence through x402.","url":"https://api.seerium.xyz/v1/prediction/rewards/top-plans","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"number","minimum":1,"description":"Optional maximum optimized rewards plans to return. Defaults to 5."},"profile":{"enum":["passive","balanced","aggressive"],"type":"string","description":"Optional rewards quoting risk profile. Defaults to balanced."},"maxSpread":{"type":"number","minimum":0,"description":"Optional maximum current or reward max spread."},"minLiquidity":{"type":"number","minimum":0,"description":"Optional minimum CLOB liquidity."},"candidateLimit":{"type":"number","minimum":1,"description":"Optional maximum reward markets to evaluate before ranking. Defaults to 24."},"includeSkipped":{"type":"boolean","description":"Optional flag to include optimizer skip verdicts. Defaults to false."},"quoteBudgetUsd":{"type":"number","minimum":1,"description":"Optional USD budget available for qualifying reward quotes. Defaults to 1000."},"currentInventoryUsd":{"type":"number","description":"Optional signed current inventory exposure in USD. Defaults to 0."},"minDailyRewardsRate":{"type":"number","minimum":0,"description":"Optional minimum active daily reward rate."}}},"responseSchema":{"type":"json","example":{"data":{"plans":[{"plan":{"market":{"spread":0.02,"bestAsk":0.49,"bestBid":0.47,"marketId":"0xmarket","midpoint":0.48,"question":"Will BTC close above $110k this week?","marketSlug":"will-btc-close-above-110k-this-week","tokenCount":2,"conditionId":"0xcondition","clobRewardsEnd":"2026-03-28T00:00:00.000Z","rewardsMinSize":100,"clobRewardsStart":"2026-03-25T00:00:00.000Z","rewardsMaxSpread":0.03,"currentDailyRewardsRate":120},"verdict":"quote_both_sides","fillProb":{"next1h":0.55,"next15m":0.18},"inventoryRisk":{"level":"low","score":28,"currentInventoryUsd":0,"maxSuggestedInventoryUsd":700},"assumptionsUsed":{"profile":"balanced","quoteBudgetUsd":1000,"inventoryCapUsd":700,"currentInventoryUsd":0,"deployableBudgetUsd":700},"expectedRewardsPerDay":28.4},"rank":1,"score":82.7,"rankingReasons":["score=82.7","verdict=quote_both_sides","expectedRewardsPerDay=28.4","risk=low"]}],"skipped":[],"criteria":{"limit":5,"profile":"balanced","maxSpread":null,"minLiquidity":null,"candidateLimit":24,"includeSkipped":false,"quoteBudgetUsd":1000,"currentInventoryUsd":0,"minDailyRewardsRate":null},"returned":1,"totalCandidates":12,"evaluatedCandidates":5},"meta":{"requestId":"req_example_123","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000,"generatedAt":"2026-03-25T12:00:00.000Z"},"product":{"id":"sponsor-rewards-top-plans","name":"Polymarket Rewards Top Plans","path":"/v1/prediction/rewards/top-plans","price":"$0.1000","method":"POST","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.1","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.1/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_aXOTOumaNDulr6pa3O0cR","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":"Discovers and ranks Polymarket sponsor reward quote strategies for a given USD budget, risk profile, and liquidity constraints.","exampleAgentPrompt":"Find me the top 7 Polymarket reward plans using an aggressive risk profile and a $1500 quote budget, with at least $500 in CLOB liquidity and a max spread of 0.08 — show me only markets with a daily rewards rate above 0.1.","exampleUseCases":null,"resultDescription":"Returns a ranked list of Polymarket sponsor reward plans, each with a quoted reward strategy, spread, liquidity, and daily reward rate, optimized for the caller's budget and risk profile. Optionally includes optimizer skip verdicts for excluded markets.","failureModes":["No qualifying reward markets found for the given filters — returns empty plans list","Budget below minimum threshold ($1) returns a validation error","Invalid profile enum value returns 400 bad request","Candidate pool exhausted before reaching requested limit — returns fewer plans than requested","Payment not provided or insufficient USDC — returns 402 payment required"],"whenToPreferThis":"Use this endpoint when an agent needs to systematically discover and rank Polymarket reward opportunities given a specific budget, risk appetite, and liquidity requirements. Prefer this over generic Polymarket market listing endpoints when the goal is reward yield optimization rather than price discovery or trade signal generation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:44:16.266Z","isFirstParty":false}