---
title: "ETF Aggregate Metrics"
method: GET
path: "/v1/etf/aggregate"
tags: ["ETF Analytics"]
---

# ETF Aggregate Metrics

`GET /v1/etf/aggregate`

## Request

- Base URL: `https://api.blocklens.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.blocklens.co/v1/etf/aggregate`
- Auth: none declared

Provides daily aggregate metrics for all Bitcoin ETFs tracked by Blocklens.

- **total_btc_holdings**: Total BTC held across all ETFs
- **total_aum**: Total Assets Under Management (USD)
- **net_flow_btc**: Daily change in total BTC holdings
- **cumulative_flow_btc**: Running sum of net flows from inception
- **cumulative_money_flow**: Cumulative net USD flow of all ETFs — exact creations minus redemptions at NAV for US spot ETFs since 2024-01-11, ΔBTC × BTC price estimate for non-US ETPs and earlier years
- **etf_realized_price**: Average BTC acquisition price across ETFs (weighted-average cost of per-fund realized caps / total_btc_holdings)
- **btc_dominance**: ETF BTC holdings as % of circulating supply
- **etf_count**: Number of ETFs reporting data that day
- **us_btc_holdings / us_aum**: US-listed ETFs only
- **us_spot_cumulative_money_flow**: Running sum of us_spot_net_flow_usd since 2024-01-11 (last value = sum of the daily values)
- **us_spot_realized_price**: Average cost basis for US spot ETF cohort from Jan 10, 2024
- **us_spot_net_flow_usd**: Daily USD net flow of US spot ETFs since 2024-01-11 — Σ per fund (shares outstanding after the day − before) × NAV, by trade date (newest day provisional until every fund's figure is published)

## Query parameters

- `from_date` string, date, nullable: Start date (YYYY-MM-DD)
- `to_date` string, date, nullable: End date (YYYY-MM-DD)
- `limit` integer: Number of records to return
- `fields` string, nullable: Comma-separated field names to include (date columns always kept)

## Response `200`

Successful Response

- ApiResponse: Standard API response model
  - `success` boolean, required
  - `data` unknown, required
  - `message` string, nullable
  - `count` integer, nullable
  - `timestamp` string, date-time

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/blocklens/apis/blocklens-on-chain-api.md) · [All operations](https://skmtc.dev/blocklens/apis/blocklens-on-chain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blocklens/apis/blocklens-on-chain-api/revisions/dacc02ae0f9a?raw)