{"uid":"cap_JEuITcz4_NBJ5X86D0FX1","slug":"api-dripmetrics-ai-374fd031","name":"DripMetrics Polymarket VPIN Flow-Toxicity Scorer","description":"DripMetricsAI (https://dripmetrics.ai/) provides on-demand crypto market microstructure metrics, Hyperliquid candle metrics, Polymarket diagnostics, and on-chain DefiLlama metrics for agents, dashboards, and trading workflows.","url":"https://api.dripmetrics.ai/polymarket/vpin","method":"POST","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":["POST"],"type":"string"},"queryParams":{"type":"object","anyOf":[{"required":["conditionId"]},{"required":["slug"]}],"required":[],"properties":{"slug":{"type":"string","description":"Polymarket market or event slug for human-readable market selection. Multi-market event slugs may require conditionId to disambiguate."},"endTs":{"type":"integer","description":"Optional unix timestamp upper bound."},"limit":{"type":"integer","maximum":5000,"minimum":1,"description":"Maximum number of trades to evaluate."},"newsTs":{"type":"integer","description":"Optional explicit event timestamp for leakage scoring. If omitted, the metric uses the midpoint of the effective analysis window."},"assetId":{"type":"string","description":"Alias for tokenId on price-history-based endpoints."},"outcome":{"enum":["YES","NO"],"type":"string","description":"Required for token-side Polymarket diagnostics when the selected YES or NO side must be interpreted."},"startTs":{"type":"integer","description":"Optional unix timestamp lower bound."},"tokenId":{"type":"string","description":"Polymarket token / asset ID for orderbook and price-history endpoints."},"conditionId":{"type":"string","description":"Polymarket condition ID for trade-based metrics."},"windowMinutes":{"type":"integer","minimum":1,"description":"Lookback window in minutes."},"lookbackMinutes":{"type":"integer","minimum":1,"description":"Historical lookback used for probability shock normalization."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["metric","window","value","components","sampleSize","source","computedAt"],"properties":{"slug":{"type":"string"},"value":{"type":["number","null"]},"metric":{"type":"string"},"source":{"type":"object"},"window":{"type":"object"},"assetId":{"type":"string"},"outcome":{"type":"string"},"tokenId":{"type":"string"},"components":{"type":"object"},"computedAt":{"type":"string","format":"date-time"},"sampleSize":{"type":"object"},"conditionId":{"type":"string"}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"slug":"fed-decision-in-october","value":0.92349,"metric":"vpin","source":{"market":"https://gamma-api.polymarket.com/markets/slug/fed-decision-in-october","trades":"https://data-api.polymarket.com/trades"},"window":{"windowMinutes":60},"components":{"note":"Polymarket VPIN-style score using equal-notional buckets of inferred YES/NO pressure.","vpin":0.92349,"buckets":10,"bucketSize":14.9,"tradeCount":4,"totalVolume":149,"meanImbalance":13.76,"configuredBuckets":10},"computedAt":"2026-05-25T14:00:00.000Z","sampleSize":{"trades":4,"scannedTrades":4},"conditionId":"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":100,"conditionId":"0x1234567890abcdef1234567890abcdef","windowMinutes":60}}},"response":{"value":0.718124,"metric":"vpin","source":{"trades":"https://data-api.polymarket.com/trades"},"window":{"endTs":1781760173624,"startTs":1781756573624,"windowMinutes":60},"components":{"note":"Polymarket VPIN-style score using equal-notional buckets of inferred YES/NO pressure.","vpin":0.718124,"buckets":10,"bucketSize":429.796435,"tradeCount":55,"totalVolume":4297.964345,"coverageNote":"Trade scan did not reach the full requested lookback; results use the newest API-visible trades within the scan limit.","meanImbalance":308.646931,"skippedTrades":45,"configuredBuckets":10},"computedAt":"2026-06-18T05:22:53.784Z","sampleSize":{"trades":55,"scannedTrades":100},"conditionId":"0x1234567890abcdef1234567890abcdef"}},"exampleRequest":{"limit":100,"conditionId":"0x1234567890abcdef1234567890abcdef","windowMinutes":60},"tags":["x402"],"displayCostAmount":"0.050000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.050000/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_kcKJoVuW__zkpRvfKNBdE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes a VPIN (Volume-synchronized Probability of Informed Trading) flow-toxicity score for a Polymarket prediction market by bucketing YES/NO trade pressure into equal-notional buckets over a requested time window.","exampleAgentPrompt":"What's the VPIN flow-toxicity score for the Polymarket market with slug 'will-the-fed-cut-rates-in-july' over the last 60 minutes? I want to know if there's unusual informed trading pressure on the YES side.","exampleUseCases":null,"resultDescription":"A structured JSON object containing the VPIN metric value (flow-toxicity score), the bucketed YES/NO pressure components used in the calculation, the sample size (number of trades evaluated), the effective analysis window, the market slug, the source, and a computedAt timestamp — giving a quantified measure of how toxic or informed the recent trade flow in the market appears to be.","failureModes":["Missing both conditionId and slug returns a validation error — at least one is required","Invalid or unknown conditionId/slug returns a not-found or empty-data error","Insufficient trade data within the requested window returns a low sample size warning or null metric","windowMinutes or limit values outside allowed bounds return a 400 validation error","Payment not sent or insufficient USDC payment via x402 returns a 402 Payment Required response","Rate limiting or upstream Polymarket data unavailability returns a 503 or timeout error"],"whenToPreferThis":"Use this endpoint when you need a quantitative, microstructure-based measure of informed trading activity or flow toxicity on a specific Polymarket prediction market — particularly when evaluating adverse selection risk before placing trades, detecting information leakage around news events, or monitoring unusual directional pressure. Prefer this over generic volume or price endpoints when the question is specifically about the quality and toxicity of order flow rather than raw price or probability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:48:38.431Z","isFirstParty":false}