{"uid":"cap_v-Cs8qjjDgghlqesqcPTe","slug":"seerium-polymarket-rewards-optimizer-0ac5d018","name":"Seerium Polymarket Rewards Optimizer","description":"Crypto and prediction market intelligence through x402.","url":"https://api.seerium.xyz/v1/prediction/rewards/optimize","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"profile":{"enum":["passive","balanced","aggressive"],"type":"string","description":"Optional rewards quoting risk profile. Defaults to balanced."},"marketId":{"type":"string","minLength":1,"description":"Required unless conditionId or marketSlug is provided. Use a marketId from /v1/prediction/rewards."},"marketSlug":{"type":"string","minLength":1,"description":"Required unless marketId or conditionId is provided. Use a marketSlug from /v1/prediction/rewards."},"conditionId":{"type":"string","minLength":1,"description":"Required unless marketId or marketSlug is provided. Use a conditionId from /v1/prediction/rewards."},"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."}}},"responseSchema":{"type":"json","example":{"data":{"why":["Live rewards rate is healthy relative to current inside-band depth.","Configured budget clears the reward min-size threshold across both token books.","Fill probability and inventory pressure support an active rewards quote 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},"targetSize":{"perTokenUsd":350,"meetsMinSize":true,"perTokenShares":729.17,"totalBudgetUsd":1000,"deployableBudgetUsd":700,"minQualifyingShares":100,"minQualifyingNotionalUsd":48},"diagnostics":{"sponsorScore":78,"hourlyFlowUsd":5166.67,"recentPrintCount":12,"printWindowMinutes":36,"projectedRewardShare":0.46,"recentPrintNotionalUsd":3100,"depthWithinBandNotional":820},"inventoryRisk":{"level":"low","score":28,"currentInventoryUsd":0,"maxSuggestedInventoryUsd":700},"assumptionsUsed":{"profile":"balanced","quoteBudgetUsd":1000,"inventoryCapUsd":700,"currentInventoryUsd":0,"deployableBudgetUsd":700},"recommendedQuoteBand":{"perToken":[{"askMax":0.5,"askMin":0.49,"bidMax":0.47,"bidMin":0.46,"tokenId":"12345","midpoint":0.48,"tickSize":0.01,"rewardEligibleBidFloor":0.45,"rewardEligibleAskCeiling":0.51}],"rewardEligibleMaxSpread":0.03},"expectedRewardsPerDay":28.4,"cancelReplaceThreshold":{"queueLossPct":24,"maxQuoteAgeSec":43,"midpointMoveBps":45}},"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-optimize","name":"Polymarket Rewards Optimizer API","path":"/v1/prediction/rewards/optimize","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_iL0fEJKmBWJi_RUDaRDcf","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":"Optimizes Polymarket liquidity provider reward plans using live order books, recent prints, inventory, budget, and sponsor rewards metadata for a given market.","exampleAgentPrompt":"Can you optimize my Polymarket rewards for the market with slug 'will-trump-win-2024' using a balanced profile, a $500 budget, and my current inventory at -$200?","exampleUseCases":[{"title":"Passive LP reward plan for a prediction market","prompt":"I want a passive reward plan for the Polymarket market with ID 'abc123' — I have a $1000 budget and I'm starting from zero inventory. What rewards can I realistically earn?"},{"title":"Aggressive strategy for high-budget maker","prompt":"Run an aggressive reward optimization for the Polymarket market slug 'fed-rate-cut-2025' — I have $5000 to quote with and I'm currently holding $300 in long inventory."},{"title":"Balanced rewards check before entering a market","prompt":"Before I start making markets on the Polymarket condition ID '0x1a2b3c4d', can you give me a balanced reward estimate assuming a $2000 quote budget and flat inventory?"}],"resultDescription":"Returns a structured reward plan including optimized quoting recommendations, projected reward amounts, LP strategy parameters (e.g. spread, skew), and sponsor reward metadata tailored to the specified market, risk profile, budget, and current inventory.","failureModes":["Missing all market identifiers (marketId, marketSlug, and conditionId all absent) returns a validation error","Invalid or unrecognized marketId/slug/conditionId returns not-found error","quoteBudgetUsd below minimum (1 USD) returns a validation error","Market with no active reward program returns empty or zero reward plan","Payment not provided or insufficient USDC results in 402 Payment Required","Stale or unavailable live book data may result in degraded or cached reward estimates"],"whenToPreferThis":"Use this endpoint when you need an actionable, optimized LP reward plan for a specific Polymarket market — especially when you have a known budget, inventory position, and risk preference. Prefer this over generic Polymarket data endpoints when the goal is to maximize maker rewards rather than just retrieve market information.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:42:45.195Z","isFirstParty":false}