{"uid":"cap_jS5S8FI_jQBe1lo4_hqgL","slug":"hyperliquid-smart-money-flows-api-a8d7bb01","name":"Hyperliquid Smart Money Flows API","description":"Where notional is entering or leaving each market over 1h/4h/24h, plus stealth accumulation: open interest climbing while price stays flat","url":"https://whaletape.xyz/flows","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"note":"flow_usd = delta(open_interest x price) over the window; educational heuristic","flows":{"4h":[{"symbol":"XRP","flow_usd":12500000,"oi_change":0.32,"px_change":-0.004,"asset_class":"crypto","notional_usd":74000000}]},"stealth":[{"symbol":"ZEC","oi_change":0.41,"px_change":0.002,"side_hint":"LONG","stealth_score":0.33}],"updated_at":"2026-08-23T01:39:43Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ig29WM7M0MtEpnQVC_SO7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns net notional flow (money entering or leaving) per Hyperliquid market over 1h, 4h, and 24h windows, including stealth accumulation signals where open interest rises while price stays flat.","exampleAgentPrompt":"Show me which Hyperliquid markets are seeing the most net notional inflow right now — especially any where open interest is climbing while price is flat, which could be a stealth accumulation signal.","exampleUseCases":[{"title":"Spot stealth accumulation before a breakout","prompt":"Are there any Hyperliquid markets right now where open interest is quietly building up but price hasn't moved yet? I want to catch stealth accumulation before it becomes obvious."},{"title":"Track smart money rotation across perps","prompt":"Over the last 4 hours on Hyperliquid, which markets have seen the biggest net notional inflows and which have seen the most outflows? I'm trying to see where money is rotating."},{"title":"Build a real-time flow dashboard for trading","prompt":"Pull the 1h, 4h, and 24h net notional flow data for all Hyperliquid markets so I can build a live dashboard showing where capital is entering and leaving right now."}],"resultDescription":"Returns per-market net notional flow broken down by 1h, 4h, and 24h time windows across Hyperliquid perpetual markets, plus stealth accumulation signals flagging markets where open interest is rising while price remains flat — indicating potential whale positioning before a visible price move.","failureModes":["API returns stale data if Hyperliquid data feed is lagging","Empty or minimal results if markets are in low-activity periods","Payment failure (402) if USDC balance is insufficient for the $0.05 per-call fee","Rate limiting if called too frequently without proper spacing","Partial data if some markets are newly listed and lack sufficient history for all time windows"],"whenToPreferThis":"Choose this endpoint when you need to detect where capital is flowing across Hyperliquid perpetual markets in near real-time, particularly for identifying stealth accumulation (OI rising, price flat) that may precede breakouts. Prefer this over individual wallet or leaderboard endpoints when your goal is market-wide flow intelligence rather than position-level data, and over the asset-class rotation endpoint when you want granular per-market rather than macro-level flows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:32:58.949Z","isFirstParty":false}