# Polymarket Market Resolution Lookup

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

Looks up the resolution status, outcome, payout vector, and trading data for any Polymarket prediction market by slug, condition ID, or free-text question.

## Facts

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

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-market-resolution-lookup-a2dea1b3
```

Example prompt: Has the Polymarket market 'Will Xi Jinping be out before 2027?' resolved yet? Use the slug xi-jinping-out-before-2027 and tell me the outcome, payout, and when it closed.

## When to prefer this

Use this endpoint when you need a deterministic, factual record of whether a specific Polymarket prediction market has resolved and how — especially for post-hoc verification, settlement confirmation, or historical research. Prefer it over LLM-based guessing for resolution status. It supports all three lookup methods (slug, condition ID, free text), so it works even when you only have a rough question in mind. Not suitable for price forecasting, trading decisions, or general web search.

## Known failure modes

- Free-text question matches no market — returns not_found with nearest candidate slugs and questions
- Ambiguous slug or question matches multiple markets — returns alternatives list
- Market exists but has not yet resolved — returns status: open with null resolution fields
- Polymarket Gamma API is unavailable — may return error or stale data
- Condition ID is malformed or unknown — returns not_found

## 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

A JSON object containing: the market's resolution status (open, resolved, voided, unknown, or not_found), the winning outcome and payout vector, timestamps for closure and resolution, the UMA status and resolver address, how many days after the end date it resolved, last traded price plus best bid/ask for Yes, outcome prices array, event categories, market metadata (slug, question, volume, condition ID), and nearest candidate matches when a free-text search finds no exact match. Includes a disclaimer that this is informational only.

## 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 Polymarket market slug (e.g. xi-jinping-out-before-2027), a 0x-prefixed 64-hex condition id, or the market question as free text"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "match": {
       "type": "object",
       "properties": {
        "candidates": {
         "type": "array",
         "items": {
          "type": "object",
          "properties": {
           "slug": {
            "type": "string"
           },
           "closed": {
            "type": "boolean"
           },
           "question": {
            "type": "string"
           }
          }
         }
        },
        "alternatives": {
         "type": "array",
         "items": {
          "type": "object",
          "properties": {
           "slug": {
            "type": "string"
           },
           "question": {
            "type": "string"
           }
          }
         }
        }
       }
      },
      "price": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "best_ask_yes": {
         "type": [
          "number",
          "null"
         ]
        },
        "best_bid_yes": {
         "type": [
          "number",
          "null"
         ]
        },
        "last_trade_yes": {
         "type": [
          "number",
          "null"
         ]
        },
        "outcome_prices": {
         "type": [
          "array",
          "null"
         ],
         "items": {
          "type": "number"
         }
        }
       }
      },
      "query": {
       "type": "object",
       "properties": {
        "kind": {
         "enum": [
          "condition_id",
          "slug",
          "search"
         ],
         "type":
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "match": {},
  "price": {
   "best_ask_yes": 0.039,
   "best_bid_yes": 0.038,
   "last_trade_yes": 0.038,
   "outcome_prices": [
    0.0385,
    0.9615
   ]
  },
  "query": {
   "kind": "slug",
   "market": "xi-jinping-out-before-2027"
  },
  "market": {
   "id": "559651",
   "slug": "xi-jinping-out-before-2027",
   "event": {
    "id": "30828",
    "slug": "xi-jinping-out-before-2027",
    "title": "Xi Jinping out before 2027?"
   },
   "end_at": "2027-01-01T04:59:00.000Z",
   "outcomes": [
    "Yes",
    "No"
   ],
   "question": "Xi Jinping out before 2027?",
   "start_at": "2025-07-03T20:37:00.228Z",
   "categories": [
    "geopolitics",
    "world",
    "world-affairs",
    "earn-4",
    "macro-geopolitics",
    "hfc"
   ],
   "created_at": "2025-07-03T20:25:56.889Z",
   "volume_usd": 13121236.14038798,
   "condition_id": "0xa467b14d51f01b957109d9cbb1d6c124fab2a089d52ed8f471d23c2812e743b7"
  },
  "status": "open",
  "sources": [
   {
    "ok": true,
    "url": "https://gamma-api.polymarket.com/markets/slug/xi-jinping-out-before-2027",
    "name": "gamma_slug"
   },
   {
    "ok": true,
    "url": "https://gamma-api.polymarket.com/events/30828/tags",
    "name": "gamma_event_tags"
   }
  ],
  "disclaimer": "Historical record and public API data; informational only, not a prediction or advice.",
  "resolution": {
   "payout": null,
   "outcome": null,
   "closed_at": null,
   "uma_status": null,
   "resolved_at": null,
   "resolved_by": "0x157Ce2d672854c848c9b79C49a8Cc6cc89176a49",
   "days_after_end": null
  },
  "attribution": "Data: Polymarket public APIs (Gamma, CLOB), attributed; SII-WANGZJ/Polymarket_data (MIT) for on-chain fills before 2026-07-21; derived figures only, no feed.",
  "generated_at": "2026-09-10T12:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-market-resolution-lookup-a2dea1b3/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)