# Seerium Polymarket Rewards Optimizer

> Seerium Polymarket Rewards Optimizer is a paid API for AI agents from api.seerium.xyz, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-16).

Optimizes Polymarket liquidity provider reward plans using live order books, recent prints, inventory, budget, and sponsor rewards metadata for a given market.

## Facts

- Endpoint: POST https://api.seerium.xyz/v1/prediction/rewards/optimize
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/seerium-polymarket-rewards-optimizer-0ac5d018
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v-Cs8qjjDgghlqesqcPTe

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability seerium-polymarket-rewards-optimizer-0ac5d018 -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Polymarket rewards optimizer API for agents. Produces reward plans from live books, recent prints, inventory, budget, and sponsor rewards metadata.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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",
   "pric
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/seerium-polymarket-rewards-optimizer-0ac5d018/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.seerium.xyz](https://www.zero.xyz/host/api.seerium.xyz/llms.txt)