Skip to content

Search API documentation

Metrics, companies & guides

Start here

Quickstart Authentication API plans & access Bitcoin prices & OHLCV data
Try

Bitcoin Cost Basis Distribution (USD-Weighted) API

USD-weighted cost basis distribution across percentile bands

Request

GET
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/METRIC_NAME"
Parameters & responses
Query params

Authorization: Bearer YOUR_TOKEN (required) — your 24 character API key (also accepted: the X-API-Key header or the api_token query parameter).

resolution (optional) — 1d (default), 12h, 4h, 1h, 30m, 10m, coarsest to finest. Finer buckets are served to Advanced and Enterprise accounts, and only for the metrics that ingest them (listed per metric below); 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. On a metric keyed by exchange or tenor they apply to each series, and the keys stay where they are. A response with no time axis, such as 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, 429 when the monthly limit is reached. 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 their error texts and add code, required_plan, current_plan, feature, upgrade_url, limit and resets_at where they apply. The 429 for a used-up monthly allowance carries Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. 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.

Every 404 and 400 also carries a machine code and, where a list of valid names exists, up to 3 did_you_mean spellings, catalog_url and docs_url. Two different keys in one request are a 400 with code: conflicting_credentials. Only a successful response spends one call from the monthly allowance. A refused or failed call (any 4xx or 5xx, a conflict between credentials, an unknown path) spends nothing, and the request-rate limits are unchanged. The full list of codes is under Errors on the introduction page.

Metrics

One request per metric.

20 metrics
Metric

Allinvestor_price

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/investor_price"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,71073.24],
  [1735603200000,71171.94],
  [1735689600000,71225.49]
]
Definition & units Definition

Value: Investor price (also called capitalized price) in US dollars per bitcoin: the mean cost basis of all coins, weighted by US dollars at creation. It differs by design from the realized price, which is weighted by unspent bitcoin.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P95cost_basis_per_dollar_pct95

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct95"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,102570.0],
  [1735603200000,102420.0],
  [1735689600000,102400.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P90cost_basis_per_dollar_pct90

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct90"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,100140.0],
  [1735603200000,100080.0],
  [1735689600000,100080.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P85cost_basis_per_dollar_pct85

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct85"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,98721.0],
  [1735603200000,98679.0],
  [1735689600000,98647.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P80cost_basis_per_dollar_pct80

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct80"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,97797.0],
  [1735603200000,97766.0],
  [1735689600000,97760.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P75cost_basis_per_dollar_pct75

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct75"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,96825.0],
  [1735603200000,96717.0],
  [1735689600000,96717.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P70cost_basis_per_dollar_pct70

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct70"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,95260.0],
  [1735603200000,95047.0],
  [1735689600000,94727.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P65cost_basis_per_dollar_pct65

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct65"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,94336.0],
  [1735603200000,93739.0],
  [1735689600000,93700.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P60cost_basis_per_dollar_pct60

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct60"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,92219.0],
  [1735603200000,92345.0],
  [1735689600000,92370.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P55cost_basis_per_dollar_pct55

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct55"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,72486.0],
  [1735603200000,73517.0],
  [1735689600000,74667.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P50cost_basis_per_dollar_pct50

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct50"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,68320.0],
  [1735603200000,68363.0],
  [1735689600000,68391.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P45cost_basis_per_dollar_pct45

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct45"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,66115.0],
  [1735603200000,66290.0],
  [1735689600000,66504.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P40cost_basis_per_dollar_pct40

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct40"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,63227.0],
  [1735603200000,63625.0],
  [1735689600000,63720.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P35cost_basis_per_dollar_pct35

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct35"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,61698.0],
  [1735603200000,61764.0],
  [1735689600000,61802.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P30cost_basis_per_dollar_pct30

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct30"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,58967.0],
  [1735603200000,59052.0],
  [1735689600000,59109.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P25cost_basis_per_dollar_pct25

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct25"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,54823.0],
  [1735603200000,54955.0],
  [1735689600000,54981.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P20cost_basis_per_dollar_pct20

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct20"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,46529.0],
  [1735603200000,46747.0],
  [1735689600000,46766.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P15cost_basis_per_dollar_pct15

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct15"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,39378.0],
  [1735603200000,39402.0],
  [1735689600000,39475.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P10cost_basis_per_dollar_pct10

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct10"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,30208.0],
  [1735603200000,30219.0],
  [1735689600000,30236.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09

Metric

P05cost_basis_per_dollar_pct05

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/cost-basis-distribution-usd/cost_basis_per_dollar_pct05"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Historical · 2025-01-01
[
  [1735516800000,20712.0],
  [1735603200000,20743.0],
  [1735689600000,20748.0]
]
Definition & units Definition

Value: Percentile of the cost basis distribution, in US dollars per bitcoin, with each coin weighted by US dollars at creation rather than by bitcoin. The provider does not state how it interpolates between cost basis levels. Coins created before 2010-08-16 (about 18.6% of supply) are priced at $0 by the provider, so the lowest percentiles, including P05, can be 0.

Units: usd

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

Calendar: calendar_daily

Revision policy: append_only. A stored day is not rewritten by the regular daily update.

Universe: Bitcoin on-chain, UTXO-based.

Methodology version: 2026-10-09