{"uid":"cap_A8_LFna86Z7pNXF_86f_-","slug":"dripmetrics-ai-polymarket-flow-imbalance-f370ed6d","name":"DripMetrics AI Polymarket Flow Imbalance","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/flow-imbalance","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.2184,"metric":"flow-imbalance","source":{"market":"https://gamma-api.polymarket.com/markets/slug/fed-decision-in-october","trades":"https://data-api.polymarket.com/trades"},"window":{"windowMinutes":60},"components":{"noVolume":7978.6,"yesVolume":12450.2,"tradeCount":186,"totalVolume":20428.8},"computedAt":"2026-05-25T14:00:00.000Z","sampleSize":{"trades":186},"conditionId":"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_lAXGeQTUWOS49Knh34K6I","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 the buy/sell flow imbalance metric for a Polymarket prediction market over a configurable time window, indicating directional trading pressure.","exampleAgentPrompt":"What's the flow imbalance on the 'fed-decision-in-october' Polymarket market over the last 60 minutes — is money flowing more into yes or no?","exampleUseCases":[{"title":"Pre-trade directional bias check","prompt":"Before I put in a trade on the 'us-recession-2025' Polymarket market, can you check the flow imbalance over the last 30 minutes so I can see if there's strong buying pressure on one side?"},{"title":"Prediction market sentiment dashboard","prompt":"I'm building a dashboard — pull the flow imbalance for the 'fed-decision-in-october' Polymarket market over the past 60 minutes and give me the yes volume, no volume, and trade count breakdown."},{"title":"Detect unusual trading activity","prompt":"Check if there's any unusual one-sided flow imbalance on the 'trump-wins-2024' Polymarket market in the last 15 minutes — I want to know if it's spiking above 0.3 in either direction."}],"resultDescription":"Returns a JSON object with the flow imbalance score (a number between -1 and 1 indicating directional pressure), yes and no volumes, total volume, trade count, the Polymarket condition ID, the time window used, source URLs for the underlying market and trade data, and a timestamp of when the metric was computed.","failureModes":["Unknown or misspelled market slug returns an error or empty result","Market with insufficient trade history in the requested window returns low sample size or null","Very short time windows (e.g. 1 minute) may return sparse data with unreliable imbalance scores","Network issues reaching Polymarket's Gamma API or Data API may cause upstream fetch failures","Payment failure via x402 protocol prevents the request from being processed"],"whenToPreferThis":"Use this endpoint when you need real-time directional flow analysis for a specific Polymarket prediction market — particularly when you want to understand whether buy-side or sell-side pressure dominates within a recent time window. It is purpose-built for Polymarket microstructure diagnostics, unlike generic sentiment or price feeds. Prefer it over raw Polymarket API calls when you need pre-computed, normalized flow imbalance metrics ready for agent consumption or dashboard integration.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:46:33.663Z","isFirstParty":false}