Polymarket Intelligence API
Resolution Watch measures, on-chain, Polymarket/UMA resolution risk: when a market is disputed, does the answer actually change? Dispute-rate and flip-rate rank categories in opposite orders. Fact/base-rate, auditor posture, machine-readable for AI agents.
TradingLiveeip155:8453Exactvia cdp
PolymarketPrediction-marketsOrder-flowMarket-analysisBase
Calls · 30d
7↓ 3.9%
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 30 snapshots so far.
$8.40
Verified settled volume
147 settlements proven x402 by their on-chain EIP-3009 marker.
$0.050
Listed price
As published in the catalog. Always read the live 402 before paying.
7
Calls · 30d
Upstream's own call count for this endpoint, not ours.
1
Unique payers · 30d
Last called 2026-09-07 10:44Z
—
Upstream on-chain volume
Reported by the source catalog.
Paid to
0x7b13107779CfDA1bEba3289d0Fbe27310436f3E3The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.
Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Provider
The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.
Live 402 challenge
Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"iconUrl": "https://polym.uk/favicon.svg",
"version": "2"
},
"payTo": "0x7b13107779CfDA1bEba3289d0Fbe27310436f3E3",
"amount": "50000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://api.polym.uk/market-authenticity/:conditionId",
"tags": [
"polymarket",
"prediction-markets",
"order-flow",
"market-analysis",
"base"
],
"iconUrl": "https://polym.uk/favicon.svg",
"mimeType": "application/json",
"description": "Per-market Polymarket taker-flow concentration, price-band and book compatibility. Never a fraud verdict. BEFORE YOU PAY: free substitute https://dash.polym.uk/markets.json. THIS ADDS: One market instead of the whole snapshot, when it is decomposed. Outside that set: 422, and no charge.",
"serviceName": "Polymarket Intelligence API"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"pathParams": {
"conditionId": ":conditionId"
},
"queryParams": {}
},
"output": {
"type": "json",
"example": {
"asOf": "2026-09-01T03:42:26.765Z",
"found": true,
"title": "Will there be no change in Fed interest rates after the September 2026 meeting?",
"bucket": "broad",
"trades": 486,
"caveats": [
"SHOWCASE, NOT THE PAID RESPONSE: what you see is one market of the covered set, and the route answers for any covered conditionId you pass. Nothing is masked or invented: every value is a dated measurement, kept so you can read the shape, the units and the field semantics. The schema published beside it is complete; a paid call returns the complete set.",
"EXAMPLE ONLY: what this route returns for one market of the free public snapshot of 2026-09-01T03:42Z, then frozen. A live response carries its own asOf and current values.",
"Coverage is partial and declared. Only markets decomposed by window volume answer with found:true; a conditionId outside that set returns 422, is not billed, and carries a note instead of metrics. GET /coverage is free and reports how many markets are decomposed right now.",
"Descriptive FACT for the observed window. Never an accusation of fraud, nor a wash or skill label.",
"apparentVolumeUsd counts executed trades, which is not the same as liquidity or open interest. It is taker-side and window-scoped, not lifetime.",
"Concentration is measured among the OBSERVED TAKERS (the tape is taker-only). effectiveTraders = 1/HHI, which exposes what distinctTraders hides.",
"onchainCounterparties is how many distinct counterparties the dominant taker traded against: a FACT, not a wash verdict. The proxy wallet is not the owner, and the graph is one hop deep.",
"betResolvedInFavor means the dominant direction coincided with the resolution. One sample; neither PnL nor evidence of skill.",
"resolutionRisk is the category BASE RATE, not a forecast for this market: dispute (how often markets like this are disputed at UMA) by flip (when disputed, how often the outcome REVERSES). On-chain fact; a small cell is directional only."
],
"priceBand": {
"subCentShare": 0,
"nearResolutionShare": 0
},
"structure": {
"spread": 0.01,
"endDate": "2026-09-16T00:00:00Z",
"bookLiquidityUsd": 751513.2288,
"orderbookEnabled": true,
"rewardsSubsidized": true,
"apparentVsBookFlag": false
},
"conditionId": "0xa3b36b2d6104d34af4e6c6215fc818e43352e78a748fbfb0b85e3a35f71dec9a",
"windowHours": 71.95,
"dominantFlow": {
"side": "BUY",
"vwap": 0.44,
"wallet": "0x7d56d84778fc6caa66f517be0ebe1df5d9f54950",
"outcome": "Yes",
"notionalUsd": 35760.11,
"sampledFills": null,
"walletMarkets": 1,
"counterpartyHhi": null,
"betResolvedInFavor": null,
"distinctCounterparties": null,
"effectiveCounterparties": null
},
"marketClosed": false,
"concentration": {
"hhi": 0.06,
"topTraderShare": 0.1425,
"distinctTraders": 349,
"effectiveTraders": 18
},
"resolutionRisk": {
"category": "Other",
"categoryElevated": false,
"categoryFlipRatePct": 13.1,
"titleLooksCheckable": false,
"categoryDisputeSample": "high-volume",
"categoryDisputeRatePct": 8.3,
"flipInsufficientSample": false,
"categoryInsufficientSample": false
},
"apparentVolumeUsd": 250883.87
}
}
},
"schema": {
"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"
},
"pathParams": {
"type": "object",
"required": [
"conditionId"
],
"properties": {
"conditionId": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "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."
}
},
"additionalProperties": false
},
"queryParams": {
"type": "object",
"properties": {},
"additionalProperties": false
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"asOf",
"windowHours",
"conditionId",
"title",
"found",
"bucket",
"marketClosed",
"apparentVolumeUsd",
"trades",
"concentration",
"priceBand",
"structure",
"dominantFlow",
"resolutionRisk",
"caveats"
],
"properties": {
"asOf": {
"type": "string",
"format": "date-time"
},
"found": {
"type": "boolean",
"const": true
},
"title": {
"type": "string"
},
"bucket": {
"enum": [
"unranked",
"structurally-thin",
"concentrated",
"moderate",
"broad"
],
"type": "string",
"description": "Descriptive taker-flow structure bucket, not a fraud verdict."
},
"trades": {
"type": "integer",
"minimum": 0
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"priceBand": {
"type": "object",
"required": [
"subCentShare",
"nearResolutionShare"
],
"properties": {
"subCentShare": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"nearResolutionShare": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"structure": {
"type": "object",
"required": [
"bookLiquidityUsd",
"spread",
"orderbookEnabled",
"rewardsSubsidized",
"apparentVsBookFlag",
"endDate"
],
"properties": {
"spread": {
"type": [
"number",
"null"
],
"minimum": 0
},
"endDate": {
"type": [
"string",
"null"
]
},
"bookLiquidityUsd": {
"type": [
"number",
"null"
],
"minimum": 0
},
"orderbookEnabled": {
"type": [
"boolean",
"null"
]
},
"rewardsSubsidized": {
"type": [
"boolean",
"null"
]
},
"apparentVsBookFlag": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
},
"conditionId": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "Polymarket condition ID."
},
"windowHours": {
"type": "number",
"minimum": 0
},
"dominantFlow": {
"type": [
"object",
"null"
],
"required": [
"wallet",
"side",
"outcome",
"vwap",
"notionalUsd",
"walletMarkets",
"distinctCounterparties",
"counterpartyHhi",
"effectiveCounterparties",
"sampledFills",
"betResolvedInFavor"
],
"properties": {
"side": {
"enum": [
"BUY",
"SELL"
],
"type": "string"
},
"vwap": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"wallet": {
"type": "string"
},
"outcome": {
"type": "string"
},
"notionalUsd": {
"type": "number",
"minimum": 0
},
"sampledFills": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"walletMarkets": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"counterpartyHhi": {
"type": [
"number",
"null"
],
"minimum": 0
},
"betResolvedInFavor": {
"type": [
"boolean",
"null"
]
},
"distinctCounterparties": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"effectiveCounterparties": {
"type": [
"integer",
"null"
],
"minimum": 0
}
},
"additionalProperties": false
},
"marketClosed": {
"type": [
"boolean",
"null"
]
},
"concentration": {
"type": "object",
"required": [
"topTraderShare",
"hhi",
"effectiveTraders",
"distinctTraders"
],
"properties": {
"hhi": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"topTraderShare": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"distinctTraders": {
"type": "integer",
"minimum": 0
},
"effectiveTraders": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"resolutionRisk": {
"type": [
"object",
"null"
],
"required": [
"category",
"categoryDisputeRatePct",
"categoryDisputeSample",
"categoryInsufficientSample",
"categoryElevated",
"titleLooksCheckable",
"categoryFlipRatePct",
"flipInsufficientSample"
],
"properties": {
"category": {
"type": "string"
},
"categoryElevated": {
"type": "boolean"
},
"categoryFlipRatePct": {
"type": [
"number",
"null"
],
"maximum": 100,
"minimum": 0
},
"titleLooksCheckable": {
"type": "boolean"
},
"categoryDisputeSample": {
"type": "string"
},
"categoryDisputeRatePct": {
"type": [
"number",
"null"
],
"maximum": 100,
"minimum": 0
},
"flipInsufficientSample": {
"type": "boolean"
},
"categoryInsufficientSample": {
"type": "boolean"
}
},
"additionalProperties": false
},
"apparentVolumeUsd": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"asOf",
"conditionId",
"found",
"note",
"caveats"
],
"properties": {
"asOf": {
"type": "string",
"format": "date-time"
},
"note": {
"type": "string"
},
"found": {
"type": "boolean",
"const": false
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"conditionId": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$"
}
},
"additionalProperties": false
}
]
}
}
}
}
},
"routeTemplate": "/market-authenticity/:conditionId"
}
},
"x402Version": 2
}Accepts
The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.
0.05USDC≈ $0.05 USD
on Base · exact scheme
Pay 0.05 USDC on Base to 0x7b13…6f3E3. The signed payment is good for 5 minutes.
- Paid to
- 0x7b13…6f3E3
- USD Coin contract
- 0x8335…02913
- Payment window
- 5 minutes
- As published
- 50000 smallest units
The catalog’s raw entry
[
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"iconUrl": "https://polym.uk/favicon.svg",
"version": "2"
},
"payTo": "0x7b13107779CfDA1bEba3289d0Fbe27310436f3E3",
"amount": "50000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
]Extensions
{
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"pathParams": {
"conditionId": "0xa3b36b2d6104d34af4e6c6215fc818e43352e78a748fbfb0b85e3a35f71dec9a"
},
"queryParams": {}
},
"output": {
"type": "json",
"example": {
"asOf": "2026-09-01T03:42:26.765Z",
"found": true,
"title": "Will there be no change in Fed interest rates after the September 2026 meeting?",
"bucket": "broad",
"trades": 486,
"caveats": [
"SHOWCASE, NOT THE PAID RESPONSE: what you see is one market of the covered set, and the route answers for any covered conditionId you pass. Nothing is masked or invented: every value is a dated measurement, kept so you can read the shape, the units and the field semantics. The schema published beside it is complete; a paid call returns the complete set.",
"EXAMPLE ONLY: what this route returns for one market of the free public snapshot of 2026-09-01T03:42Z, then frozen. A live response carries its own asOf and current values.",
"Coverage is partial and declared. Only markets decomposed by window volume answer with found:true; a conditionId outside that set returns 422, is not billed, and carries a note instead of metrics. GET /coverage is free and reports how many markets are decomposed right now.",
"Descriptive FACT for the observed window. Never an accusation of fraud, nor a wash or skill label.",
"apparentVolumeUsd counts executed trades, which is not the same as liquidity or open interest. It is taker-side and window-scoped, not lifetime.",
"Concentration is measured among the OBSERVED TAKERS (the tape is taker-only). effectiveTraders = 1/HHI, which exposes what distinctTraders hides.",
"onchainCounterparties is how many distinct counterparties the dominant taker traded against: a FACT, not a wash verdict. The proxy wallet is not the owner, and the graph is one hop deep.",
"betResolvedInFavor means the dominant direction coincided with the resolution. One sample; neither PnL nor evidence of skill.",
"resolutionRisk is the category BASE RATE, not a forecast for this market: dispute (how often markets like this are disputed at UMA) by flip (when disputed, how often the outcome REVERSES). On-chain fact; a small cell is directional only."
],
"priceBand": {
"subCentShare": 0,
"nearResolutionShare": 0
},
"structure": {
"spread": 0.01,
"endDate": "2026-09-16T00:00:00Z",
"bookLiquidityUsd": 751513.2288,
"orderbookEnabled": true,
"rewardsSubsidized": true,
"apparentVsBookFlag": false
},
"conditionId": "0xa3b36b2d6104d34af4e6c6215fc818e43352e78a748fbfb0b85e3a35f71dec9a",
"windowHours": 71.95,
"dominantFlow": {
"side": "BUY",
"vwap": 0.44,
"wallet": "0x7d56d84778fc6caa66f517be0ebe1df5d9f54950",
"outcome": "Yes",
"notionalUsd": 35760.11,
"sampledFills": null,
"walletMarkets": 1,
"counterpartyHhi": null,
"betResolvedInFavor": null,
"distinctCounterparties": null,
"effectiveCounterparties": null
},
"marketClosed": false,
"concentration": {
"hhi": 0.06,
"topTraderShare": 0.1425,
"distinctTraders": 349,
"effectiveTraders": 18
},
"resolutionRisk": {
"category": "Other",
"categoryElevated": false,
"categoryFlipRatePct": 13.1,
"titleLooksCheckable": false,
"categoryDisputeSample": "high-volume",
"categoryDisputeRatePct": 8.3,
"flipInsufficientSample": false,
"categoryInsufficientSample": false
},
"apparentVolumeUsd": 250883.87
}
}
},
"schema": {
"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"
},
"pathParams": {
"type": "object",
"required": [
"conditionId"
],
"properties": {
"conditionId": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "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."
}
},
"additionalProperties": false
},
"queryParams": {
"type": "object",
"properties": {},
"additionalProperties": false
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"asOf",
"windowHours",
"conditionId",
"title",
"found",
"bucket",
"marketClosed",
"apparentVolumeUsd",
"trades",
"concentration",
"priceBand",
"structure",
"dominantFlow",
"resolutionRisk",
"caveats"
],
"properties": {
"asOf": {
"type": "string",
"format": "date-time"
},
"found": {
"type": "boolean",
"const": true
},
"title": {
"type": "string"
},
"bucket": {
"enum": [
"unranked",
"structurally-thin",
"concentrated",
"moderate",
"broad"
],
"type": "string",
"description": "Descriptive taker-flow structure bucket, not a fraud verdict."
},
"trades": {
"type": "integer",
"minimum": 0
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"priceBand": {
"type": "object",
"required": [
"subCentShare",
"nearResolutionShare"
],
"properties": {
"subCentShare": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"nearResolutionShare": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"structure": {
"type": "object",
"required": [
"bookLiquidityUsd",
"spread",
"orderbookEnabled",
"rewardsSubsidized",
"apparentVsBookFlag",
"endDate"
],
"properties": {
"spread": {
"type": [
"number",
"null"
],
"minimum": 0
},
"endDate": {
"type": [
"string",
"null"
]
},
"bookLiquidityUsd": {
"type": [
"number",
"null"
],
"minimum": 0
},
"orderbookEnabled": {
"type": [
"boolean",
"null"
]
},
"rewardsSubsidized": {
"type": [
"boolean",
"null"
]
},
"apparentVsBookFlag": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
},
"conditionId": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "Polymarket condition ID."
},
"windowHours": {
"type": "number",
"minimum": 0
},
"dominantFlow": {
"type": [
"object",
"null"
],
"required": [
"wallet",
"side",
"outcome",
"vwap",
"notionalUsd",
"walletMarkets",
"distinctCounterparties",
"betResolvedInFavor"
],
"properties": {
"side": {
"enum": [
"BUY",
"SELL"
],
"type": "string"
},
"vwap": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"wallet": {
"type": "string"
},
"outcome": {
"type": "string"
},
"notionalUsd": {
"type": "number",
"minimum": 0
},
"sampledFills": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"walletMarkets": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"counterpartyHhi": {
"type": [
"number",
"null"
],
"minimum": 0
},
"betResolvedInFavor": {
"type": [
"boolean",
"null"
]
},
"distinctCounterparties": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"effectiveCounterparties": {
"type": [
"integer",
"null"
],
"minimum": 0
}
},
"additionalProperties": false
},
"marketClosed": {
"type": [
"boolean",
"null"
]
},
"concentration": {
"type": "object",
"required": [
"topTraderShare",
"hhi",
"effectiveTraders",
"distinctTraders"
],
"properties": {
"hhi": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"topTraderShare": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"distinctTraders": {
"type": "integer",
"minimum": 0
},
"effectiveTraders": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"resolutionRisk": {
"type": [
"object",
"null"
],
"required": [
"category",
"categoryDisputeRatePct",
"categoryDisputeSample",
"categoryInsufficientSample",
"categoryElevated",
"titleLooksCheckable",
"categoryFlipRatePct",
"flipInsufficientSample"
],
"properties": {
"category": {
"type": "string"
},
"categoryElevated": {
"type": "boolean"
},
"categoryFlipRatePct": {
"type": [
"number",
"null"
],
"maximum": 100,
"minimum": 0
},
"titleLooksCheckable": {
"type": "boolean"
},
"categoryDisputeSample": {
"type": "string"
},
"categoryDisputeRatePct": {
"type": [
"number",
"null"
],
"maximum": 100,
"minimum": 0
},
"flipInsufficientSample": {
"type": "boolean"
},
"categoryInsufficientSample": {
"type": "boolean"
}
},
"additionalProperties": false
},
"apparentVolumeUsd": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"asOf",
"conditionId",
"found",
"note",
"caveats"
],
"properties": {
"asOf": {
"type": "string",
"format": "date-time"
},
"note": {
"type": "string"
},
"found": {
"type": "boolean",
"const": false
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"conditionId": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$"
}
},
"additionalProperties": false
}
]
}
}
}
}
},
"routeTemplate": "/market-authenticity/:conditionId"
}
}Provenance
- Seen in the source catalog
- 2026-09-07 10:44Z
- Last indexed by Roundhouse
- 2026-09-24 23:30Z
- Last enriched (probe, favicon, geo)
- 2026-09-21 05:46Z
- x402 version
- 2
- Max timeout
- 300s
- Liveness probe
- HTTP 402
Hand this page to an agent
Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.
GET api.roundhouseai.io/v0/endpoints
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 30 snapshots so far. Verified volume counts only settlements with an on-chain EIP-3009 marker.
Show the promptHide the prompt
Using Roundhouse, look up the x402 service Polymarket Intelligence API and tell me whether it is worth paying: what a call costs, whether the endpoint answered when last probed, and what its payment record actually shows. curl -s 'https://api.roundhouseai.io/v0/endpoints?q=Polymarket%20Intelligence%20API' curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>' Then call it: read the price from the live 402 at https://api.polym.uk/market-authenticity/:conditionId, never from a cached figure, and pay with an x402 client. The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except /v0/unified* and /v0/endpoints. Mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402, or use an organization key from https://roundhouseai.io/dashboard/team. If you do not have Roundhouse tools or skills installed, read https://roundhouseai.io/skill.md first — it is the whole procedure.