Skip to main content
Loading market data…
GET/api/v1/etf/bitcoinHobbyist tier+ · 30 req/min

Daily spot Bitcoin ETF flows, cumulative AUM, rolling 7-day flow, and issuer breakdown.

Spot BTC ETFs (IBIT, FBTC, BITB, etc.) became the biggest new buyer of bitcoin in 2024 — this is the daily flow telemetry. You get per-ticker flows per day, the cumulative AUM total, the rolling 7-day net flow (the headline number traders cite), and extremes: biggest inflow and outflow day in the window.

Query parameters

All query parameters are optional unless marked required.

NameTypeRequiredDefaultDescription
daysnumberoptional30
Trailing window of daily flow rows. Max 365.

Response shape

Always wrapped in the standard envelope. Nullable fields are explicitly marked — treat missing numeric data as a real data-source gap, not as an error.

data payloadtypescript
// Wrapped in the standard envelope:
// {
//   data: /* shape below */,
//   meta?: { total?: number; limit?: number; offset?: number; ... }
// }

{
  flows: Array<{
    date: string;                             // YYYY-MM-DD
    tickerFlows: Record<string, number>;      // { IBIT: 125.4, FBTC: 88.1, ... }, $M
    total: number;                            // $M
  }>;
  cumulative: number;                         // $M, all-time
  rolling7d: number;                          // $M
  biggestInflow: { date: string; totalUsdM: number } | null;
  biggestOutflow: { date: string; totalUsdM: number } | null;
  topIssuers: Array<{
    ticker: string;
    cumulativeUsdM: number;
    share: number;                            // 0–1, signed share of |total|
  }>;
}

Example

Copy the curl, replace YOUR_KEY with a real key from your dashboard, and run.

Requestbash
curl -sS "http://localhost:3000/api/v1/etf/bitcoin?days=30" \
  -H "Authorization: Bearer cg_live_YOUR_KEY"
Responsejson
{
  "data": {
    "flows": [
      {
        "date": "2026-04-17",
        "tickerFlows": { "IBIT": 112.4, "FBTC": 64.2, "BITB": 18.5 },
        "total": 195.1
      }
    ],
    "cumulative": 43210.55,
    "rolling7d": 920.12,
    "biggestInflow": { "date": "2026-03-05", "totalUsdM": 1045.3 },
    "biggestOutflow": { "date": "2026-02-19", "totalUsdM": -385.7 },
    "topIssuers": [
      { "ticker": "IBIT", "cumulativeUsdM": 24100.0, "share": 0.56 },
      { "ticker": "FBTC", "cumulativeUsdM": 11200.0, "share": 0.26 }
    ]
  },
  "meta": { "total": 1, "days": 30 }
}

Notes

  • All dollar values are in USD millions ($M).
  • Ingest source is Farside — same feed powers `/etf/btc`.

Next

Check the error code reference, or get an API key to try the request against your own account.