# x402 Polymarket Markets

> x402 Polymarket Markets is a paid API for AI agents from agentx402pay.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-20).

Search or list active Polymarket prediction markets ranked by 24-hour trading volume

## Facts

- Endpoint: GET https://agentx402pay.com/api/polymarket-markets?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-polymarket-markets-1369cb48
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vl6XSvdIOeFa4DB7SsDIZ

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 x402-polymarket-markets-1369cb48
```

Example prompt: Show me the top 10 most-traded Polymarket prediction markets right now — filter them to anything related to elections.

## When to prefer this

Use this endpoint when you need to discover or browse active Polymarket prediction markets, especially when you want to find markets by topic keyword or identify the highest-volume markets of the day. Prefer this over the Polymarket Market Detail endpoint when you don't yet know the specific market slug and need to search or explore. Prefer this over Kalshi Markets when the user specifically wants Polymarket (crypto-native, global, non-regulated) rather than regulated US event contracts.

## Known failure modes

- No markets match the keyword query — returns empty list
- limit parameter out of range (must be 1–50) — may return error or default
- Polymarket data source unavailable — upstream timeout or error response
- Payment not processed — x402 payment required before data is returned

## How this service works

Search or list active Polymarket prediction markets, ranked by 24h volume

## Output

A ranked list of active Polymarket prediction markets sorted by 24-hour trading volume, including market questions, slugs, volume metrics, and other market metadata. Supports optional keyword filtering and configurable result limits (1–50, default 10).

## 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": {
      "q": {
       "type": "string",
       "description": "Optional keyword filter on the market question"
      },
      "limit": {
       "type": "string",
       "description": "Max markets to return, 1-50 (default 10)"
      }
     }
    }
   },
   "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/x402-polymarket-markets-1369cb48/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentx402pay.com](https://www.zero.xyz/host/agentx402pay.com/llms.txt)