# Polymarket Live Markets API

> Polymarket Live Markets API is a paid API for AI agents from x402-data-api.sigrunner.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns live Polymarket prediction market data including questions, outcomes, prices, spreads, volume, and liquidity ranked by 24-hour volume with optional keyword filtering

## Facts

- Endpoint: GET https://x402-data-api.sigrunner.workers.dev/pm/markets
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-live-markets-api-cff11c07
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XAm0Yq6UylJLozlZXMfL6

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-live-markets-api-cff11c07
```

Example prompt: Show me the top 20 most active Polymarket prediction markets right now — filter them to just crypto-related markets and include the current bid/ask prices, spread, and 24-hour volume for each.

## When to prefer this

Use this endpoint when you need live Polymarket prediction market data including prices, spreads, and volume metrics. Prefer it over manually scraping Polymarket when you need structured, ranked market data with filtering. Best for agents building prediction market dashboards, monitoring market sentiment, or finding specific markets by keyword.

## Known failure modes

- Invalid or unsupported query parameter returns empty results
- Exceeding limit of 100 markets returns only up to 100
- Polymarket API downtime causes 502/503 errors
- Payment of 0.005 USDC not provided results in 402 Payment Required
- Keyword filter with no matches returns empty market list

## How this service works

Query live Polymarket prediction markets — question, outcomes, live prices, bestBid/bestAsk/spread, volume24hr/volume1wk, oneDayPriceChange, clobTokenIds, conditionId, category tags, liquidity, end date. Ranked by volume24hr; filter by keyword.

## Output

A list of Polymarket prediction markets ranked by 24-hour volume, each including the market question, possible outcomes, live prices, best bid/best ask/spread, 24hr and 1-week volume, 1-day price change, CLOB token IDs, condition ID, category tags, liquidity, and end date.

## 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": {
      "limit": {
       "type": "string",
       "description": "Max markets to return (default 20, max 100)"
      },
      "query": {
       "type": "string",
       "description": "Optional keyword filter matched against the market question"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "slug": "will-x-happen-by-2026",
  "tags": [
   "Crypto",
   "Bitcoin"
  ],
  "active": true,
  "spread": 0.02,
  "volume": 1234567.89,
  "bestAsk": 0.66,
  "bestBid": 0.64,
  "endDate": "2026-12-31T12:00:00Z",
  "outcomes": [
   "Yes",
   "No"
  ],
  "question": "Will X happen by 2026?",
  "liquidity": 45678.12,
  "volume1wk": 412987.6,
  "volume24hr": 84213.45,
  "conditionId": "0xb6d6f15a1b5d08753653f1867ccd6126badfbe182a75159a330dc7b15336b30",
  "clobTokenIds": [
   "264852...",
   "884780..."
  ],
  "outcomePrices": [
   0.65,
   0.35
  ],
  "oneDayPriceChange": 0.01
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-live-markets-api-cff11c07/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-data-api.sigrunner.workers.dev](https://www.zero.xyz/host/x402-data-api.sigrunner.workers.dev/llms.txt)