Polymarket Intelligence API
GET api.polym.uk/market-authenticity/:conditionId
Why an agent can trust this route.
Sonar evidence is advisory. Paid delivery is shown as verified only when paid probes are available; otherwise route estimates use the unpaid handshake as a clearly labeled proxy.
Observed outcomes
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.
Resource: api.polym.uk/market-authenticity/:conditionId
Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x7b13107779CfDA1bEba3289d0Fbe27310436f3E3
Payment methods: — · Last validation: 2026-09-14 16:41:58.845+00
{
"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
}
]
}
}
},
"paymentRequirements": [
{
"raw": {
"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
},
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0x7b13107779CfDA1bEba3289d0Fbe27310436f3E3",
"scheme": "exact",
"network": "eip155:8453",
"amountAtomic": "50000"
}
]
}Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.