Hyperliquid Smart Money Data API · Flows

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://whaletape.xyz/flows", {
  method: "GET",
});
const data = await res.json();

curl -X GET \
  "https://whaletape.xyz/flows" \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "flows": {
    "4h": [
      {
        "asset_class": "crypto",
        "flow_usd": 12500000,
        "notional_usd": 74000000,
        "oi_change": 0.32,
        "px_change": -0.004,
        "symbol": "XRP"
      }
    ]
  },
  "note": "flow_usd = delta(open_interest x price) over the window; educational heuristic",
  "stealth": [
    {
      "oi_change": 0.41,
      "px_change": 0.002,
      "side_hint": "LONG",
      "stealth_score": 0.33,
      "symbol": "ZEC"
    }
  ],
  "updated_at": "2026-08-23T01:39:43Z"
}