{"slug":"api-polym-uk-market-authenticity-conditionid-a05d85","title":"Per-market Polymarket taker-flow concentration, price-band structure and book co","host":"api.polym.uk","method":"GET","resource":"https://api.polym.uk/market-authenticity/:conditionId","category":"market","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: 4","price_listed":0.05,"price_asked":0.05,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":341,"reported_calls_30d":7,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","pathParams":{"conditionId":"0xa3b36b2d6104d34af4e6c6215fc818e43352e78a748fbfb0b85e3a35f71dec9a"},"queryParams":{},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"pathParams":{"additionalProperties":false,"properties":{"conditionId":{"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.","pattern":"^0x[0-9a-fA-F]{64}$","type":"string"}},"required":["conditionId"],"type":"object"},"queryParams":{"additionalProperties":false,"properties":{},"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"oneOf":[{"additionalProperties":false,"properties":{"apparentVolumeUsd":{"minimum":0,"type":"number"},"asOf":{"format":"date-time","type":"string"},"bucket":{"description":"Descriptive taker-flow structure bucket, not a fraud verdict.","enum":["unranked","structurally-thin","concentrated","moderate","broad"],"type":"string"},"caveats":{"items":{"type":"string"},"type":"array"},"concentration":{"additionalProperties":false,"properties":{"distinctTraders":{"minimum":0,"type":"integer"},"effectiveTraders":{"minimum":0,"type":"integer"},"hhi":{"maximum":1,"minimum":0,"type":"number"},"topTraderShare":{"maximum":1,"minimum":0,"type":"number"}},"required":["topTraderShare","hhi","effectiveTraders","distinctTraders"],"type":"object"},"conditionId":{"description":"Polymarket condition ID.","pattern":"^0x[0-9a-fA-F]{64}$","type":"string"},"dominantFlow":{"additionalProperties":false,"properties":{"betResolvedInFavor":{"type":["boolean","null"]},"counterpartyHhi":{"minimum":0,"type":["number","null"]},"distinctCounterparties":{"minimum":0,"type":["integer","null"]},"effectiveCounterparties":{"minimum":0,"type":["integer","null"]},"notionalUsd":{"minimum":0,"type":"number"},"outcome":{"type":"string"},"sampledFills":{"minimum":0,"type":["integer","null"]},"side":{"enum":["BUY","SELL"],"type":"string"},"vwap":{"maximum":1,"minimum":0,"type":"number"},"wallet":{"type":"string"},"walletMarkets":{"minimum":0,"type":["integer","null"]}},"required":["wallet","side","outcome","vwap","notionalUsd","walletMarkets","distinctCounterparties","betResolvedInFavor"],"type":["object","null"]},"found":{"const":true,"type":"boolean"},"marketClosed":{"type":["boolean","null"]},"priceBand":{"additionalProperties":false,"properties":{"nearResolutionShare":{"maximum":1,"minimum":0,"type":"number"},"subCentShare":{"maximum":1,"minimum":0,"type":"number"}},"required":["subCentShare","nearResolutionShare"],"type":"object"},"resolutionRisk":{"additionalProperties":false,"properties":{"category":{"type":"string"},"categoryDisputeRatePct":{"maximum":100,"minimum":0,"type":["number","null"]},"categoryDisputeSample":{"type":"string"},"categoryElevated":{"type":"boolean"},"categoryFlipRatePct":{"maximum":100,"minimum":0,"type":["number","null"]},"categoryInsufficientSample":{"type":"boolean"},"flipInsufficientSample":{"type":"boolean"},"titleLooksCheckable":{"type":"boolean"}},"required":["category","categoryDisputeRatePct","categoryDisputeSample","categoryInsufficientSample","categoryElevated","titleLooksCheckable","categoryFlipRatePct","flipInsufficientSample"],"type":["object","null"]},"structure":{"additionalProperties":false,"properties":{"apparentVsBookFlag":{"type":["boolean","null"]},"bookLiquidityUsd":{"minimum":0,"type":["number","null"]},"endDate":{"type":["string","null"]},"orderbookEnabled":{"type":["boolean","null"]},"rewardsSubsidized":{"type":["boolean","null"]},"spread":{"minimum":0,"type":["number","null"]}},"required":["bookLiquidityUsd","spread","orderbookEnabled","rewardsSubsidized","apparentVsBookFlag","endDate"],"type":"object"},"title":{"type":"string"},"trades":{"minimum":0,"type":"integer"},"windowHours":{"minimum":0,"type":"number"}},"required":["asOf","windowHours","conditionId","title","found","bucket","marketClosed","apparentVolumeUsd","trades","concentration","priceBand","structure","dominantFlow","resolutionRisk","caveats"],"type":"object"},{"additionalProperties":false,"properties":{"asOf":{"format":"date-time","type":"string"},"caveats":{"items":{"type":"string"},"type":"array"},"conditionId":{"pattern":"^0x[0-9a-fA-F]{64}$","type":"string"},"found":{"const":false,"type":"boolean"},"note":{"type":"string"}},"required":["asOf","conditionId","found","note","caveats"],"type":"object"}],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.05,"price_match":true,"latency_ms":341,"error":null}],"description_full":"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.","last_updated":"2026-09-07T10:44:25.179Z","schemes":["exact"]}