{"uid":"cap_LhO8gsK8YW_MAhundJr3O","slug":"api-dripmetrics-ai-efaba295","name":"DripMetrics Order Flow HHI","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. Order Flow HHI measures concentration of signed order flow across the specified window. Discovery examples use the latest 30m window.","url":"https://api.dripmetrics.ai/metrics/order-flow-hhi","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.274118,"metric":"order-flow-hhi","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":{"request":{"input":{"type":"http","method":"GET","queryParams":{"pair":"BTCUSDT","window":"1h","exchange":"binance"}}},"response":{"pair":"BTCUSDT","value":0.03964023,"metric":"order-flow-hhi","window":"1h","exchange":"binance","components":{"maxShare":0.128393,"intervals":60,"nonZeroIntervals":60,"effectiveIntervals":25.2269,"totalAbsoluteSignedFlow":85.51969},"computedAt":"2026-05-25T04:31:57.960Z","tradeCount":16486,"lastTradeTime":"2026-05-25T04:31:56.936Z","firstTradeTime":"2026-05-25T03:31:57.973Z"}},"exampleRequest":{"pair":"BTCUSDT","window":"1h","exchange":"binance"},"tags":["x402"],"displayCostAmount":"0.05","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.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_84lCZiJKQ8P2Qxo6CIdef","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":"Computes the Herfindahl-Hirschman Index (HHI) of signed order flow concentration for a crypto trading pair over a specified lookback window","exampleAgentPrompt":"What's the order flow HHI concentration for BTCUSDT on Binance over the last 1 hour — is the signed order flow highly concentrated or spread out across intervals?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the HHI value (0–1 scale), the trading pair, exchange, window, trade count, computation timestamp, and component breakdown including maxShare, number of intervals, nonZeroIntervals, effectiveIntervals, and totalAbsoluteSignedFlow.","failureModes":["Invalid pair symbol returns error (e.g. unsupported ticker not native to exchange)","Unsupported exchange value outside enum binance/coinbase returns 400","Unsupported window value outside enum 30m/1h returns 400","Insufficient trade data in window may return error or low tradeCount","Payment failure via x402 results in 402 response if USDC payment not processed","Network timeout if exchange data source is temporarily unavailable"],"whenToPreferThis":"Use this endpoint when you need to quantify how concentrated or dispersed signed order flow is across time intervals for a crypto pair — useful for detecting periods of dominant directional pressure, assessing market microstructure health, or building risk models. Prefer this over raw trade data endpoints when you need a pre-computed concentration index rather than raw order book or tick data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:40:05.625Z","isFirstParty":false}