{"uid":"cap_0pNMmFfHuRXOfpHWtCkx3","slug":"dripmetrics-ai-hyperliquid-drawdown-metric-945f7f96","name":"DripMetrics AI – Hyperliquid Drawdown Metric","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/hyperliquid/drawdown","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"pair":"BTC","value":0.02401816,"metric":"drawdown","source":{"candles":"https://api.hyperliquid.xyz/info"},"window":"30m","interval":"1m","components":{"peakPrice":110215.4,"troughPrice":107568.2},"computedAt":"2026-05-29T16:00:00.000Z","sampleSize":{"candles":30},"lastCandleTime":"2026-05-29T15:59:59.999Z","firstCandleTime":"2026-05-29T15:30:00.000Z"}},"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_LyK1_Ap2J2ruACEJg6AJz","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 maximum drawdown (peak-to-trough price decline) for a given crypto pair over a specified rolling window using Hyperliquid candle data.","exampleAgentPrompt":"What's the current drawdown for BTC on Hyperliquid over the last 30 minutes using 1-minute candles? I want to see the peak price, trough price, and the overall drawdown percentage.","exampleUseCases":[{"title":"Real-time BTC drawdown risk check","prompt":"Pull the Hyperliquid drawdown metric for BTC right now over a 30-minute window with 1-minute candles — I want to know how far it's fallen from its recent peak and what the peak and trough prices were."},{"title":"ETH intraday risk monitoring for trading bot","prompt":"Every 5 minutes, check the drawdown on ETH using Hyperliquid data with a 1-hour window and 1-minute candles so my trading bot can pause if the drawdown exceeds 3%."},{"title":"Comparing drawdown across multiple altcoins","prompt":"Get me the current drawdown metric from Hyperliquid for SOL and AVAX over the last 15 minutes using 1-minute candles — I want to compare which one has had a steeper peak-to-trough decline today."}],"resultDescription":"Returns a JSON object containing the drawdown ratio (e.g. 0.024 = 2.4%), the peak and trough prices used in the calculation, the candle window and interval, the number of candles sampled, the first and last candle timestamps, the data source URL, and a computedAt timestamp.","failureModes":["Invalid or unsupported trading pair symbol returns an error","Requested window or interval not available on Hyperliquid returns a 400-level error","Hyperliquid data source unavailable causes a timeout or 503","Insufficient candle history for the requested window returns a partial or error response","Missing required payment header (x402) results in a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you specifically need rolling maximum drawdown computed from Hyperliquid perpetual futures candle data, with peak and trough price components broken out. Prefer it over generic OHLCV endpoints when you need a pre-computed risk metric rather than raw candles, and over broader analytics platforms when you want a lightweight, per-call paid computation at $0.05 USDC with no subscription required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:49:57.519Z","isFirstParty":false}