# Polymarket Resolution Watchlist API

> Polymarket Resolution Watchlist API is a paid API for AI agents from api.polym.uk, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Returns a ranked list of live Polymarket markets ordered by UMA resolution dispute-risk signals, with flip-rate risk tracked as a separate conditional axis.

## Facts

- Endpoint: GET https://api.polym.uk/resolution-watchlist
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-resolution-watchlist-api-4be7f6e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xaO0QwHu1XjqjZOT7g2WJ

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-resolution-watchlist-api-4be7f6e4
```

Example prompt: Pull the top 30 live Polymarket markets right now ranked by UMA resolution dispute risk, and show me which ones are in the elevated or watch tier along with their flip-rate percentages.

## When to prefer this

Choose this endpoint when you need a pre-ranked, signal-filtered watchlist of Polymarket markets specifically for UMA resolution dispute risk, rather than raw market data or general liquidity/flow screening. It is ideal for pre-trade risk checks, daily risk briefings, or automated monitoring of which markets carry structural dispute or flip risk — especially when the distinction between elevated, watch, and baseline tiers matters. Prefer sibling endpoints for taker-flow concentration, liquidity compatibility, or historical category base-rate lookups.

## Known failure modes

- top parameter out of range (must be 1–40) returns validation error
- payment not included or insufficient USDC causes 402 response blocking access
- no live markets available may return empty ranked list
- stale data if Polymarket data feed is delayed
- network timeout if upstream Polymarket data source is slow

## How this service works

Live Polymarket watchlist ranked by structural UMA resolution base-rate signals, with flip risk kept as a separate conditional axis. BEFORE YOU PAY: free substitute https://dash.polym.uk/markets.json and https://dash.polym.uk/uma-base-rates.json. THIS ADDS: The live subset ranked by structural dispute signals, computed for you. The inputs are in the free files; the ranking and the tiering are what this adds.

## Output

Returns a JSON object containing a timestamped ranked list of live Polymarket markets (up to 40) ordered by structural UMA resolution dispute risk. Each market entry includes its condition ID, title, category, risk tier (elevated/watch/baseline), dispute flag count, boolean flags for elevated category, subjective criterion, and flip-prone status, flip rate percentage, category dispute rate for high-volume markets, apparent volume in USD, and market closed status. The response also includes tier counts, a flip reference percentage, a howToRead explanation string, and caveats array.

## 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",
     "properties": {
      "top": {
       "type": "integer",
       "default": 25,
       "maximum": 40,
       "minimum": 1
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "asOf",
      "windowHours",
      "liveMarketsRanked",
      "tierCounts",
      "flipReferencePct",
      "markets",
      "howToRead",
      "caveats"
     ],
     "properties": {
      "asOf": {
       "type": "string",
       "format": "date-time"
      },
      "caveats": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "markets": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "conditionId",
         "title",
         "tier",
         "disputeFlagCount",
         "flags",
         "category",
         "titleLooksUncheckable",
         "categoryElevated",
         "categoryDisputeRatePctHighVolume",
         "flipRatePct",
         "apparentVolumeUsd",
         "marketClosed"
        ],
        "properties": {
         "tier": {
          "enum": [
           "elevated",
           "watch",
           "baseline"
          ],
          "type": "string"
         },
         "flags": {
          "type": "object",
          "required": [
           "categoryElevated",
           "titleLooksUncheckable",
           "flipProne"
          ],
          "properties": {
           "flipProne": {
            "type": "boolean",
            "description": "Separate conditional axis: if disputed, this category reverses at or above the overall rate. Never raises the tier."
           },
           "categoryElevated": {
            "type": "boolean",
            "description": "Category flagged elevated by consensus across both dispute samples. Dispute axis; counts toward tier."
           },
           "titleLooksUncheckable": {
            "type
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-resolution-watchlist-api-4be7f6e4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.polym.uk](https://www.zero.xyz/host/api.polym.uk/llms.txt)