Per-market Polymarket taker-flow concentration, price-band structure and book compatibilit
Per-market Polymarket taker-flow concentration, price-band structure and book compatibility. Facts, never a fraud verdict. BEFORE YOU PAY: free substitute https://dash.polym.uk/markets.json. THIS ADDS: A single-market lookup instead of the whole snapshot, for a decomposed market. Outside that set: 422, and no charge.
50000 (raw units)
price
7
calls / 30d
1
unique payers
2026-09-07
updated
Provider
api.polym.uk · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x7b13107779CfDA1bEba3289d0Fbe27310436f3E3",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "50000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"method": "GET",
"pathParams": {
"conditionId": "0xa3b36b2d6104d34af4e6c6215fc818e43352e78a748fbfb0b85e3a35f71dec9a"
},
"queryParams": {},
"type": "http"
},
"output": {
"example": {
"apparentVolumeUsd": 250883.87,
"asOf": "2026-09-01T03:42:26.765Z",
"bucket": "broad",
"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."
],
"concentration": {
"distinctTraders": 349,
"effectiveTraders": 18,
"hhi": 0.06,
"topTraderShare": 0.1425
},
"conditionId": "0xa3b36b2d6104d34af4e6c6215fc818e43352e78a748fbfb0b85e3a35f71dec9a",
"dominantFlow": {
"betResolvedInFavor": null,
"counterpartyHhi": null,
"distinctCounterparties": null,
"effectiveCounterparties": null,
"notionalUsd": 35760.11,
"outcome": "Yes",
"sampledFills": null,
"side": "BUY",
"vwap": 0.44,
"wallet": "0x7d56d84778fc6caa66f517be0ebe1df5d9f54950",
"walletMarkets": 1
},
"found": true,
"marketClosed": false,
"priceBand": {
"nearResolutionShare": 0,
"subCentShare": 0
},
"resolutionRisk": {
"category": "Other",
"categoryDisputeRatePct": 8.3,
"categoryDisputeSample": "high-volume",
"categoryElevated": false,
"categoryFlipRatePct": 13.1,
"categoryInsufficientSample": false,
"flipInsufficientSample": false,
"titleLooksCheckable": false
},
"structure": {
"apparentVsBookFlag": false,
"bookLiquidityUsd": 751513.2288,
"endDate": "2026-09-16T00:00:00Z",
"orderbookEnabled": true,
"rewardsSubsidized": true,
"spread": 0.01
},
"title": "Will there be no change in Fed interest rates after the September 2026 meeting?",
"trades": 486,
"windowHours": 71.95
},
"type": "json"
}
},
"routeTemplate": "/market-authenticity/:conditionId",
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"pathParams": {
"additionalProperties": false,
"properties": {
"conditionId": {
"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.",
"pattern": "^0x[0-9a-fA-F]{64}$",
"type": "string"
}
},
"required": [
"conditionId"
],
"type": "object"
},
"queryParams": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"apparentVolumeUsd": {
"minimum": 0,
"type": "number"
},
"asOf": {
"format": "date-time",
"type": "string"
},
"bucket": {
"description": "Descriptive taker-flow structure bucket, not a fraud verdict.",
"enum": [
"unranked",
"structurally-thin",
"concentrated",
"moderate",
"broad"
],
"type": "string"
},
"caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"concentration": {
"additionalProperties": false,
"properties": {
"distinctTraders": {
"minimum": 0,
"type": "integer"
},
"effectiveTraders": {
"minimum": 0,
"type": "integer"
},
"hhi": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"topTraderShare": {
"maximum": 1,
"minimum": 0,
"type": "number"
}
},
"required": [
"topTraderShare",
"hhi",
"effectiveTraders",
"distinctTraders"
],
"type": "object"
},
"conditionId": {
"description": "Polymarket condition ID.",
"pattern": "^0x[0-9a-fA-F]{64}$",
"type": "string"
},
"dominantFlow": {
"additionalProperties": false,
"properties": {
"betResolvedInFavor": {
"type": [
"boolean",
"null"
]
},
"counterpartyHhi": {
"minimum": 0,
"type": [
"number",
"null"
]
},
"distinctCounterparties": {
"minimum": 0,
"type": [
"integer",
"null"
]
},
"effectiveCounterparties": {
"minimum": 0,
"type": [
"integer",
"null"
]
},
"notionalUsd": {
"minimum": 0,
"type": "number"
},
"outcome": {
"type": "string"
},
"sampledFills": {
"minimum": 0,
"type": [
"integer",
"null"
]
},
"side": {
"enum": [
"BUY",
"SELL"
],
"type": "string"
},
"vwap": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"wallet": {
"type": "string"
},
"walletMarkets": {
"minimum": 0,
"type": [
"integer",
"null"
]
}
},
"required": [
"wallet",
"side",
"outcome",
"vwap",
"notionalUsd",
"walletMarkets",
"distinctCounterparties",
"betResolvedInFavor"
],
"type": [
"object",
"null"
]
},
"found": {
"const": true,
"type": "boolean"
},
"marketClosed": {
"type": [
"boolean",
"null"
]
},
"priceBand": {
"additionalProperties": false,
"properties": {
"nearResolutionShare": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"subCentShare": {
"maximum": 1,
"minimum": 0,
"type": "number"
}
},
"required": [
"subCentShare",
"nearResolutionShare"
],
"type": "object"
},
"resolutionRisk": {
"additionalProperties": false,
"properties": {
"category": {
"type": "string"
},
"categoryDisputeRatePct": {
"maximum": 100,
"minimum": 0,
"type": [
"number",
"null"
]
},
"categoryDisputeSample": {
"type": "string"
},
"categoryElevated": {
"type": "boolean"
},
"categoryFlipRatePct": {
"maximum": 100,
"minimum": 0,
"type": [
"number",
"null"
]
},
"categoryInsufficientSample": {
"type": "boolean"
},
"flipInsufficientSample": {
"type": "boolean"
},
"titleLooksCheckable": {
"type": "boolean"
}
},
"required": [
"category",
"categoryDisputeRatePct",
"categoryDisputeSample",
"categoryInsufficientSample",
"categoryElevated",
"titleLooksCheckable",
"categoryFlipRatePct",
"flipInsufficientSample"
],
"type": [
"object",
"null"
]
},
"structure": {
"additionalProperties": false,
"properties": {
"apparentVsBookFlag": {
"type": [
"boolean",
"null"
]
},
"bookLiquidityUsd": {
"minimum": 0,
"type": [
"number",
"null"
]
},
"endDate": {
"type": [
"string",
"null"
]
},
"orderbookEnabled": {
"type": [
"boolean",
"null"
]
},
"rewardsSubsidized": {
"type": [
"boolean",
"null"
]
},
"spread": {
"minimum": 0,
"type": [
"number",
"null"
]
}
},
"required": [
"bookLiquidityUsd",
"spread",
"orderbookEnabled",
"rewardsSubsidized",
"apparentVsBookFlag",
"endDate"
],
"type": "object"
},
"title": {
"type": "string"
},
"trades": {
"minimum": 0,
"type": "integer"
},
"windowHours": {
"minimum": 0,
"type": "number"
}
},
"required": [
"asOf",
"windowHours",
"conditionId",
"title",
"found",
"bucket",
"marketClosed",
"apparentVolumeUsd",
"trades",
"concentration",
"priceBand",
"structure",
"dominantFlow",
"resolutionRisk",
"caveats"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"asOf": {
"format": "date-time",
"type": "string"
},
"caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"conditionId": {
"pattern": "^0x[0-9a-fA-F]{64}$",
"type": "string"
},
"found": {
"const": false,
"type": "boolean"
},
"note": {
"type": "string"
}
},
"required": [
"asOf",
"conditionId",
"found",
"note",
"caveats"
],
"type": "object"
}
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Use it
curl
curl "https://api.polym.uk/market-authenticity/:conditionId" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://api.polym.uk/market-authenticity/:conditionId");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://api.polym.uk/market-authenticity/:conditionId")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/1362.json, and this resource appears in /discovery/resources and /discovery/search.