# Seerium Ending-Soon Prediction Markets API

> Seerium Ending-Soon Prediction Markets API is a paid API for AI agents from api.seerium.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns active prediction markets from Polymarket, Kalshi, and Gemini that are resolving soon, with close times, bid/ask prices, volume, liquidity, and direct market links.

## Facts

- Endpoint: GET https://api.seerium.xyz/v1/prediction/ending-soon
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-seerium-xyz-53b0cc9e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yes7pwFUBbC68tP3hUWKa

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 api-seerium-xyz-53b0cc9e
```

Example prompt: Show me the top 30 prediction markets across Polymarket, Kalshi, and Gemini that are resolving within the next 12 hours — include the bid/ask prices, volume, and links.

## When to prefer this

Use this endpoint when you need a real-time snapshot of prediction markets about to expire across Polymarket, Kalshi, and/or Gemini, especially when you want to act on near-term opportunities or monitor resolution windows. Prefer this over general market search endpoints when time-to-resolution is the primary filter criterion.

## Known failure modes

- Invalid 'hours' value outside 1–168 range returns validation error
- Invalid 'source' enum value returns bad request
- 'limit' outside 1–100 range returns validation error
- No markets found for the given filter returns empty list
- Upstream venue data unavailable returns partial or error response
- Payment not included or insufficient USDC triggers 402 response

## How this service works

Crypto and prediction market intelligence through x402.

## Output

A list of active prediction markets resolving within the specified time window, each including market name, close time, bid price, ask price, volume, liquidity, venue (Polymarket/Kalshi/Gemini), and a direct market link.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "hours": 24,
   "limit": 30,
   "source": "all"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "hours": {
       "type": "number",
       "maximum": 168,
       "minimum": 1,
       "description": "Optional resolving-soon window in hours. Defaults to 24."
      },
      "limit": {
       "type": "number",
       "maximum": 100,
       "minimum": 1,
       "description": "Optional maximum ending-soon markets to return. Defaults to 25."
      },
      "source": {
       "enum": [
        "polymarket",
        "kalshi",
        "gemini",
        "all"
       ],
       "type": "string",
       "description": "Optional prediction market venue filter: polymarket, kalshi, gemini, or all. Defaults to all."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "rows": [
    {
     "noAsk": 0.58,
     "noBid": 0.56,
     "active": true,
     "closed": false,
     "source": "kalshi",
     "volume": 193200,
     "yesAsk": 0.44,
     "yesBid": 0.42,
     "noPrice": 0.57,
     "archived": false,
     "question": "Will Bitcoin be above $100,000 on May 31, 2026?",
     "yesPrice": 0.43,
     "eventSlug": "bitcoin-price-may-31-2026",
     "lastPrice": 0.43,
     "liquidity": 12800,
     "marketUrl": "https://kalshi.com/markets/KXBTC-26MAY31-B100000",
     "volume24h": 28450,
     "endDateIso": "2026-05-31T20:00:00.000Z",
     "eventTitle": "Bitcoin price on May 31, 2026",
     "indicative": true,
     "marketSlug": "kxbtc-26may31-b100000",
     "seriesSlug": "bitcoin",
     "conditionId": "KXBTC-26MAY31-B100000",
     "minTickSize": 0.01,
     "marketTicker": "KXBTC-26MAY31-B100000",
     "minOrderSize": 1,
     "seriesTicker": "KXBTC",
     "acceptingOrders": true,
     "minutesUntilEnd": 240,
     "sourceUpdatedAt": "2026-05-31T15:56:00.000Z"
    }
   ],
   "criteria": {
    "hours": 24,
    "limit": 25,
    "source": "all"
   },
   "returned": 1,
   "warnings": [],
   "timestamp": 1760000000000,
   "sourceCounts": {
    "gemini": 3,
    "kalshi": 4,
    "polymarket": 5
   },
   "sourceUpdatedAt": {
    "gemini": "2026-05-31T15:54:30.000Z",
    "kalshi": "2026-05-31T15:56:00.000Z",
    "polymarket": "2026-05-31T15:55:00.000Z"
   },
   "totalCandidates": 12
  },
  "meta": {
   "requestId": "req_example_123",
   "updatedAt": "2026-03-25T11:59:30.000Z",
   "freshnessMs": 30000,
   "generatedAt": "2026-03-25T12:00:00.000Z"
  },
  "product": {
   "id": "prediction-ending-soon",
   "name": "Ending Soon Prediction Markets API",
   "path": "/v1/prediction/ending-soon",
   "price": "$0.1000",
   "method": "GET",
   "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/api-seerium-xyz-53b0cc9e/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)