{"uid":"cap_z8NpfaDpaNAFndBQcVFoJ","slug":"dripmetrics-buy-sell-volume-imbalance-8b198f28","name":"DripMetrics Buy-Sell Volume Imbalance","description":"DripMetricsAI (api description at https://dripmetrics.ai/) provides on-demand market microstructure and risk metrics for agents and developers. Agents can pay per request via x402 and receive structured JSON metrics without subscriptions or API keys. Buy-Sell Volume Imbalance measures net buy versus sell volume as a normalized ratio. Discovery examples use the latest 30m window.","url":"https://api.dripmetrics.ai/metrics/buy-sell-volume-imbalance","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","required":["pair","exchange","window"],"properties":{"pair":{"type":"string","description":"Exchange-native trading pair symbol such as BTCUSDT, ETH-USD, BTC, or xyz:TSLA."},"window":{"enum":["30m","1h","2h","3h"],"type":"string","description":"Lookback window. Hyperliquid supports 30m and 1h; 2h and 3h are currently BTCUSDT/BTC-USD only."},"exchange":{"enum":["binance","coinbase","hyperliquid"],"type":"string","description":"Exchange adapter to source recent trades from."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["metric","pair","exchange","window","value","computedAt","tradeCount","firstTradeTime","lastTradeTime","coverage"],"properties":{"pair":{"type":"string"},"value":{"type":"number"},"metric":{"type":"string"},"window":{"enum":["30m","1h","2h","3h"],"type":"string"},"coverage":{"type":"object","required":["requestedWindowMinutes","effectiveWindowMinutes","coverageRatio","partialData","completeFetch","errorMessage"],"properties":{"partialData":{"type":"boolean"},"errorMessage":{"type":["string","null"]},"completeFetch":{"type":"boolean"},"coverageRatio":{"type":"number","maximum":1,"minimum":0},"effectiveWindowMinutes":{"type":"number","minimum":0},"requestedWindowMinutes":{"type":"number","minimum":0}},"additionalProperties":false},"exchange":{"enum":["binance","coinbase","hyperliquid"],"type":"string"},"components":{"type":"object","additionalProperties":{"type":"number"}},"computedAt":{"type":"string","format":"date-time"},"tradeCount":{"type":"integer","minimum":1},"lastTradeTime":{"type":"string","format":"date-time"},"firstTradeTime":{"type":"string","format":"date-time"},"benchmarkCoverage":{"type":"object","required":["requestedWindowMinutes","effectiveWindowMinutes","coverageRatio","partialData","completeFetch","errorMessage"],"properties":{"partialData":{"type":"boolean"},"errorMessage":{"type":["string","null"]},"completeFetch":{"type":"boolean"},"coverageRatio":{"type":"number","maximum":1,"minimum":0},"effectiveWindowMinutes":{"type":"number","minimum":0},"requestedWindowMinutes":{"type":"number","minimum":0}},"additionalProperties":false}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"pair":"BTC-USD","value":0.143218,"metric":"buy-sell-volume-imbalance","window":"30m","coverage":{"partialData":false,"errorMessage":null,"completeFetch":true,"coverageRatio":1,"effectiveWindowMinutes":30,"requestedWindowMinutes":30},"exchange":"coinbase","components":{},"computedAt":"2026-05-23T14:00:00.000Z","tradeCount":428,"lastTradeTime":"2026-05-23T13:59:58.000Z","firstTradeTime":"2026-05-23T13:00:02.000Z"}},"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_OkFc2CcDkrYniguv1PLhi","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 normalized buy-vs-sell volume imbalance ratio for a crypto trading pair over a specified lookback window","exampleAgentPrompt":"What's the buy-sell volume imbalance for BTCUSDT on Binance over the last hour?","exampleUseCases":null,"resultDescription":"A JSON object containing the metric name, trading pair, exchange, lookback window (e.g. '1h'), the normalized buy-sell imbalance value, computation timestamp, trade count, first and last trade timestamps, component breakdown values, and a coverage object showing requested vs effective window minutes, coverage ratio, and whether data was partial or complete.","failureModes":["Unsupported pair/exchange combination returns error — 2h and 3h windows only supported for BTCUSDT/BTC-USD","Partial data coverage if recent trade history is incomplete — indicated by partialData flag and coverageRatio below 1","Exchange adapter unavailable results in error response","Invalid window enum value returns validation error","Insufficient funds or payment failure via x402 blocks the request"],"whenToPreferThis":"Use this endpoint when you need a real-time, normalized measure of net buying versus selling pressure for a specific crypto pair on Binance or Coinbase. It is ideal for agents building trading signals, monitoring order flow imbalances, or assessing short-term directional pressure without needing a full exchange connection. Prefer this over raw trade data endpoints when you want a precomputed, structured ratio with coverage metadata included.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:43:40.390Z","isFirstParty":false}