# Polymarket Markets Query API

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

Query and browse Polymarket prediction markets with filtering, sorting, and pagination support

## Facts

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

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 sol-blockrun-ai-41370dfb
```

Example prompt: Show me the current active prediction markets on Polymarket — can you list them with their details?

## When to prefer this

Use this endpoint when you need to discover or browse Polymarket prediction markets programmatically, especially when you want to filter, sort, or paginate through available markets. Prefer this over scraping Polymarket directly or using other prediction market APIs when you need structured access via a paid microtransaction API on Solana.

## Known failure modes

- Invalid filter parameters return empty or error response
- Payment failure due to insufficient USDC balance (x402 payment required)
- Rate limiting if too many requests are made
- Network timeout if Polymarket data is unavailable
- Pagination out of range returns empty result set

## How this service works

Query Polymarket markets with filtering, sorting, and pagination

## Output

A paginated list of Polymarket prediction markets, each containing market data objects with metadata such as market name, status, outcomes, and other relevant market details.

## 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/sol-blockrun-ai-41370dfb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from sol.blockrun.ai](https://www.zero.xyz/host/sol.blockrun.ai/llms.txt)