{"uid":"cap_StdrhzKkbsXCmERoSY1c2","slug":"polymarket-market-authenticity-taker-flow-analysis-ef46208b","name":"Polymarket Market Authenticity & Taker-Flow Analysis","description":"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.","url":"https://api.polym.uk/market-authenticity/:conditionId","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"},"pathParams":{"type":"object","required":["conditionId"],"properties":{"conditionId":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","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."}},"additionalProperties":false},"queryParams":{"type":"object","properties":{},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","oneOf":[{"type":"object","required":["asOf","windowHours","conditionId","title","found","bucket","marketClosed","apparentVolumeUsd","trades","concentration","priceBand","structure","dominantFlow","resolutionRisk","caveats"],"properties":{"asOf":{"type":"string","format":"date-time"},"found":{"type":"boolean","const":true},"title":{"type":"string"},"bucket":{"enum":["unranked","structurally-thin","concentrated","moderate","broad"],"type":"string","description":"Descriptive taker-flow structure bucket, not a fraud verdict."},"trades":{"type":"integer","minimum":0},"caveats":{"type":"array","items":{"type":"string"}},"priceBand":{"type":"object","required":["subCentShare","nearResolutionShare"],"properties":{"subCentShare":{"type":"number","maximum":1,"minimum":0},"nearResolutionShare":{"type":"number","maximum":1,"minimum":0}},"additionalProperties":false},"structure":{"type":"object","required":["bookLiquidityUsd","spread","orderbookEnabled","rewardsSubsidized","apparentVsBookFlag","endDate"],"properties":{"spread":{"type":["number","null"],"minimum":0},"endDate":{"type":["string","null"]},"bookLiquidityUsd":{"type":["number","null"],"minimum":0},"orderbookEnabled":{"type":["boolean","null"]},"rewardsSubsidized":{"type":["boolean","null"]},"apparentVsBookFlag":{"type":["boolean","null"]}},"additionalProperties":false},"conditionId":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"Polymarket condition ID."},"windowHours":{"type":"number","minimum":0},"dominantFlow":{"type":["object","null"],"required":["wallet","side","outcome","vwap","notionalUsd","walletMarkets","distinctCounterparties","counterpartyHhi","effectiveCounterparties","sampledFills","betResolvedInFavor"],"properties":{"side":{"enum":["BUY","SELL"],"type":"string"},"vwap":{"type":"number","maximum":1,"minimum":0},"wallet":{"type":"string"},"outcome":{"type":"string"},"notionalUsd":{"type":"number","minimum":0},"sampledFills":{"type":["integer","null"],"minimum":0},"walletMarkets":{"type":["integer","null"],"minimum":0},"counterpartyHhi":{"type":["number","null"],"minimum":0},"betResolvedInFavor":{"type":["boolean","null"]},"distinctCounterparties":{"type":["integer","null"],"minimum":0},"effectiveCounterparties":{"type":["integer","null"],"minimum":0}},"additionalProperties":false},"marketClosed":{"type":["boolean","null"]},"concentration":{"type":"object","required":["topTraderShare","hhi","effectiveTraders","distinctTraders"],"properties":{"hhi":{"type":"number","maximum":1,"minimum":0},"topTraderShare":{"type":"number","maximum":1,"minimum":0},"distinctTraders":{"type":"integer","minimum":0},"effectiveTraders":{"type":"integer","minimum":0}},"additionalProperties":false},"resolutionRisk":{"type":["object","null"],"required":["category","categoryDisputeRatePct","categoryDisputeSample","categoryInsufficientSample","categoryElevated","titleLooksCheckable","categoryFlipRatePct","flipInsufficientSample"],"properties":{"category":{"type":"string"},"categoryElevated":{"type":"boolean"},"categoryFlipRatePct":{"type":["number","null"],"maximum":100,"minimum":0},"titleLooksCheckable":{"type":"boolean"},"categoryDisputeSample":{"type":"string"},"categoryDisputeRatePct":{"type":["number","null"],"maximum":100,"minimum":0},"flipInsufficientSample":{"type":"boolean"},"categoryInsufficientSample":{"type":"boolean"}},"additionalProperties":false},"apparentVolumeUsd":{"type":"number","minimum":0}},"additionalProperties":false},{"type":"object","required":["asOf","conditionId","found","note","caveats"],"properties":{"asOf":{"type":"string","format":"date-time"},"note":{"type":"string"},"found":{"type":"boolean","const":false},"caveats":{"type":"array","items":{"type":"string"}},"conditionId":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},"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_S5VyRdwSUn4Q0YVwK-TMQ","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 per-market taker-flow concentration, price-band structure, order book compatibility metrics, and resolution base-rate context for a given Polymarket condition ID.","exampleAgentPrompt":"Pull the taker-flow concentration, price-band structure, and resolution base-rate context for Polymarket condition ID 0xabc123 so I can evaluate whether this market looks structurally sound before placing a trade.","exampleUseCases":[{"title":"Pre-trade market structure check","prompt":"Before I trade on this Polymarket market — condition ID 0xdef456 — can you pull the taker-flow concentration and book compatibility metrics so I know if the market looks structurally healthy?"},{"title":"Resolution base-rate research","prompt":"I'm researching Polymarket markets in the politics category. Can you get me the resolution base-rate context and price-band structure for condition ID 0x789abc?"},{"title":"Automated market screening alert","prompt":"For my trading bot, check condition ID 0x123def on Polymarket and give me the taker-flow concentration score and book compatibility data so I can decide whether to include it in my watchlist."}],"resultDescription":"A JSON object containing factual per-market signals including taker-flow concentration metrics, price-band structure breakdown, order book compatibility scores, and historical resolution base-rate context for the specified Polymarket condition. No fraud verdict or predictive signal is included — output is purely descriptive and structural.","failureModes":["Invalid or unknown conditionId returns a 404 or empty result","Condition ID referencing a market with insufficient trade history may return sparse or null concentration fields","Network timeouts if Polymarket data feed is temporarily unavailable","Malformed conditionId format may return a 400 validation error"],"whenToPreferThis":"Use this endpoint when you need factual, structural microstructure data for a specific Polymarket market — particularly taker-flow concentration and book compatibility — rather than a subjective fraud verdict or directional price prediction. Prefer this over general prediction market APIs when you need resolution base-rate context grounded in historical UMA resolution patterns specific to Polymarket.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:39:40.300Z","isFirstParty":false}