{"uid":"cap_UXVbzxPxCTZ9vH03boRUt","slug":"polymarket-market-flow-screener-4d6a7812","name":"Polymarket Market-Flow Screener","description":"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.","url":"https://api.polym.uk/screener","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"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}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ia2nTV8nBaD8SlnEhxwhF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked list of Polymarket prediction markets screened by taker-flow structure, factual concentration, trader breadth, and liquidity compatibility for a recent observation window.","exampleAgentPrompt":"Show me the top 30 Polymarket markets screened by taker-flow structure — I want to see which ones are broad vs concentrated, their apparent volume, effective trader counts, and any resolution subjectivity flags.","exampleUseCases":null,"resultDescription":"Returns a JSON object with: timestamp and observation window hours, a ranked array of up to N markets each containing conditionId, title, flow bucket (broad/moderate/concentrated/structurally-thin/unranked), apparent volume in USD, top trader share, effective trader count, apparent-vs-book flag, market closed status, and a resolution object with heuristic category, dispute rate, flip rate, and subjectivity flag. Also includes a decomposed summary and a caveats array explaining data limitations.","failureModes":["top parameter out of range (1–40) returns validation error","payment not provided or insufficient results in 402 Payment Required","upstream Polymarket data unavailable causes partial or stale results indicated in caveats","network timeout if Polymarket API is slow","market data artifact may be cached; asOf timestamp indicates freshness"],"whenToPreferThis":"Use this endpoint when you need a quick ranked snapshot of Polymarket market health, flow concentration, and trader breadth across multiple markets simultaneously. Prefer it over manual Polymarket browsing when you want structured, machine-readable flow-quality signals (bucket classification, effective trader count, top-trader share) for downstream filtering or alerting. It is especially useful for agents that need to identify which prediction markets are safe to trade or analyze based on liquidity and participation structure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:35:49.628Z","isFirstParty":false}