# Hyperliquid Smart Money Flows API

> Hyperliquid Smart Money Flows API is a paid API for AI agents from whaletape.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

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.

## Facts

- Endpoint: GET https://whaletape.xyz/flows
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-smart-money-flows-api-a8d7bb01
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jS5S8FI_jQBe1lo4_hqgL

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hyperliquid-smart-money-flows-api-a8d7bb01
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Where notional is entering or leaving each market over 1h/4h/24h, plus stealth accumulation: open interest climbing while price stays flat

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-smart-money-flows-api-a8d7bb01/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from whaletape.xyz](https://www.zero.xyz/host/whaletape.xyz/llms.txt)