Spot Bitcoin ETF Onchain Total Net Flows

The daily aggregated net on-chain flow (in BTC and USD) for spot Bitcoin ETFs

How to call

Request format

GET
curl -X GET "https://newhedge.io/api/v2/metrics/spot-bitcoin-etf-onchain-total-net-flows/METRIC_NAME?api_token=YOUR_TOKEN"
Query params

api_token (required) — 24 character token.

resolution (optional) — 1d only for the metrics on this chart. Any other value is refused with a 400 that names what is available; see Resolutions.

before (optional) — exclusive cursor, returns observations older than this timestamp_ms. Works on every resolution.

limit (optional) — the most recent N observations, maximum 5000. Finer resolutions page by default (2500); a 1d request returns the whole series unless you send limit or before.

before and limit narrow a time series. A response with no single time axis, such as a hash keyed by venue or a labelled snapshot table, has nothing to cut on. It is returned whole, and both parameters are ignored rather than rejected.

A before that is not a positive epoch-millisecond timestamp is a 400. It is the one paging value we reject rather than ignore, because a page size has a sensible default and a cursor does not.

include (optional) — definition wraps the response as {"definition": …, "data": …} and returns the record shown under each metric; see Definitions. Any other value is a 400.

Path params

:metric_name — one of the metric names listed below.

Responses

200 with JSON payload, 400 for an unknown include value, 401 for missing/invalid token, 404 for missing resources.

Metrics

Each metric is fetched independently. Responses are trimmed samples to show structure.

2 metrics
Metric

Spot Bitcoin ETF Onchain Total Net Flows BTCspot_btc_etf_total_flows_btc_onchain

Data used by the Onchain Total Net Flows chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/spot-bitcoin-etf-onchain-total-net-flows/spot_btc_etf_total_flows_btc_onchain?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1790726400000,
    1108.49850995
  ],
  [
    1790812800000,
    -434.67508592
  ],
  [
    1790899200000,
    1610.29868772
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the US spot Bitcoin ETFs in bitcoin, observed on-chain. The total sums every issuer.

Units: btc

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: full_replace. History was rebuilt on 2026-09-15 from a new on-chain attribution source; values before then can differ from earlier publications.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-09-15

Metric

Onchain Flows USDspot_btc_etf_total_flows_usd_onchain

Data used by the Onchain Total Net Flows chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/spot-bitcoin-etf-onchain-total-net-flows/spot_btc_etf_total_flows_usd_onchain?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1790726400000,
    92720136.16
  ],
  [
    1790812800000,
    -36315868.95
  ],
  [
    1790899200000,
    136525679.88
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the US spot Bitcoin ETFs in US dollars, observed on-chain. The total sums every issuer.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: full_replace. History was rebuilt on 2026-09-15 from a new on-chain attribution source; values before then can differ from earlier publications.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-09-15