--- name: api.dripmetrics.ai description: api.dripmetrics.ai provides pre-computed market microstructure metrics for crypto trading pairs, specifically Kyle Lambda (price impact), Order Flow HHI (concentration), and Roll Spread (bid-ask spread proxy). All three metrics are computed over rolling windows and returned as single-shot analytical results, not live streams. The host is oriented toward quantitative analysis of liquidity, order flow, and trading costs. host: api.dripmetrics.ai --- # api.dripmetrics.ai DripMetrics serves quantitative traders, researchers, and analytics agents that need microstructure-level signals beyond simple price data. It exposes three distinct but complementary metrics — price impact coefficient, order flow concentration, and spread estimation — each derived from trade-level data and returned as a structured result. The host does not provide raw trade data, order books, or real-time feeds; it is a computed-metrics layer sitting above raw market data. ## When to use this host Use api.dripmetrics.ai when an agent needs pre-computed microstructure metrics — specifically Kyle Lambda, order flow HHI, or Roll Spread — for a crypto trading pair to inform liquidity assessment, execution cost estimation, or order flow toxicity analysis. Do not use this host for real-time or streaming price data; use a dedicated market data or ticker API instead. Do not use it for raw trade records or order book snapshots; it returns only aggregated, window-based metrics. Currently appears limited to BTCUSDT and a narrow set of supported exchanges, so it is not suitable for arbitrary token pairs or long-tail assets. For broader token coverage or spot pricing, route to a general-purpose market data provider. ## Capabilities ### Market Microstructure Analytics Provides three complementary quantitative metrics — price impact (Kyle Lambda), order flow concentration (HHI), and bid-ask spread proxy (Roll Spread) — that together characterize the liquidity and trading cost profile of a given token pair on a supported exchange. - **`fetch-kyle-lambda-metrics`** — Returns the Kyle Lambda market impact metric for a trading pair on a given exchange, including alpha, R-squared, order flow, and trade count over a rolling window. - **`fetch-order-flow-hhi`** — Returns the Herfindahl-Hirschman Index (HHI) for order flow concentration over a rolling window for a given token pair and exchange. - **`fetch-roll-spread-metrics`** — Returns roll-spread market metrics for a given chain and address, including the computed spread value, covariance components, trade count, and observation window. ## Workflows ### Full Liquidity Profile Assessment *Use when an agent needs a comprehensive microstructure snapshot of a trading pair, covering price impact, order flow dominance, and effective spread simultaneously.* 1. **`fetch-kyle-lambda-metrics`** — Retrieve the Kyle Lambda coefficient to quantify how much price moves per unit of order flow, indicating market depth and impact cost. 2. **`fetch-order-flow-hhi`** — Retrieve the HHI to determine whether buy or sell pressure is concentrated, signaling potential directional dominance or manipulation risk. 3. **`fetch-roll-spread-metrics`** — Retrieve the Roll Spread estimate to approximate the effective bid-ask spread and round-trip trading cost for the pair. ## Skill reference ### `fetch-kyle-lambda-metrics` **Kyle Lambda Metrics** — Returns the Kyle Lambda market impact metric for a trading pair on a given exchange, including alpha, R-squared, order flow, and trade count over a rolling window. *Use when:* Use when an agent needs quantitative market microstructure analytics — specifically the Kyle Lambda liquidity/price-impact coefficient — for a crypto trading pair, to assess order flow toxicity or market depth. *Not for:* Do not use for real-time streaming price feeds or simple spot price lookups; use a market data or ticker API instead. Not suitable for non-BTCUSDT pairs or exchanges not supported by the endpoint. **Inputs:** - `chain` (string, required) — Blockchain network identifier for payment routing (e.g. 'base'). - `address` (string, required) — EVM wallet address used for payment authentication on the specified chain. **Returns:** Returns a Kyle Lambda object for BTCUSDT on Binance over a 30-minute window, including the lambda value, alpha, R-squared, mean signed order flow, last price, dollars-per-1-cent liquidity estimate, trade count, and computation timestamps. **Example:** `GET https://api.dripmetrics.ai/metrics/kyle-lambda?chain=base&address=0x7e571E959cC7C75Ccdd2eAC24f8775ea2eAa2F09` --- ### `fetch-order-flow-hhi` **Order Flow HHI Metrics** — Returns the Herfindahl-Hirschman Index (HHI) for order flow concentration over a rolling window for a given token pair and exchange. *Use when:* Use when an agent needs to measure order flow concentration or detect dominant directional flow in a trading pair, such as identifying whether buy or sell pressure is concentrated among a few intervals. *Not for:* Do not use for raw trade data or order book snapshots; this returns a pre-computed concentration metric only, not individual trade records. **Inputs:** - `chain` (string, required) — Blockchain network identifier for the token address lookup. - `address` (string, required) — Token contract address to identify the trading pair for HHI computation. **Returns:** Returns an order-flow-hhi metric object with HHI value, pair, exchange, 30-minute window, concentration components (maxShare, effectiveIntervals), trade count, and first/last trade timestamps. **Example:** `GET https://api.dripmetrics.ai/metrics/order-flow-hhi?chain=base&address=0x7e571E959cC7C75Ccdd2eAC24f8775ea2eAa2F09` --- ### `fetch-roll-spread-metrics` **Roll Spread Metrics** — Returns roll-spread market metrics for a given chain and address, including the computed spread value, covariance components, trade count, and observation window. *Use when:* Use when an agent needs a quantitative roll-spread proxy for a trading pair, including covariance-based spread value, observation window, and trade timing metadata, to inform trading or analytics decisions. *Not for:* Do not use for real-time streaming price feeds or order book data; this is a single-shot computed metric over a fixed window, not a live quote. **Inputs:** - `chain` (string, required) — Blockchain network identifier to scope the query. - `address` (string, required) — Contract or wallet address used to identify the market or instrument for which roll-spread metrics are computed. **Returns:** Returns a roll-spread metric object with the computed spread value (e.g. 11.76), pair (BTCUSDT), exchange (binance), 30m window, covariance components, trade count (8075), and first/last trade timestamps. **Example:** `GET https://api.dripmetrics.ai/metrics/roll-spread?chain=base&address=0x7e571E959cC7C75Ccdd2eAC24f8775ea2eAa2F09` ---