Polymarket Intelligence API
GET api.polym.uk/screener
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
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.
Resource: api.polym.uk/screener
Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x7b13107779CfDA1bEba3289d0Fbe27310436f3E3
Payment methods: — · Last validation: 2026-09-14 16:42:08.923+00
{
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"properties": {
"top": {
"type": "integer",
"default": 20,
"maximum": 40,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"asOf",
"windowHours",
"observedMarkets",
"decomposed",
"markets",
"caveats"
],
"properties": {
"asOf": {
"type": "string",
"format": "date-time"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"markets": {
"type": "array",
"items": {
"type": "object",
"required": [
"conditionId",
"title",
"bucket",
"apparentVolumeUsd",
"topTraderShare",
"effectiveTraders",
"apparentVsBookFlag",
"marketClosed",
"resolution"
],
"properties": {
"title": {
"type": "string",
"description": "Observed Polymarket market title."
},
"bucket": {
"enum": [
"unranked",
"structurally-thin",
"concentrated",
"moderate",
"broad"
],
"type": "string",
"description": "Descriptive taker-flow structure bucket, not a fraud verdict."
},
"resolution": {
"type": [
"object",
"null"
],
"required": [
"category",
"categoryDisputeRatePct",
"categoryFlipRatePct",
"titleLooksUncheckable"
],
"properties": {
"category": {
"type": "string",
"description": "Heuristic category inferred from the market title."
},
"categoryFlipRatePct": {
"type": [
"number",
"null"
],
"maximum": 100,
"minimum": 0
},
"titleLooksUncheckable": {
"type": "boolean",
"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."
},
"categoryDisputeRatePct": {
"type": [
"number",
"null"
],
"maximum": 100,
"minimum": 0
}
},
"additionalProperties": false
},
"conditionId": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "Polymarket condition ID."
},
"marketClosed": {
"type": [
"boolean",
"null"
],
"description": "Whether the market was closed in the artifact."
},
"topTraderShare": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Share of observed taker volume attributed to the top trader."
},
"effectiveTraders": {
"type": "integer",
"minimum": 0,
"description": "HHI-derived effective trader count for the observed taker flow."
},
"apparentVolumeUsd": {
"type": "number",
"minimum": 0,
"description": "Observed taker-side volume in the materialized window, in USD."
},
"apparentVsBookFlag": {
"type": [
"boolean",
"null"
],
"description": "Whether observed volume is structurally inconsistent with available book liquidity."
}
},
"additionalProperties": false
}
},
"decomposed": {
"type": "integer",
"minimum": 0
},
"windowHours": {
"type": "number",
"minimum": 0
},
"observedMarkets": {
"type": "integer",
"minimum": 0
}
},
"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.