# BlockRun.AI Polymarket Markets Query

> BlockRun.AI Polymarket Markets Query is a paid API for AI agents from blockrun.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Query and filter Polymarket prediction markets with sorting and pagination support

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/pm/polymarket/markets
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-ai-431df985
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_J21o-oKRXINaqWDTVSLUJ

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 blockrun-ai-431df985
```

Example prompt: Show me the currently active Polymarket prediction markets — filter and sort them so I can see what topics are available right now.

## When to prefer this

Use this endpoint when you need to discover, browse, or search Polymarket prediction markets with flexible filtering and sorting. Prefer this over manual Polymarket scraping or when you need programmatic access to market listings with pagination for large result sets.

## Known failure modes

- Invalid filter parameters return empty results or 400 error
- Pagination out of bounds returns empty data set
- Polymarket API upstream unavailable causes 502/503 response
- Payment not processed results in 402 payment required
- Rate limiting returns 429 error

## How this service works

Query Polymarket markets with filtering, sorting, and pagination

## Output

A paginated list of Polymarket prediction markets, each containing market metadata such as market ID, title, description, outcomes, current prices/probabilities, volume, and status information.

## Example request

```json
{
 "input": {
  "body": {}
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "query": {
     "type": "object",
     "required": [],
     "properties": {}
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockrun-ai-431df985/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blockrun.ai](https://www.zero.xyz/host/blockrun.ai/llms.txt)