# PolyPulse: Top Polymarket Markets by Volume

> PolyPulse: Top Polymarket Markets by Volume is a paid API for AI agents from api.polypulse-x402.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Returns the top Polymarket prediction markets ranked by volume, with live odds, price changes, and liquidity data.

## Facts

- Endpoint: GET https://api.polypulse-x402.workers.dev/v1/markets/top?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polypulse-top-polymarket-markets-by-volume-0640136a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__HFiuPTIicrfA5JJWUmfH

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 polypulse-top-polymarket-markets-by-volume-0640136a
```

Example prompt: Pull up the top 10 Polymarket prediction markets by volume right now — I want to see live odds, 24-hour price changes, and liquidity for each.

## When to prefer this

Use this endpoint when you need the highest-volume or most liquid Polymarket prediction markets in a single call, especially with optional keyword filtering. Prefer this over the 'closing soon' or 'biggest movers' endpoints when your use case is discovering what markets are most actively traded rather than what's about to expire or what's seen the largest price swings.

## Known failure modes

- Polymarket Gamma API upstream outage — returns stale cached data or 502 error
- Payment not completed via x402 — returns 402 Payment Required
- Invalid query parameters (limit > 50 or < 1) — returns 400 validation error
- No markets match the keyword filter — returns empty markets array with count 0
- Cache miss during high-traffic period — may return slightly delayed data (up to 60s old)

## How this service works

Live Polymarket prediction-market data for AI agents: markets closing soon, biggest movers, top by volume ($0.01 each) and a one-call cross-market digest ($0.02). USDC via x402 on Base.

## Output

A JSON array of top Polymarket prediction markets ranked by volume, each including the market question, event name, outcome probabilities, yes price, best bid/ask, bid-ask spread, 24h and 1h price changes, total liquidity in USD, 24h volume in USD, end date, and a direct Polymarket URL. Also includes total count and cache timestamp.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string",
       "maxLength": 60,
       "description": "keyword filter (optional)"
      },
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 50,
       "minimum": 1
      },
      "min_liquidity": {
       "type": "number",
       "default": 0,
       "minimum": 0
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "source": "Polymarket Gamma API (live, cached <=60s)",
  "markets": [
   {
    "url": "https://polymarket.com/event/nfl-pit-cle-2026-10-02",
    "event": "Steelers vs. Browns",
    "spread": 0.01,
    "best_ask": 0.58,
    "best_bid": 0.57,
    "end_date": "2026-10-02T00:15:00Z",
    "outcomes": {
     "Browns": 0.425,
     "Steelers": 0.575
    },
    "question": "Steelers vs. Browns",
    "change_1h": 0,
    "yes_price": 0.575,
    "change_24h": 0.02,
    "liquidity_usd": 3447209,
    "volume_24h_usd": 516719
   }
  ],
  "generated_at": "2026-10-01T15:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polypulse-top-polymarket-markets-by-volume-0640136a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.polypulse-x402.workers.dev](https://www.zero.xyz/host/api.polypulse-x402.workers.dev/llms.txt)