# Polymarket Top Markets

> Polymarket Top Markets is a paid API for AI agents from bess-x402.onrender.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-28).

Returns the most active open Polymarket prediction market events ranked by volume or liquidity, with live probabilities per market, optionally filtered by topic tag.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/predictions/polymarket/top?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-top-markets-67e5cfc3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NFg9ItVOsBEDxBvn9ZI9g

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-markets-67e5cfc3
```

Example prompt: What are the top 10 Polymarket prediction markets in the politics category right now, ranked by 24-hour volume? Show me the live probabilities for each.

## When to prefer this

Use this endpoint when you need a real-time ranked snapshot of the most active or liquid Polymarket prediction markets, especially when filtering by topic (crypto, politics, sports, economy, tech, AI). Prefer this over manually browsing Polymarket when an agent needs programmatic access to current trader sentiment and probabilities across many events at once.

## Known failure modes

- Invalid tag slug returns empty results or an error
- Limit out of range (below 1 or above 50) may return an error or be clamped
- Invalid order value may return a 400 error
- Polymarket data unavailable or stale if upstream API is down
- Network timeout from the hosted service on Render under load

## How this service works

Most active open Polymarket events right now, ranked by 24h volume, total volume or liquidity, optionally by tag (crypto, politics, sports, economy, tech, ai). Each event lists its markets with live probabilities. Use to see what traders are betting on today.

## Output

A ranked list of open Polymarket events with their associated markets, each including the event title, market names, current yes/no probabilities, 24h volume, total volume, and liquidity figures. Results are sorted by the requested ordering criterion (volume24hr by default) and capped at the requested limit.

## 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",
     "required": [],
     "properties": {
      "tag": {
       "type": "string",
       "description": "Polymarket tag slug, e.g. crypto, politics, sports"
      },
      "limit": {
       "type": "integer",
       "description": "Maximum number of results (1-50)"
      },
      "order": {
       "type": "string",
       "description": "volume24hr, volume, liquidity, startDate or endDate"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-top-markets-67e5cfc3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bess-x402.onrender.com](https://www.zero.xyz/host/bess-x402.onrender.com/llms.txt)