{"service":"Polymarket Intelligence API","summary":"Factual Polymarket market-flow structure and UMA resolution base rates for machine consumers. Descriptive, dated, window-bounded evidence — never a fraud allegation and never a market-specific forecast.","beforeYouPay":"Read this first. Most of what these paid routes return is also published for free. The full current snapshot of the decomposed markets — every field, including the dominant-flow wallet this API omits — is a plain GET on https://dash.polym.uk/markets.json, and the UMA base rates and flip rates are free files too. Each paid route below declares its free substitute and exactly what it adds. Fetch the free files first and pay only for the difference.","payment":{"protocol":"x402","priceDecimal":"$0.05","priceAtomic":"50000","asset":{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"network":{"symbolic":"base","caip2":"eip155:8453"},"payTo":"0x7b13107779CfDA1bEba3289d0Fbe27310436f3E3","billing":"Any response with status 400 or above cancels settlement, so you are not charged for a market we do not cover (422), for malformed input (400), or for an unavailable artifact (503). You are charged only for a 200."},"freshness":"Each response carries its own asOf. The market-flow window is materialised continuously and is typically minutes old; the UMA scans run about once a day. https://api.polym.uk/coverage publishes, free, what is measured right now and with what sample sizes — check it before you pay if freshness matters to your decision.","free":[{"url":"https://dash.polym.uk/calibration.json","what":"is Polymarket calibrated? the YES price 24h before close against the realised outcome, as a ten-bucket curve with a 95% Wilson interval per bucket, plus the Brier score and the favourite-longshot gap. It answers the question behind every other number here: can the price be read as a probability?"},{"url":"https://dash.polym.uk/markets.json","what":"the complete current snapshot the dashboard reads"},{"url":"https://dash.polym.uk/uma-base-rates.json","what":"UMA dispute base rates by category, both samples"},{"url":"https://dash.polym.uk/uma-flip-rate.json","what":"how often a disputed answer reversed, on-chain"},{"url":"https://dash.polym.uk/live-disputes.json","what":"recent UMA disputes with the category flip rate and its 95% CI"},{"url":"https://dash.polym.uk/market-series.json","what":"the hourly per-market series behind the sparklines"},{"url":"https://dash.polym.uk/llms.txt","what":"how to read the published artifacts, and their caveats"},{"url":"https://api.polym.uk/coverage","what":"what is and is not measured right now, with sample sizes"},{"url":"https://api.polym.uk/samples/screener","what":"a static example of the screener response shape"},{"url":"https://api.polym.uk/openapi.json","what":"the full OpenAPI document: schemas, examples, routes"},{"url":"https://api.polym.uk/.well-known/x402","what":"payable-resource discovery"},{"url":"https://api.polym.uk/health","what":"liveness and the running release id"}],"paid":[{"method":"GET","path":"/market-authenticity/{conditionId}","url":"https://api.polym.uk/market-authenticity/{conditionId}","price":"$0.05 USDC on base","description":"Factual per-market Polymarket taker-flow concentration, price-band structure, book compatibility and resolution base-rate context; never a fraud verdict or prediction.","freeSubstitute":"https://dash.polym.uk/markets.json","residual":"A single-market lookup instead of downloading the whole snapshot, when the market is one of the decomposed. It cannot answer for a market outside that set — and it returns 422 rather than charging you for the miss.","limits":"A market is covered only while it is in the observed window, so any single example ages. Take a covered markets[].conditionId from the free snapshot at https://dash.polym.uk/markets.json, or call GET /coverage (free) for how many markets are decomposed right now. A conditionId outside the covered set returns 422 and is not billed. Coverage when this document was built: 95 markets decomposed out of 34,528 observed. https://api.polym.uk/coverage is free and reports it live.","exampleRequest":"https://api.polym.uk/market-authenticity/0xa3b36b2d6104d34af4e6c6215fc818e43352e78a748fbfb0b85e3a35f71dec9a"},{"method":"GET","path":"/screener","url":"https://api.polym.uk/screener","price":"$0.05 USDC on base","description":"Ranked Polymarket market-flow screener with factual concentration and liquidity-compatibility fields for the observed window.","freeSubstitute":"https://dash.polym.uk/markets.json","residual":"Little today, and we would rather you knew: the free snapshot contains every field this route returns, for the whole decomposed set instead of the 40 rows this route caps at, and it also carries the dominant-flow wallet address, which this route omits. Buy this only if a small, fixed-shape response matters more to you than completeness.","limits":"top is an integer from 1 to 40; no cursor. Coverage when this document was built: 95 markets decomposed out of 34,528 observed. https://api.polym.uk/coverage is free and reports it live.","exampleRequest":null},{"method":"GET","path":"/resolution-risk","url":"https://api.polym.uk/resolution-risk","price":"$0.05 USDC on base","description":"UMA resolution dispute and flip base rates by category and criterion clarity; descriptive historical compatibility, not a market-specific forecast.","freeSubstitute":"https://dash.polym.uk/uma-base-rates.json and https://dash.polym.uk/uma-flip-rate.json","residual":"The two artifacts joined into one response, with the dispute axis and the flip axis already aligned by category. The underlying numbers are the same ones published in those two free files.","limits":"Six categories; both samples are published because they disagree by roughly an order of magnitude.","exampleRequest":null},{"method":"GET","path":"/resolution-watchlist","url":"https://api.polym.uk/resolution-watchlist","price":"$0.05 USDC on base","description":"Live Polymarket watchlist ranked by structural UMA resolution base-rate signals, with flip risk kept as a separate conditional axis.","freeSubstitute":"https://dash.polym.uk/markets.json and https://dash.polym.uk/uma-base-rates.json","residual":"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.","limits":"top is an integer from 1 to 40; live markets only; no cursor.","exampleRequest":null}],"notAClaim":["A dispute is a fact of the UMA process, not fraud.","Flow concentration is a fact about the observed window, not a wash-trading verdict.","A base rate describes a population, and is never a forecast about one market.","An unavailable measurement is reported as unavailable, never as zero."]}