Polymarket Intelligence API
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.
Offering
- Provider
- api.polym.uk
- Method
- GET
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Prediction Markets
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://api.polym.uk/screener- MIME type
- application/json
- First seen
- 2026-10-16T01:50:14.534Z
- Last seen
- Tags
- polymarket, prediction-markets, screener, order-flow, Base
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.05 USDC
Atomic price: 50000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "50000",
"payTo": "0x7b13107779CfDA1bEba3289d0Fbe27310436f3E3"
}
]Observed health
- Status
- Healthy
- Latest latency
- 1231 ms
- Average latency
- 857 ms
- HTTP status
- 402
- Last checked
- Reachability
- 100% over 14 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"type": "string",
"enum": [
"GET"
]
},
"queryParams": {
"type": "object",
"properties": {
"top": {
"type": "integer",
"minimum": 1,
"maximum": 40,
"default": 20
}
},
"additionalProperties": false
}
},
"required": [
"type",
"method"
],
"additionalProperties": false
}Output schema
{
"type": "object",
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"additionalProperties": false,
"required": [
"asOf",
"windowHours",
"observedMarkets",
"decomposed",
"markets",
"caveats"
],
"properties": {
"asOf": {
"type": "string",
"format": "date-time"
},
"windowHours": {
"type": "number",
"minimum": 0
},
"observedMarkets": {
"type": "integer",
"minimum": 0
},
"decomposed": {
"type": "integer",
"minimum": 0
},
"markets": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"conditionId",
"title",
"bucket",
"apparentVolumeUsd",
"topTraderShare",
"effectiveTraders",
"apparentVsBookFlag",
"marketClosed",
"resolution"
],
"properties": {
"conditionId": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "Polymarket condition ID."
},
"title": {
"type": "string",
"description": "Observed Polymarket market title."
},
"bucket": {
"type": "string",
"enum": [
"unranked",
"structurally-thin",
"concentrated",
"moderate",
"broad"
],
"description": "Descriptive taker-flow structure bucket, not a fraud verdict."
},
"apparentVolumeUsd": {
"type": "number",
"minimum": 0,
"description": "Observed taker-side volume in the materialized window, in USD."
},
"topTraderShare": {
"type": "number",
"minimum": 0,
"maximum": 1,
"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."
},
"apparentVsBookFlag": {
"type": [
"boolean",
"null"
],
"description": "Whether observed volume is structurally inconsistent with available book liquidity."
},
"marketClosed": {
"type": [
"boolean",
"null"
],
"description": "Whether the market was closed in the artifact."
},
"resolution": {
"type": [
"object",
"null"
],
"additionalProperties": false,
"required": [
"category",
"categoryDisputeRatePct",
"categoryFlipRatePct",
"titleLooksUncheckable"
],
"properties": {
"category": {
"type": "string",
"description": "Heuristic category inferred from the market title."
},
"categoryDisputeRatePct": {
"type": [
"number",
"null"
],
"minimum": 0,
"maximum": 100
},
"categoryFlipRatePct": {
"type": [
"number",
"null"
],
"minimum": 0,
"maximum": 100
},
"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."
}
}
}
}
}
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"type"
]
}