GET
/api/v1/etf/ethereumHobbyist tier+ · 30 req/minDaily spot Ethereum ETF flows — mirrors the shape of the Bitcoin endpoint.
Same shape as `/api/v1/etf/bitcoin`, but for the spot ETH ETF cohort (ETHA, FETH, ETHW, ETHV, etc.). Flows have been noisier than BTC — mixing with staking-yield ETFs makes the aggregate interpretation less clean. Use this endpoint for flow-direction headlines; cross-check against the per-ticker breakdown before trading it.
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;
tickerFlows: Record<string, number>;
total: number;
}>;
cumulative: number;
rolling7d: number;
biggestInflow: { date: string; totalUsdM: number } | null;
biggestOutflow: { date: string; totalUsdM: number } | null;
topIssuers: Array<{ ticker: string; cumulativeUsdM: number; share: number }>;
}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/ethereum?days=30" \
-H "Authorization: Bearer cg_live_YOUR_KEY"Responsejson
{
"data": {
"flows": [
{
"date": "2026-04-17",
"tickerFlows": { "ETHA": 22.1, "FETH": 18.4, "ETHV": 5.2 },
"total": 45.7
}
],
"cumulative": 2810.33,
"rolling7d": 88.12,
"biggestInflow": { "date": "2026-03-21", "totalUsdM": 215.8 },
"biggestOutflow": { "date": "2026-02-11", "totalUsdM": -120.0 },
"topIssuers": [
{ "ticker": "ETHA", "cumulativeUsdM": 1400.0, "share": 0.50 }
]
},
"meta": { "total": 1, "days": 30 }
}Notes
- Wire shape is 1:1 with the BTC ETF route — same client code works.
- Beware mixing ETHE legacy outflow days with spot-ETF launches; Farside normalises but raw aggregates can spike.
Next
Check the error code reference, or get an API key to try the request against your own account.