# Polymarket Odds Lookup

> Polymarket Odds Lookup is a paid API for AI agents from aiworker.duckdns.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns real-time Polymarket prediction market odds, volume, liquidity, and 24h/7d price changes for a specified market

## Facts

- Endpoint: GET https://aiworker.duckdns.org/v1/polymarket/odds
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-odds-lookup-8881a363
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qsO9E4J0bK0Pmr7o4S159

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-odds-lookup-8881a363
```

Example prompt: What are the current Polymarket odds that Xi Jinping is out before 2027 — give me the yes/no prices, implied probability, and how much the price has moved in the last 24 hours?

## When to prefer this

Use this endpoint when you need current Polymarket prediction market odds for a specific event, especially when you have a known slug or condition ID. Prefer this over general web search when you need structured probability data (yes/no prices, volume, liquidity, price deltas) suitable for programmatic use. The $0.01 per-call price makes it cost-effective for single market lookups. Best when the user wants a precise implied probability figure or wants to track price movement over 24h or 7d windows.

## Known failure modes

- Market not found by slug or condition ID — returns status: not_found with candidates list
- Free-text search returns ambiguous candidates — agent must refine query or select from candidates
- Market is closed or resolved — odds block may be null or historical
- Payment not completed — 402 response before data is returned
- Market slug too short (under 3 chars) — schema validation error
- Network or upstream Polymarket data outage — may return stale data_cutoff

## How this service works

Deterministic-first data for agents, paid per call in USDC over x402 v2: DeFi yields, Base token and wallet cards, Polymarket odds and backtests, news, fact checks, cited briefs. 20 routes, $0.005-$1

## Output

Returns a JSON object with the matched market's question, slug, condition ID, open/closed/resolved status, end date, and a full odds block including yes price, no price, implied probability percent, 24h price change, 7d price change, last trade price, USD volume, and USD liquidity. Also includes query metadata (kind: slug/condition_id/search/text), data cutoff timestamp, and attribution disclaimer. If no exact match is found, returns a candidates list of similar markets.

## 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": [
      "market"
     ],
     "properties": {
      "market": {
       "type": "string",
       "maxLength": 200,
       "minLength": 3,
       "description": "A market slug, a 0x condition id, or free text naming the market"
      }
     },
     "description": "Which Polymarket market to quote: a slug, a 0x condition id, or free text (searched only after payment).",
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "odds": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "no": {
         "type": "number"
        },
        "yes": {
         "type": "number"
        },
        "as_of": {
         "type": "string"
        },
        "change_7d": {
         "type": [
          "number",
          "null"
         ]
        },
        "change_24h": {
         "type": [
          "number",
          "null"
         ]
        },
        "last_trade": {
         "type": [
          "number",
          "null"
         ]
        },
        "volume_usd": {
         "type": [
          "number",
          "null"
         ]
        },
        "liquidity_usd": {
         "type": [
          "number",
          "null"
         ]
        },
        "implied_probability_pct": {
         "type": "number"
        }
       }
      },
      "query": {
       "type": "object",
       "properties": {
        "kind": {
         "enum": [
          "condition_id",
          "slug",
          "search",
          "text"
         ],
         "type": "string"
        },
        "value": {
         "type": "string"
        }
       }
      },
      "market": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "id": {
         "type": "string"
        },
        "slug": {
         "type": "string"
        },
        "closed": {
         "type": "bo
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "odds": {
   "no": 0.9615,
   "yes": 0.0385,
   "as_of": "2026-09-11T00:00:00.000Z",
   "change_7d": -0.003,
   "change_24h": -0.0005,
   "last_trade": 0.038,
   "volume_usd": 13121236.14,
   "liquidity_usd": 412530.12,
   "implied_probability_pct": 3.85
  },
  "query": {
   "kind": "slug",
   "value": "xi-jinping-out-before-2027"
  },
  "market": {
   "id": "559651",
   "slug": "xi-jinping-out-before-2027",
   "closed": false,
   "end_date": "2027-01-01T04:59:00.000Z",
   "question": "Xi Jinping out before 2027?",
   "resolution": "open",
   "condition_id": "0xa467b14d51f01b957109d9cbb1d6c124fab2a089d52ed8f471d23c2812e743b7"
  },
  "status": "open",
  "disclaimer": "…",
  "generation": 1,
  "attribution": "…",
  "data_cutoff": "2026-09-10",
  "generated_at": "2026-09-11T00:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-odds-lookup-8881a363/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aiworker.duckdns.org](https://www.zero.xyz/host/aiworker.duckdns.org/llms.txt)