# Polymarket Top 25 Prediction Markets Feed

> Polymarket Top 25 Prediction Markets Feed is a paid API for AI agents from x402.ottoai.services, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns the 25 highest-volume open Polymarket prediction markets with live odds, bid/ask, volume, liquidity, and price change data, refreshed every 5 minutes.

## Facts

- Endpoint: GET https://x402.ottoai.services/pm-markets
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-top-25-prediction-markets-feed-06fb2c58
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RtPpFGBy1-do1DFrXjZjc

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 polymarket-top-25-prediction-markets-feed-06fb2c58
```

Example prompt: Pull up the top Polymarket prediction markets right now — I want to see the 25 highest-volume open markets with their current odds, bid/ask spreads, and how prices have moved over the past day and week.

## When to prefer this

Use this endpoint when you need a broad, curated snapshot of the most active Polymarket prediction markets across all topics (politics, sports, crypto, etc.) with full market microstructure data. Prefer the sibling crypto-specific Polymarket endpoint if you only care about BTC/ETH/crypto markets. Prefer this endpoint over manually scraping Polymarket when you need structured, machine-readable odds and volume data in a single call.

## Known failure modes

- Payment failure: 402 response if USDC micropayment not included or insufficient
- Stale data: cache may be up to 5 minutes old during refresh cycle
- Empty data: no markets returned if Polymarket API is unreachable
- Service outage: 5xx if underlying data pipeline is down

## How this service works

Top Polymarket prediction markets RIGHT NOW: the 25 highest-volume open markets with live odds (outcome probabilities), best bid/ask, spread, last trade price, 24h + total volume, liquidity, 1d/7d price change, end date and event link. Flat JSON, refreshed every 5 minutes. Prediction market odds, Polymarket data, event probabilities, market sentiment. $0.001 per call.

## Output

A flat JSON object with status, meta (including generatedAt timestamp), and data array containing up to 25 market entries — each with market name, outcome probabilities, best bid, best ask, spread, last trade price, 24h and total volume, liquidity, 1-day and 7-day price change, end date, and a direct link to the event on Polymarket. Data is cached and refreshed every 5 minutes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "venue": "polymarket",
   "markets": [
    {
     "url": "https://polymarket.com/event/fed-decision-in-july-181",
     "slug": "will-the-fed-cut-rates-in-july",
     "spread": 0.01,
     "bestAsk": 0.89,
     "bestBid": 0.88,
     "endDate": "2026-07-29T00:00:00Z",
     "marketId": "516710",
     "outcomes": [
      {
       "outcome": "Yes",
       "probability": 0.885
      },
      {
       "outcome": "No",
       "probability": 0.115
      }
     ],
     "question": "Will the Fed cut rates in July?",
     "eventTitle": "Fed Decision in July?",
     "conditionId": "0x86f5b0f1934bb39421651ad2ba0f04494700ba9e95663a5c141a8674c4978c15",
     "liquidityUsd": 3395614.54,
     "volume24hUsd": 4821055.2,
     "lastTradePrice": 0.885,
     "volumeTotalUsd": 48348772.09,
     "oneDayPriceChange": 0.015,
     "oneWeekPriceChange": 0.0725
    }
   ],
   "generatedAt": "2026-07-10T12:00:00.000Z",
   "marketCount": 25,
   "totalVolume24hUsd": 92401882.4
  },
  "meta": {
   "degraded": false,
   "validUntil": "",
   "generatedAt": "",
   "stalenessSec": 0
  },
  "status": "success"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-top-25-prediction-markets-feed-06fb2c58/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.ottoai.services](https://www.zero.xyz/host/x402.ottoai.services/llms.txt)