# Seerium Polymarket Rewards Lab API

> Seerium Polymarket Rewards Lab API 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).

Analyzes Polymarket rewards-eligible markets by evaluating order book depth, slippage, recent prints, and quote bands to help agents optimize liquidity-provision strategies.

## Facts

- Endpoint: POST https://api.seerium.xyz/v1/prediction/rewards/lab
- 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-lab-api-e5e1a061
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UcIJjNScOmP4kYRyAGV-c

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-lab-api-e5e1a061 -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Polymarket rewards lab API for agents. Analyzes sponsor rewards markets, order book depth, slippage, recent prints, and quote bands.

## Output

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.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/seerium-polymarket-rewards-lab-api-e5e1a061/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)