Spot Bitcoin ETF Onchain Flows [BTC]

Daily on-chain Bitcoin flows for spot ETFs that have publicly known wallet addresses

How to call

Request format

GET
curl -X GET "https://newhedge.io/api/v2/metrics/spot-bitcoin-etf-onchain-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. A finer value is refused, never served as 1d: 401 when the token is not entitled to finer buckets, 400 when it is entitled and the metric does not ingest that bucket; 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. A 404 for a metric withdrawn on purpose adds withdrawn, withdrawn_on and reason, for example {"error":"Metric not found","withdrawn":true,"withdrawn_on":"2026-09-07","reason":"The venue's public feed reports insurance-fund settlements, not liquidation orders."}; a removed chart can add successor.

Plan and quota refusals keep these statuses and error texts and add code, required_plan, current_plan, feature, upgrade_url, limit and resets_at where they apply. A Pro token whose history window removed points also gets the X-Newhedge-History-Truncated headers, and for a Pro token X-Newhedge-Available-From is the start of the window. See Errors and plan limits.

Metrics

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

14 metrics
Metric

IBIT Spot Bitcoin ETF Onchain Flows BTCibit_etf_spot_flows_btc_onchain

Data used by the Onchain Flows [BTC] chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792886400000,
    0.0
  ],
  [
    1792972800000,
    -1058.39782301
  ],
  [
    1793059200000,
    1080.9578466
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the issuer's US spot Bitcoin ETF in bitcoin, observed on-chain, from the fund's first reliable day.

Units: btc

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

Calendar: calendar_daily

Revision policy: full_replace. Each daily update re-applies the provider's full history, so holdings, flows and totals can restate on any day, not only the latest. History was also rebuilt on 2026-09-15 from a new on-chain attribution source. On 2026-10-14 four funds were added (the Grayscale Bitcoin Mini Trust, Morgan Stanley Bitcoin Trust, BlackRock BITA and Osprey OBTC), each from its first reliable day, and the totals were restated from those days.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-10-14

Metric

GBTC Spot Bitcoin ETF Onchain Flowsgbtc_etf_spot_flows_btc_onchain

Data used by the Onchain Flows [BTC] chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792886400000,
    0.0
  ],
  [
    1792972800000,
    0.0
  ],
  [
    1793059200000,
    0.0
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the issuer's US spot Bitcoin ETF in bitcoin, observed on-chain, from the fund's first reliable day.

Units: btc

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

Calendar: calendar_daily

Revision policy: full_replace. Each daily update re-applies the provider's full history, so holdings, flows and totals can restate on any day, not only the latest. History was also rebuilt on 2026-09-15 from a new on-chain attribution source. On 2026-10-14 four funds were added (the Grayscale Bitcoin Mini Trust, Morgan Stanley Bitcoin Trust, BlackRock BITA and Osprey OBTC), each from its first reliable day, and the totals were restated from those days.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-10-14

Metric

FBTC Spot Bitcoin ETF Onchain Flows BTCfbtc_etf_spot_flows_btc_onchain

Data used by the Onchain Flows [BTC] chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792886400000,
    0.0
  ],
  [
    1792972800000,
    0.0
  ],
  [
    1793059200000,
    0.0
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the issuer's US spot Bitcoin ETF in bitcoin, observed on-chain, from the fund's first reliable day.

Units: btc

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

Calendar: calendar_daily

Revision policy: full_replace. Each daily update re-applies the provider's full history, so holdings, flows and totals can restate on any day, not only the latest. History was also rebuilt on 2026-09-15 from a new on-chain attribution source. On 2026-10-14 four funds were added (the Grayscale Bitcoin Mini Trust, Morgan Stanley Bitcoin Trust, BlackRock BITA and Osprey OBTC), each from its first reliable day, and the totals were restated from those days.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-10-14

Metric

ARKB Spot Bitcoin ETF Onchain Flows BTCarkb_etf_spot_flows_btc_onchain

Data used by the Onchain Flows [BTC] chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792886400000,
    0.0
  ],
  [
    1792972800000,
    0.0
  ],
  [
    1793059200000,
    0.0
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the issuer's US spot Bitcoin ETF in bitcoin, observed on-chain, from the fund's first reliable day.

Units: btc

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

Calendar: calendar_daily

Revision policy: full_replace. Each daily update re-applies the provider's full history, so holdings, flows and totals can restate on any day, not only the latest. History was also rebuilt on 2026-09-15 from a new on-chain attribution source. On 2026-10-14 four funds were added (the Grayscale Bitcoin Mini Trust, Morgan Stanley Bitcoin Trust, BlackRock BITA and Osprey OBTC), each from its first reliable day, and the totals were restated from those days.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-10-14

Metric

BITB Spot Bitcoin ETF Onchain Flows BTCbitb_etf_spot_flows_btc_onchain

Data used by the Onchain Flows [BTC] chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792886400000,
    0.0
  ],
  [
    1792972800000,
    0.0
  ],
  [
    1793059200000,
    0.0
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the issuer's US spot Bitcoin ETF in bitcoin, observed on-chain, from the fund's first reliable day.

Units: btc

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

Calendar: calendar_daily

Revision policy: full_replace. Each daily update re-applies the provider's full history, so holdings, flows and totals can restate on any day, not only the latest. History was also rebuilt on 2026-09-15 from a new on-chain attribution source. On 2026-10-14 four funds were added (the Grayscale Bitcoin Mini Trust, Morgan Stanley Bitcoin Trust, BlackRock BITA and Osprey OBTC), each from its first reliable day, and the totals were restated from those days.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-10-14

Metric

EZBC Spot Bitcoin ETF Onchain Flows BTCezbc_etf_spot_flows_btc_onchain

Data used by the Onchain Flows [BTC] chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792886400000,
    0.0
  ],
  [
    1792972800000,
    0.0
  ],
  [
    1793059200000,
    0.0
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the issuer's US spot Bitcoin ETF in bitcoin, observed on-chain, from the fund's first reliable day.

Units: btc

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

Calendar: calendar_daily

Revision policy: full_replace. Each daily update re-applies the provider's full history, so holdings, flows and totals can restate on any day, not only the latest. History was also rebuilt on 2026-09-15 from a new on-chain attribution source. On 2026-10-14 four funds were added (the Grayscale Bitcoin Mini Trust, Morgan Stanley Bitcoin Trust, BlackRock BITA and Osprey OBTC), each from its first reliable day, and the totals were restated from those days.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-10-14

Metric

BTCW Spot Bitcoin ETF Onchain Flows BTCbtcw_etf_spot_flows_btc_onchain

Data used by the Onchain Flows [BTC] chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792886400000,
    0.0
  ],
  [
    1792972800000,
    0.0
  ],
  [
    1793059200000,
    0.0
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the issuer's US spot Bitcoin ETF in bitcoin, observed on-chain, from the fund's first reliable day.

Units: btc

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

Calendar: calendar_daily

Revision policy: full_replace. Each daily update re-applies the provider's full history, so holdings, flows and totals can restate on any day, not only the latest. History was also rebuilt on 2026-09-15 from a new on-chain attribution source. On 2026-10-14 four funds were added (the Grayscale Bitcoin Mini Trust, Morgan Stanley Bitcoin Trust, BlackRock BITA and Osprey OBTC), each from its first reliable day, and the totals were restated from those days.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-10-14

Metric

BTCO Spot Bitcoin ETF Onchain Flows BTCbtco_etf_spot_flows_btc_onchain

Data used by the Onchain Flows [BTC] chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792886400000,
    0.0
  ],
  [
    1792972800000,
    0.0
  ],
  [
    1793059200000,
    0.0
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the issuer's US spot Bitcoin ETF in bitcoin, observed on-chain, from the fund's first reliable day.

Units: btc

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

Calendar: calendar_daily

Revision policy: full_replace. Each daily update re-applies the provider's full history, so holdings, flows and totals can restate on any day, not only the latest. History was also rebuilt on 2026-09-15 from a new on-chain attribution source. On 2026-10-14 four funds were added (the Grayscale Bitcoin Mini Trust, Morgan Stanley Bitcoin Trust, BlackRock BITA and Osprey OBTC), each from its first reliable day, and the totals were restated from those days.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-10-14

Metric

BRRR Spot Bitcoin ETF Onchain Flows BTCbrrr_etf_spot_flows_btc_onchain

Data used by the Onchain Flows [BTC] chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792886400000,
    0.0
  ],
  [
    1792972800000,
    0.0
  ],
  [
    1793059200000,
    0.0
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the issuer's US spot Bitcoin ETF in bitcoin, observed on-chain, from the fund's first reliable day.

Units: btc

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

Calendar: calendar_daily

Revision policy: full_replace. Each daily update re-applies the provider's full history, so holdings, flows and totals can restate on any day, not only the latest. History was also rebuilt on 2026-09-15 from a new on-chain attribution source. On 2026-10-14 four funds were added (the Grayscale Bitcoin Mini Trust, Morgan Stanley Bitcoin Trust, BlackRock BITA and Osprey OBTC), each from its first reliable day, and the totals were restated from those days.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-10-14

Metric

HODL Spot Bitcoin ETF Onchain Flows BTChodl_etf_spot_flows_btc_onchain

Data used by the Onchain Flows [BTC] chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792886400000,
    0.0
  ],
  [
    1792972800000,
    0.0
  ],
  [
    1793059200000,
    0.0
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the issuer's US spot Bitcoin ETF in bitcoin, observed on-chain, from the fund's first reliable day.

Units: btc

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

Calendar: calendar_daily

Revision policy: full_replace. Each daily update re-applies the provider's full history, so holdings, flows and totals can restate on any day, not only the latest. History was also rebuilt on 2026-09-15 from a new on-chain attribution source. On 2026-10-14 four funds were added (the Grayscale Bitcoin Mini Trust, Morgan Stanley Bitcoin Trust, BlackRock BITA and Osprey OBTC), each from its first reliable day, and the totals were restated from those days.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-10-14

Metric

BITA Spot Bitcoin ETF Onchain Flows BTCbita_etf_spot_flows_btc_onchain

Data used by the Onchain Flows [BTC] chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792886400000,
    0.0
  ],
  [
    1792972800000,
    39.7710716
  ],
  [
    1793059200000,
    0.0
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the issuer's US spot Bitcoin ETF in bitcoin, observed on-chain, from the fund's first reliable day.

Units: btc

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

Calendar: calendar_daily

Revision policy: full_replace. Each daily update re-applies the provider's full history, so holdings, flows and totals can restate on any day, not only the latest. History was also rebuilt on 2026-09-15 from a new on-chain attribution source. On 2026-10-14 four funds were added (the Grayscale Bitcoin Mini Trust, Morgan Stanley Bitcoin Trust, BlackRock BITA and Osprey OBTC), each from its first reliable day, and the totals were restated from those days.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-10-14

Metric

BTC Spot Bitcoin ETF Onchain Flows BTCbtc_etf_spot_flows_btc_onchain

Data used by the Onchain Flows [BTC] chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792886400000,
    0.0
  ],
  [
    1792972800000,
    0.0
  ],
  [
    1793059200000,
    0.0
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the issuer's US spot Bitcoin ETF in bitcoin, observed on-chain, from the fund's first reliable day.

Units: btc

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

Calendar: calendar_daily

Revision policy: full_replace. Each daily update re-applies the provider's full history, so holdings, flows and totals can restate on any day, not only the latest. History was also rebuilt on 2026-09-15 from a new on-chain attribution source. On 2026-10-14 four funds were added (the Grayscale Bitcoin Mini Trust, Morgan Stanley Bitcoin Trust, BlackRock BITA and Osprey OBTC), each from its first reliable day, and the totals were restated from those days.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-10-14

Metric

MSBT Spot Bitcoin ETF Onchain Flows BTCmsbt_etf_spot_flows_btc_onchain

Data used by the Onchain Flows [BTC] chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792886400000,
    0.0
  ],
  [
    1792972800000,
    51.5688606
  ],
  [
    1793059200000,
    0.0
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the issuer's US spot Bitcoin ETF in bitcoin, observed on-chain, from the fund's first reliable day.

Units: btc

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

Calendar: calendar_daily

Revision policy: full_replace. Each daily update re-applies the provider's full history, so holdings, flows and totals can restate on any day, not only the latest. History was also rebuilt on 2026-09-15 from a new on-chain attribution source. On 2026-10-14 four funds were added (the Grayscale Bitcoin Mini Trust, Morgan Stanley Bitcoin Trust, BlackRock BITA and Osprey OBTC), each from its first reliable day, and the totals were restated from those days.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-10-14

Metric

OBTC Spot Bitcoin ETF Onchain Flows BTCobtc_etf_spot_flows_btc_onchain

Data used by the Onchain Flows [BTC] chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792886400000,
    0.0
  ],
  [
    1792972800000,
    0.0
  ],
  [
    1793059200000,
    0.0
  ]
]
Definition

Value: Daily net flow of bitcoin into (positive) or out of (negative) the issuer's US spot Bitcoin ETF in bitcoin, observed on-chain, from the fund's first reliable day.

Units: btc

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

Calendar: calendar_daily

Revision policy: full_replace. Each daily update re-applies the provider's full history, so holdings, flows and totals can restate on any day, not only the latest. History was also rebuilt on 2026-09-15 from a new on-chain attribution source. On 2026-10-14 four funds were added (the Grayscale Bitcoin Mini Trust, Morgan Stanley Bitcoin Trust, BlackRock BITA and Osprey OBTC), each from its first reliable day, and the totals were restated from those days.

Universe: US spot Bitcoin ETFs.

Methodology version: 2026-10-14