GET
/api/v1/etf/bitcoinHobbyist tier+ · 30 req/minDaily 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.
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| days | number | optional | 30 | 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.