# Seerium Polymarket Reward Plans Optimizer

> Seerium Polymarket Reward Plans 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-13).

Discovers and ranks Polymarket sponsor reward quote strategies for a given USD budget, risk profile, and liquidity constraints.

## Facts

- Endpoint: POST https://api.seerium.xyz/v1/prediction/rewards/top-plans
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/seerium-polymarket-reward-plans-optimizer-de81dc79
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_q-0Z1cSmZOrNu1WRhvY0e

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-reward-plans-optimizer-de81dc79 -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Crypto and prediction market intelligence through x402.

## Output

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.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/seerium-polymarket-reward-plans-optimizer-de81dc79/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)