{"uid":"cap_35K3B6yIgRbLAWUrODSYL","slug":"polymarket-resolution-risk-flip-base-rate-api-bdcc4c4a","name":"Polymarket Resolution Risk & Flip Base Rate API","description":"UMA resolution dispute and flip base rates by category and criterion clarity; descriptive historical compatibility, not a market-specific forecast. BEFORE YOU PAY: free substitute https://dash.polym.uk/uma-base-rates.json and https://dash.polym.uk/uma-flip-rate.json. THIS ADDS: The two artifacts joined into one response, dispute axis and flip axis already aligned by category. The underlying numbers are the same ones in those two free files.","url":"https://api.polym.uk/resolution-risk","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":{},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["asOf","flipAsOf","dataDegraded","elevatedRiskCategories","byCategory","clarity","flipOverall","howToRead","caveats"],"properties":{"asOf":{"type":"string","format":"date-time"},"caveats":{"type":"array","items":{"type":"string"}},"clarity":{"type":["object","null"],"required":["checkableTitle","uncheckableTitle"],"properties":{"checkableTitle":{"type":"object","required":["marketsScanned","disputeRatePct"],"properties":{"disputeRatePct":{"type":"number","maximum":100,"minimum":0},"marketsScanned":{"type":"integer","minimum":0},"disputedMarkets":{"type":"integer","minimum":0,"description":"Disputed markets in this title-clarity cell. Numerator of disputeRatePct."}},"additionalProperties":true},"uncheckableTitle":{"type":"object","required":["marketsScanned","disputeRatePct"],"properties":{"disputeRatePct":{"type":"number","maximum":100,"minimum":0},"marketsScanned":{"type":"integer","minimum":0},"disputedMarkets":{"type":"integer","minimum":0,"description":"Disputed markets in this title-clarity cell. Numerator of disputeRatePct."}},"additionalProperties":true}},"additionalProperties":false},"flipAsOf":{"type":["string","null"],"format":"date-time"},"howToRead":{"type":"string"},"byCategory":{"type":"array","items":{"type":"object","required":["category","disputeRatePctHighVolume","disputeRatePctChronological","disputeInsufficientSample","elevated","lockupHoursPerMarket","lockupHoursIfDisputed","flipRatePct","flipInsufficientSample"],"properties":{"category":{"type":"string"},"elevated":{"type":"boolean"},"flipRatePct":{"type":["number","null"],"maximum":100,"minimum":0},"lockupHoursPerMarket":{"type":["number","null"],"minimum":0},"lockupHoursIfDisputed":{"type":["number","null"],"minimum":0},"flipInsufficientSample":{"type":"boolean"},"disputeRatePctHighVolume":{"type":"number","maximum":100,"minimum":0},"disputeInsufficientSample":{"type":"boolean"},"disputeRatePctChronological":{"type":["number","null"],"maximum":100,"minimum":0}},"additionalProperties":false}},"flipOverall":{"type":["object","null"],"required":["flipRatePct","disputedResolved"],"properties":{"flipped":{"type":"integer","minimum":0,"description":"Disputes whose outcome reversed. Numerator of flipRatePct."},"splitCount":{"type":"integer","minimum":0,"description":"Disputes resolved to a split outcome rather than to one side."},"flipRatePct":{"type":"number","maximum":100,"minimum":0},"disputedResolved":{"type":"integer","minimum":0}},"additionalProperties":true},"dataDegraded":{"type":"boolean"},"elevatedRiskCategories":{"type":"array","items":{"type":"string"}}},"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_eGFL4o6Lqv9x_c0BUyQWl","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 historical UMA dispute rates and outcome-flip base rates on Polymarket markets, broken down by category and criterion clarity type.","exampleAgentPrompt":"What are the historical UMA dispute rates and outcome flip rates across Polymarket market categories — and which categories currently have elevated resolution risk?","exampleUseCases":[{"title":"Pre-trade resolution risk check","prompt":"Before I place a trade on a Polymarket politics market, can you pull the historical dispute rate and flip rate for that category so I know how risky the resolution process typically is?"},{"title":"Comparing subjective vs checkable criteria risk","prompt":"What's the difference in UMA dispute rates between Polymarket markets with subjective criteria versus clearly checkable ones — which type gets disputed more often?"},{"title":"Identifying high-risk market categories","prompt":"Which Polymarket market categories currently have elevated resolution risk based on historical dispute and flip base rates, and how long does lockup typically last if a market gets disputed?"}],"resultDescription":"A JSON object containing: timestamp of data freshness, overall and per-category dispute rate percentages (high-volume and chronological), flip rate percentages, average lockup hours per market and if disputed, a list of elevated-risk categories, a breakdown by criterion clarity (checkable vs subjective dispute rates), caveats about data quality, and a human-readable 'howToRead' explanation. Some fields may be null if sample sizes are insufficient.","failureModes":["Insufficient sample size for certain categories returns flipInsufficientSample or disputeInsufficientSample flags set to true rather than numeric rates","dataDegraded flag may be set true when underlying Polymarket data feeds are stale or incomplete","No query parameters accepted — any attempt to filter by specific market or date range will be silently ignored","Rate or category data may lag real-time market conditions since this reflects historical base rates, not live signals"],"whenToPreferThis":"Use this endpoint when you need historical base-rate context for UMA resolution risk on Polymarket — specifically dispute frequency and outcome flip rates by category and criterion type. Prefer this over live market endpoints when you want statistical benchmarks rather than real-time signals, or when assessing whether a market category has structural resolution risk before entering a position.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:38:09.926Z","isFirstParty":false}