Spot Bitcoin ETF Onchain Holdings [BTC]

Daily on-chain BTC holdings for U.S spot bitcoin ETFs

View in Newhedge External link

How to call

Request format

GET 
curl -X GET "https://newhedge.io/api/v2/metrics/spot-bitcoin-etf-holdings/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.

1 metrics
Metric

Historical Spot Bitcoin ETF Holdingsspot_etf_btc_holdings_historical

Data used by the Onchain Holdings [BTC] chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/spot-bitcoin-etf-holdings/spot_etf_btc_holdings_historical?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
{
  "GBTC": [
    [
      1790726400000,
      126722.21242375
    ],
    [
      1790812800000,
      126722.21242375
    ],
    [
      1790899200000,
      126351.34737799
    ]
  ],
  "HODL": [
    [
      1790726400000,
      14725.70168543999
    ],
    [
      1790812800000,
      14680.29161141999
    ],
    [
      1790899200000,
      14680.97942368999
    ]
  ],
  "IBIT": [
    [
      1790726400000,
      801446.6454464798
    ],
    [
      1790812800000,
      801633.4192844598
    ],
    [
      1790899200000,
      803643.0469766798
    ]
  ]
}
Definition

Value: Bitcoin held by each US spot Bitcoin ETF, one series per ticker.

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

Notes: Response is a keyed hash of [timestamp_ms, btc] series, not a flat array.