{"uid":"cap_xaO0QwHu1XjqjZOT7g2WJ","slug":"polymarket-resolution-watchlist-api-4be7f6e4","name":"Polymarket Resolution Watchlist API","description":"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.","url":"https://api.polym.uk/resolution-watchlist","method":"GET","headers":{},"bodySchema":{"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":"boolean","description":"The title states no checkable threshold. Dispute axis; counts toward tier. Read from the title only."}},"additionalProperties":false},"title":{"type":"string"},"category":{"type":"string"},"conditionId":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"Polymarket condition ID."},"flipRatePct":{"type":["number","null"],"maximum":100,"minimum":0},"marketClosed":{"type":["boolean","null"]},"categoryElevated":{"type":"boolean"},"disputeFlagCount":{"type":"integer","minimum":0},"apparentVolumeUsd":{"type":"number","minimum":0},"titleLooksUncheckable":{"type":"boolean"},"categoryDisputeRatePctHighVolume":{"type":"number","maximum":100,"minimum":0}},"additionalProperties":false}},"howToRead":{"type":"string"},"tierCounts":{"type":"object","additionalProperties":{"type":"integer","minimum":0}},"windowHours":{"type":"number","minimum":0},"flipReferencePct":{"type":["number","null"],"maximum":100,"minimum":0,"description":"Overall flip reference rate, in percent. `null` means WITHHELD, never a default: see flipReferenceStatus and flipReferenceWithheldReason. When it is null, flipProne was not evaluated on any row."},"liveMarketsRanked":{"type":"integer","minimum":0},"flipReferenceStatus":{"enum":["measured","withheld"],"type":"string"},"flipReferenceWithheldReason":{"type":["string","null"]}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iSVEGpV_J-KNGbheKjK1F","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Pre-trade dispute risk screening","prompt":"Before I take a position, show me the top 20 Polymarket markets ranked by resolution dispute risk — I want to avoid anything in the elevated tier or with subjective criteria that could get disputed."},{"title":"Daily prediction market risk briefing","prompt":"Give me today's Polymarket resolution watchlist for the top 25 markets — flag any with elevated category dispute rates or high flip-rate risk so I can review them this morning."},{"title":"Category-level UMA dispute monitoring","prompt":"Pull the full Polymarket resolution watchlist and tell me which market categories are seeing elevated UMA dispute signals right now, including how many markets are in each risk tier."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:31:39.872Z","isFirstParty":false}