Bitcoin Spot ETF to Futures ETF Trading Volume
Comparative trading volumes between Bitcoin spot exchange-traded funds (ETFs) and Bitcoin futures ETFs
Request format
curl -X GET "https://newhedge.io/api/v2/metrics/spot-to-futures-volume/METRIC_NAME?api_token=YOUR_TOKEN"
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.
:metric_name — one of the metric names listed below.
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.
Bitcoin Spot to Futures Volume USDtotal_spot_eft_volume_usd
Data used by the Spot to Futures ETF Trading Volume chart.
Resolutions: 1d only.
https://newhedge.io/api/v2/metrics/spot-to-futures-volume/total_spot_eft_volume_usd?api_token=YOUR_TOKEN
Replace `YOUR_TOKEN` with your API token.
[
[
1792972800000,
1665501484.2799
],
[
1793059200000,
1328909471.288
],
[
1793145600000,
1017325576.845
]
]
Value: Bitcoin Spot to Futures Volume USD — Bitcoin Spot ETF to Futures ETF Trading Volume: Comparative trading volumes between Bitcoin spot exchange-traded funds (ETFs) and Bitcoin futures ETFs.
Units: usd
Timestamp: Labelled 00:00 UTC of the day it describes.
Calendar: calendar_daily
Total Bitcoin Spot to Futures Volume USDtotal_futures_eft_volume_usd
Data used by the Spot to Futures ETF Trading Volume chart.
Resolutions: 1d only.
https://newhedge.io/api/v2/metrics/spot-to-futures-volume/total_futures_eft_volume_usd?api_token=YOUR_TOKEN
Replace `YOUR_TOKEN` with your API token.
[
[
1792972800000,
662520975.07
],
[
1793059200000,
479367625.5808
],
[
1793145600000,
439325145.144
]
]
Value: Total Bitcoin Spot to Futures Volume USD — Bitcoin Spot ETF to Futures ETF Trading Volume: Comparative trading volumes between Bitcoin spot exchange-traded funds (ETFs) and Bitcoin futures ETFs.
Units: usd
Timestamp: Labelled 00:00 UTC of the day it describes.
Calendar: calendar_daily