Per-market Polymarket taker-flow concentration, price-band structure and book co
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.
Answeringour last check, 2026-09-24
1 of 1checks answered this week
341 msmedian answer time
$0.05listed price per call
$0.05price it asked us
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
GET https://api.polym.uk/market-authenticity/:conditionId
| Category | Market data |
|---|---|
| Provider host | api.polym.uk |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 7 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-09-24 | valid payment request | 402 | $0.05 | 341 ms |
Example input (from the provider)
{
"method": "GET",
"pathParams": {
"conditionId": "0xa3b36b2d6104d34af4e6c6215fc818e43352e78a748fbfb0b85e3a35f71dec9a"
},
"queryParams": {},
"type": "http"
}
Promised output schema (from the provider)
{
"$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",