# Joe Market Data – Polymarket Prediction Markets

> Joe Market Data – Polymarket Prediction Markets is a paid API for AI agents from joe-market-data.marnick-yezo.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Fetches live Polymarket prediction market questions, volumes, and odds for AI agents via a micropayment-gated endpoint.

## Facts

- Endpoint: GET https://joe-market-data.marnick-yezo.workers.dev/pm-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/joe-market-data-polymarket-prediction-markets-16e6a1be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1cUOZ9XYyjOLYT_5FGKhQ

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 joe-market-data-polymarket-prediction-markets-16e6a1be
```

Example prompt: Pull the current active Polymarket prediction markets for me — I want to see which questions are being traded and their 24-hour volumes.

## When to prefer this

Choose this endpoint when you need real-time Polymarket prediction market data (questions, volume, odds) without building your own Polymarket integration, and you are operating in an x402/Base micropayment-enabled agent environment. Prefer this over scraping Polymarket directly or using heavier aggregator APIs when low cost ($0.001/call) and Otto-compatible path naming matter.

## Known failure modes

- Payment not included or insufficient (402 Payment Required — must send 0.001 USDC on Base via x402)
- No markets returned if Polymarket API is down or rate-limited upstream
- Malformed or missing 'properties' query parameter may return empty or default result set
- Upstream Polymarket outage may cause stale or missing data

## How this service works

Public-data market intel for AI agents: token prices (CoinGecko), DefiLlama TVL/fees/stables, Polymarket odds. Otto-compatible path names. $0.001 USDC per call on Base. No LLM/TTS/image.

## Output

A JSON object containing a list of active Polymarket prediction market questions with their 24-hour trading volume, a count of markets returned, the data source label ('polymarket'), the endpoint path, and the cost in USDC per call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "count": 25,
   "markets": [
    {
     "question": "Will X happen?",
     "volume24hr": 1000000
    }
   ]
  },
  "meta": {
   "source": "polymarket",
   "endpoint": "/pm-markets",
   "cost_usdc": "0.001"
  },
  "status": "success"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/joe-market-data-polymarket-prediction-markets-16e6a1be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from joe-market-data.marnick-yezo.workers.dev](https://www.zero.xyz/host/joe-market-data.marnick-yezo.workers.dev/llms.txt)