Ranked Polymarket market-flow screener with factual concentration and liquidity-compatibil
Ranked Polymarket market-flow screener with factual concentration and liquidity-compatibility fields for the observed window. BEFORE YOU PAY: free substitute https://dash.polym.uk/markets.json. THIS ADDS: Little today, and we would rather you knew: the free snapshot has every field this route returns, for the whole decomposed set instead of the 40 rows this caps at, and it also carries the dominant-flow wallet that this route omits. Buy only if a small fixed-shape response beats completeness.
50000 (raw units)
price
6
calls / 30d
2
unique payers
2026-09-16
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",
"queryParams": {
"top": 20
},
"type": "http"
},
"output": {
"example": {
"asOf": "2026-09-01T03:42:26.765Z",
"caveats": [
"SHOWCASE, NOT THE PAID RESPONSE: what you see is one ranked row of the screener. markets is cut to 1 of the 8 rows this response carried. 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.",
"STATIC CONTRACT SAMPLE: what GET /screener?top=8 returns for the free public snapshot of 2026-09-01T03:42Z, restricted to the markets the seller's own flag reported open, then frozen. It is not current market intelligence: a live response carries its own asOf and current values, and 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."
],
"decomposed": 93,
"markets": [
{
"apparentVolumeUsd": 287740.83,
"apparentVsBookFlag": null,
"bucket": "broad",
"conditionId": "0xeef04a24987593cf21397c2ee92b8e82a58d43e2e5f7dde9bd3ebddda8377dbf",
"effectiveTraders": 11,
"marketClosed": false,
"resolution": {
"category": "Sports",
"categoryDisputeRatePct": 0.4,
"categoryFlipRatePct": 31.9,
"titleLooksUncheckable": false
},
"title": "Monterrey Open: Diane Parry vs Elise Mertens",
"topTraderShare": 0.2214
}
],
"observedMarkets": 42605,
"windowHours": 71.95
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"additionalProperties": false,
"properties": {
"top": {
"default": 20,
"maximum": 40,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"additionalProperties": false,
"properties": {
"asOf": {
"format": "date-time",
"type": "string"
},
"caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"decomposed": {
"minimum": 0,
"type": "integer"
},
"markets": {
"items": {
"additionalProperties": false,
"properties": {
"apparentVolumeUsd": {
"description": "Observed taker-side volume in the materialized window, in USD.",
"minimum": 0,
"type": "number"
},
"apparentVsBookFlag": {
"description": "Whether observed volume is structurally inconsistent with available book liquidity.",
"type": [
"boolean",
"null"
]
},
"bucket": {
"description": "Descriptive taker-flow structure bucket, not a fraud verdict.",
"enum": [
"unranked",
"structurally-thin",
"concentrated",
"moderate",
"broad"
],
"type": "string"
},
"conditionId": {
"description": "Polymarket condition ID.",
"pattern": "^0x[0-9a-fA-F]{64}$",
"type": "string"
},
"effectiveTraders": {
"description": "HHI-derived effective trader count for the observed taker flow.",
"minimum": 0,
"type": "integer"
},
"marketClosed": {
"description": "Whether the market was closed in the artifact.",
"type": [
"boolean",
"null"
]
},
"resolution": {
"additionalProperties": false,
"properties": {
"category": {
"description": "Heuristic category inferred from the market title.",
"type": "string"
},
"categoryDisputeRatePct": {
"maximum": 100,
"minimum": 0,
"type": [
"number",
"null"
]
},
"categoryFlipRatePct": {
"maximum": 100,
"minimum": 0,
"type": [
"number",
"null"
]
},
"titleLooksUncheckable": {
"description": "True when the market TITLE states no checkable threshold (price, number, score, head-to-head). Read from the title only — the resolution rules are not read.",
"type": "boolean"
}
},
"required": [
"category",
"categoryDisputeRatePct",
"categoryFlipRatePct",
"titleLooksUncheckable"
],
"type": [
"object",
"null"
]
},
"title": {
"description": "Observed Polymarket market title.",
"type": "string"
},
"topTraderShare": {
"description": "Share of observed taker volume attributed to the top trader.",
"maximum": 1,
"minimum": 0,
"type": "number"
}
},
"required": [
"conditionId",
"title",
"bucket",
"apparentVolumeUsd",
"topTraderShare",
"effectiveTraders",
"apparentVsBookFlag",
"marketClosed",
"resolution"
],
"type": "object"
},
"type": "array"
},
"observedMarkets": {
"minimum": 0,
"type": "integer"
},
"windowHours": {
"minimum": 0,
"type": "number"
}
},
"required": [
"asOf",
"windowHours",
"observedMarkets",
"decomposed",
"markets",
"caveats"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Use it
curl
curl "https://api.polym.uk/screener" # -> 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/screener");
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/screener")
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/1361.json, and this resource appears in /discovery/resources and /discovery/search.