# Polymarket Prediction Market Data

> Polymarket Prediction Market Data is a paid API for AI agents from x402helper.xyz, paid per call via x402, $0.013/call, status unknown (last checked 2026-11-17).

Fetches current odds, prices, and market data for a Polymarket prediction market or event by ID or slug.

## Facts

- Endpoint: GET https://x402helper.xyz/89e509/prediction/market?utm_source=zero.xyz
- Price: $0.013/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-prediction-market-data-a64695c2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DH004b6SQMKla_HjRorsR

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-prediction-market-data-a64695c2
```

Example prompt: What are the current odds on Polymarket for the market with slug 'will-the-fed-cut-rates-in-september-2025'?

## When to prefer this

Use this endpoint when you need real-time prediction market data from Polymarket, specifically to look up a market by its numeric ID, 0x condition ID, market slug, or event slug. It is ideal for agents that want to check current odds or probabilities on prediction markets without scraping Polymarket directly. Prefer this over building a direct Polymarket API integration when you need a pay-per-use, agent-friendly micropayment-gated access point.

## Known failure modes

- Invalid or unknown market ID/slug returns an error or empty result
- Missing required 'id' query parameter causes a 400-level error
- Polymarket data unavailable or market not found returns success:false
- Payment failure via x402 (insufficient USDC) prevents the request from completing
- Non-Polymarket venues not supported — only 'polymarket' is a valid venue value

## How this service works

X402 micropayments server — AI agents pay USDC for OFAC screening, rates, and billing verification.

## Output

Returns a JSON object with market or event data from Polymarket, including current odds/prices, outcome probabilities, market status, volume, and metadata such as title and description. The response includes a 'success' boolean and a 'result' object containing the market details.

## 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",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "default": null,
       "description": "Market/event id: numeric id, 0x conditionId, market-slug or event-slug"
      },
      "venue": {
       "enum": [
        "polymarket"
       ],
       "type": "string",
       "default": null,
       "description": "Venue (default polymarket)"
      },
      "id_type": {
       "enum": [
        "market_id",
        "condition_id",
        "market_slug",
        "event_slug"
       ],
       "type": "string",
       "default": null,
       "description": "Optional hint; auto-detected if omitted"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {},
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-prediction-market-data-a64695c2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402helper.xyz](https://www.zero.xyz/host/x402helper.xyz/llms.txt)
