{"uid":"cap_UcIJjNScOmP4kYRyAGV-c","slug":"seerium-polymarket-rewards-lab-api-e5e1a061","name":"Seerium Polymarket Rewards Lab API","description":"Polymarket rewards lab API for agents. Analyzes sponsor rewards markets, order book depth, slippage, recent prints, and quote bands.","url":"https://api.seerium.xyz/v1/prediction/rewards/lab","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"market":{"type":"object","anyOf":[{"required":["marketId"]},{"required":["conditionId"]}],"required":["clobTokenIds"],"properties":{"marketId":{"type":"string","minLength":1,"description":"Preferred Polymarket reward market identifier. conditionId is also accepted."},"question":{"type":"string","minLength":1,"description":"Optional prediction-market question. marketSlug or identifier is used when omitted."},"marketSlug":{"type":"string","description":"Optional Polymarket market slug."},"conditionId":{"type":"string","description":"Alternative Polymarket condition id when marketId is not available."},"clobTokenIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"description":"Required Polymarket CLOB token ids for the market outcomes."},"rewardsMaxSpread":{"type":"number","minimum":0,"description":"Optional reward-eligible maximum spread."}},"additionalProperties":false},"markets":{"type":"array","items":{"type":"object","anyOf":[{"required":["marketId"]},{"required":["conditionId"]}],"required":["clobTokenIds"],"properties":{"marketId":{"type":"string","minLength":1,"description":"Preferred Polymarket reward market identifier. conditionId is also accepted."},"question":{"type":"string","minLength":1,"description":"Optional prediction-market question. marketSlug or identifier is used when omitted."},"marketSlug":{"type":"string","description":"Optional Polymarket market slug."},"conditionId":{"type":"string","description":"Alternative Polymarket condition id when marketId is not available."},"clobTokenIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"description":"Required Polymarket CLOB token ids for the market outcomes."},"rewardsMaxSpread":{"type":"number","minimum":0,"description":"Optional reward-eligible maximum spread."}},"additionalProperties":false},"minItems":1,"description":"Required unless market is provided. Reward markets to analyze. Use /v1/prediction/rewards first and pass returned marketId or conditionId plus clobTokenIds."},"tradesLimit":{"type":"number","minimum":1,"description":"Optional maximum recent prints to fetch per market when includePrints is true."},"includePrints":{"type":"boolean","description":"Optional flag to include recent Polymarket trade prints. Defaults to false."},"targetNotional":{"type":"number","minimum":1,"description":"Optional target quote notional used for depth and slippage analysis. Defaults to 1000."}}},"responseSchema":{"type":"json","example":{"data":{"markets":[{"prints":[{"side":"BUY","size":250,"price":0.49,"wallet":"0x1234567890abcdef1234567890abcdef12345678","outcome":"Yes","tradeId":"trade_1","timestamp":"2026-03-25T11:58:00.000Z"}],"spread":0.02,"marketId":"0xmarket","midpoint":0.48,"question":"Will BTC close above $110k this week?","marketSlug":"will-btc-close-above-110k-this-week","conditionId":"0xcondition","sponsorScore":92,"tokenMetrics":[{"spread":0.02,"bestAsk":0.49,"bestBid":0.47,"tokenId":"12345","midpoint":0.48,"heatmapBins":[{"price":0.49,"askSize":1400,"bidSize":0,"askNotional":686,"bidNotional":0},{"price":0.47,"askSize":0,"bidSize":1350,"askNotional":0,"bidNotional":634.5}],"buyProjection":{"fillPct":100,"worstPrice":0.492,"slippagePct":1.88,"averagePrice":0.489,"filledNotional":500,"targetNotional":500},"sellProjection":{"fillPct":100,"worstPrice":0.468,"slippagePct":1.88,"averagePrice":0.471,"filledNotional":500,"targetNotional":500},"depthWithinBandNotional":820,"depthWithinBandAskNotional":430,"depthWithinBandBidNotional":390}],"buyProjection":{"fillPct":100,"worstPrice":0.492,"slippagePct":1.88,"averagePrice":0.489,"filledNotional":500,"targetNotional":500},"sponsorWorthy":true,"sellProjection":{"fillPct":100,"worstPrice":0.468,"slippagePct":1.88,"averagePrice":0.471,"filledNotional":500,"targetNotional":500},"rewardsMaxSpread":0.03,"depthWithinBandNotional":820}],"targetNotional":500},"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-lab","name":"Polymarket Rewards Lab API","path":"/v1/prediction/rewards/lab","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_4AWh7ByeL5b3-wcs6UPGl","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":"Analyzes Polymarket rewards-eligible markets by evaluating order book depth, slippage, recent prints, and quote bands to help agents optimize liquidity-provision strategies.","exampleAgentPrompt":"Analyze the Polymarket rewards market with marketId '0xabc123' and clobTokenIds ['111','222'] — I want to see the order book depth, slippage, quote bands, and recent prints to decide if it's worth providing liquidity there.","exampleUseCases":[{"title":"Evaluating reward spread eligibility","prompt":"Check the Polymarket rewards lab analysis for marketId '0xdef456' with clobTokenIds ['333','444'] and a rewardsMaxSpread of 0.05 — I want to know if the current order book is tight enough to qualify for maker rewards."},{"title":"Comparing order book depth across markets","prompt":"Run the rewards lab on these two Polymarket markets — marketIds '0xaaa111' and '0xbbb222' with their respective clobTokenIds — so I can see which one has better depth and less slippage for liquidity provision."},{"title":"Optimizing quote bands for LP strategy","prompt":"I'm market-making on Polymarket and want to fine-tune my quotes. Analyze the rewards lab data for conditionId '0xccc333' with clobTokenIds ['555','666'] and show me the recent prints and recommended quote bands."}],"resultDescription":"Returns a detailed analysis object for one or more Polymarket rewards markets, including order book depth metrics, slippage estimates, quote band ranges, recent trade prints, spread eligibility against rewardsMaxSpread, and signals useful for optimizing liquidity-provider reward strategies.","failureModes":["Missing clobTokenIds returns a validation error","Neither marketId nor conditionId provided causes a 400 bad request","Invalid or non-existent marketId returns empty or error response","Payment of 0.1 USDC not included triggers a 402 Payment Required","Market no longer active may return stale or empty book data","Malformed clobTokenIds array returns schema validation error"],"whenToPreferThis":"Choose this endpoint when you need deep liquidity and reward-eligibility analysis for a specific Polymarket market — particularly when deciding whether to provide liquidity to earn maker rewards. It goes beyond simple price lookups by combining order book depth, slippage, and quote band data in one call. Prefer it over generic market data endpoints when your goal is Polymarket LP reward optimization rather than just price or volume checks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T06:38:58.864Z","isFirstParty":false}