# Polymarket Markets Feed

> Polymarket Markets Feed is a paid API for AI agents from mcp.gapup.io, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-18).

Returns live Polymarket prediction markets ranked by volume, with implied probability, liquidity, and end date, with optional free-text filtering.

## Facts

- Endpoint: POST https://mcp.gapup.io/api/v1/call/polymarket_markets?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-markets-feed-6bc15c05
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P5Yj1vu49XsWreEN7obZU

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-markets-feed-6bc15c05 -d '<json body>'
```

Example prompt: Show me the top 10 most active Polymarket prediction markets about AI — I want to see the implied probability and liquidity for each one.

## When to prefer this

Use this endpoint when you need real-time prediction market data from Polymarket specifically, including implied probabilities and liquidity ranked by volume. Prefer this over general news or sentiment APIs when you want crowd-sourced probabilistic forecasts on specific events. Best when you need filterable, structured market data rather than raw blockchain queries.

## Known failure modes

- No markets match the query filter — returns empty list
- Polymarket API unavailable — upstream error returned
- Limit parameter out of range (must be 1–100) — validation error
- Rate limit exceeded due to high call frequency

## How this service works

Live Polymarket prediction markets ranked by volume, with implied probability, liquidity and end date. Optional free-text filter.

## Output

A ranked list of live Polymarket prediction markets including the market question, implied probability (%), current liquidity, trading volume, and end date. Optionally includes Polymarket's original raw fields. Markets are sorted by volume descending, filtered by the query string if provided.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "async": {
   "type": "boolean",
   "description": "If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts."
  },
  "limit": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum markets (default 20)"
  },
  "query": {
   "type": "string",
   "maxLength": 200,
   "description": "Free-text filter on the market question"
  },
  "includeRaw": {
   "type": "boolean",
   "description": "Include Polymarket's original fields (default false)"
  },
  "includeClosed": {
   "type": "boolean",
   "description": "Include settled markets (default false)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-markets-feed-6bc15c05/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.gapup.io](https://www.zero.xyz/host/mcp.gapup.io/llms.txt)