# Seerium Ranked Opportunities API

> Seerium Ranked Opportunities 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-14).

Ranks and filters Polymarket prediction market and DEX trading opportunities by budget, liquidity, spread, time horizon, and risk profile

## Facts

- Endpoint: POST https://api.seerium.xyz/v1/opportunities/ranked
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/seerium-ranked-opportunities-api-59025a99
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HufIYOWNlKiqwoZtxPiov

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-ranked-opportunities-api-59025a99 -d '<json body>'
```

Example prompt: Find me the top 10 ranked trading opportunities across both Polymarket and DEX markets with a balanced risk profile, a budget of $200, minimum liquidity of $5000, and only include ones closing within the next 48 hours — no short exposure.

## When to prefer this

Use this endpoint when you need a pre-ranked, multi-signal view of actionable trading opportunities across prediction markets and DEX, especially when filtering by budget constraints, risk tolerance, liquidity minimums, and time horizon — as opposed to raw price feeds, order book snapshots, or unranked market lists.

## Known failure modes

- Invalid enum value for source or riskProfile returns 400 validation error
- budgetUsd below minimum of 1 returns schema error
- No opportunities matching the given filters returns empty ranked list
- Service unavailable or upstream market data outage returns 5xx error
- minEdge or maxSpread values outside feasible range return empty results or validation error

## How this service works

Crypto and prediction market intelligence through x402.

## Output

Returns a ranked list of up to N trading opportunities (prediction market or DEX) scored and sorted by edge, liquidity, spread, horizon, and risk profile, with metadata per opportunity including market question or strategy, edge estimate, liquidity depth, spread, and time to close.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "minimum": 1,
   "description": "Optional maximum ranked opportunities to return. Defaults to 25."
  },
  "source": {
   "enum": [
    "all",
    "prediction",
    "dex"
   ],
   "type": "string",
   "description": "Optional opportunity source: Polymarket prediction markets, Dex markets, or all. Defaults to all."
  },
  "minEdge": {
   "type": "number",
   "description": "Optional minimum opportunity edge as a decimal or percent-style value."
  },
  "category": {
   "type": "string",
   "description": "Optional text filter over strategy, market question, event metadata, or theme."
  },
  "budgetUsd": {
   "type": "number",
   "minimum": 1,
   "description": "Optional maximum notional budget in USD."
  },
  "maxSpread": {
   "type": "number",
   "minimum": 0,
   "description": "Optional maximum acceptable order book spread."
  },
  "allowShort": {
   "type": "boolean",
   "description": "Optional flag to include opportunities requiring short exposure."
  },
  "riskProfile": {
   "enum": [
    "conservative",
    "balanced",
    "aggressive"
   ],
   "type": "string",
   "description": "Optional risk profile used to rank opportunities. Defaults to balanced."
  },
  "horizonHours": {
   "type": "number",
   "minimum": 0,
   "description": "Optional maximum hours to market close."
  },
  "minLiquidity": {
   "type": "number",
   "minimum": 0,
   "description": "Optional minimum market or leg liquidity in USD."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "rows": [
    {
     "fit": {
      "budgetOk": true,
      "spreadOk": true,
      "horizonOk": true,
      "liquidityOk": true
     },
     "edge": 0.035,
     "legs": [
      {
       "side": "BUY",
       "size": 500,
       "price": 0.49,
       "reason": "spread and liquidity screen passed",
       "outcome": "Yes",
       "tokenId": "poly_yes_token",
       "marketSlug": "us-x-iran-permanent-peace-deal-by-may-31-2026"
      }
     ],
     "rank": 1,
     "score": 81.4,
     "source": "prediction",
     "reasons": [
      "edge=0.035",
      "score=81.4",
      "avgAgentConfidence=72"
     ],
     "strategy": "mispricing_spread",
     "riskLevel": "medium",
     "description": "Strategy-derived opportunity from cached market snapshots.",
     "horizonHours": 48.2,
     "maxLegSpread": 0.02,
     "minLiquidity": 54000,
     "requiresShort": false,
     "avgAgentConfidence": 72,
     "estimatedNotionalUsd": 480
    }
   ],
   "criteria": {
    "limit": 3,
    "source": "all",
    "minEdge": null,
    "category": null,
    "budgetUsd": null,
    "maxSpread": null,
    "allowShort": true,
    "riskProfile": "balanced",
    "horizonHours": null,
    "minLiquidity": null
   },
   "returned": 1,
   "warnings": [],
   "totalCandidates": 42
  },
  "meta": {
   "requestId": "req_example_123",
   "updatedAt": "2026-03-25T11:59:30.000Z",
   "freshnessMs": 30000,
   "generatedAt": "2026-03-25T12:00:00.000Z"
  },
  "product": {
   "id": "ranked-opportunities",
   "name": "Ranked Market Opportunities API",
   "path": "/v1/opportunities/ranked",
   "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/seerium-ranked-opportunities-api-59025a99/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)