Bitcoin Cost Basis Distribution (BTC-Weighted)

BTC-weighted cost basis distribution across percentile bands

View in Newhedge External link

How to call

Request format

GET 
curl -X GET "https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/METRIC_NAME?api_token=YOUR_TOKEN"
Query params

api_token (required) — 24 character token.

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. 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.

22 metrics
Metric

Allrealized_price

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/realized_price?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    53587.12
  ],
  [
    1790812800000,
    53609.92
  ],
  [
    1790899200000,
    53659.3
  ]
]
Definition (from the chart description)

Value: All — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P100cost_basis_max

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_max?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    125650.0
  ],
  [
    1790812800000,
    125650.0
  ],
  [
    1790899200000,
    125650.0
  ]
]
Definition (from the chart description)

Value: P100 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P95cost_basis_per_coin_pct95

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct95?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    111800.0
  ],
  [
    1790812800000,
    111800.0
  ],
  [
    1790899200000,
    111800.0
  ]
]
Definition (from the chart description)

Value: P95 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P90cost_basis_per_coin_pct90

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct90?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    104940.0
  ],
  [
    1790812800000,
    104910.0
  ],
  [
    1790899200000,
    104880.0
  ]
]
Definition (from the chart description)

Value: P90 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P85cost_basis_per_coin_pct85

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct85?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    95361.0
  ],
  [
    1790812800000,
    95303.0
  ],
  [
    1790899200000,
    95278.0
  ]
]
Definition (from the chart description)

Value: P85 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P80cost_basis_per_coin_pct80

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct80?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    88163.0
  ],
  [
    1790812800000,
    88139.0
  ],
  [
    1790899200000,
    88126.0
  ]
]
Definition (from the chart description)

Value: P80 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P75cost_basis_per_coin_pct75

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct75?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    84288.0
  ],
  [
    1790812800000,
    84301.0
  ],
  [
    1790899200000,
    84515.0
  ]
]
Definition (from the chart description)

Value: P75 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P70cost_basis_per_coin_pct70

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct70?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    83174.0
  ],
  [
    1790812800000,
    83175.0
  ],
  [
    1790899200000,
    83297.0
  ]
]
Definition (from the chart description)

Value: P70 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P65cost_basis_per_coin_pct65

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct65?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    77694.0
  ],
  [
    1790812800000,
    77705.0
  ],
  [
    1790899200000,
    77800.0
  ]
]
Definition (from the chart description)

Value: P65 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P60cost_basis_per_coin_pct60

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct60?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    71372.0
  ],
  [
    1790812800000,
    71509.0
  ],
  [
    1790899200000,
    71640.0
  ]
]
Definition (from the chart description)

Value: P60 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P55cost_basis_per_coin_pct55

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct55?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    66084.0
  ],
  [
    1790812800000,
    66120.0
  ],
  [
    1790899200000,
    66253.0
  ]
]
Definition (from the chart description)

Value: P55 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P50cost_basis_per_coin_pct50

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct50?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    63690.0
  ],
  [
    1790812800000,
    63714.0
  ],
  [
    1790899200000,
    63733.0
  ]
]
Definition (from the chart description)

Value: P50 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P45cost_basis_per_coin_pct45

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct45?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    60321.0
  ],
  [
    1790812800000,
    60321.0
  ],
  [
    1790899200000,
    60321.0
  ]
]
Definition (from the chart description)

Value: P45 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P40cost_basis_per_coin_pct40

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct40?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    43615.0
  ],
  [
    1790812800000,
    43630.0
  ],
  [
    1790899200000,
    43632.0
  ]
]
Definition (from the chart description)

Value: P40 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P35cost_basis_per_coin_pct35

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct35?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    29225.0
  ],
  [
    1790812800000,
    29241.0
  ],
  [
    1790899200000,
    29243.0
  ]
]
Definition (from the chart description)

Value: P35 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P30cost_basis_per_coin_pct30

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct30?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    16978.0
  ],
  [
    1790812800000,
    16980.0
  ],
  [
    1790899200000,
    16981.0
  ]
]
Definition (from the chart description)

Value: P30 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P25cost_basis_per_coin_pct25

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct25?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    9024.0
  ],
  [
    1790812800000,
    9027.0
  ],
  [
    1790899200000,
    9037.0
  ]
]
Definition (from the chart description)

Value: P25 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P20cost_basis_per_coin_pct20

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct20?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    3590.0
  ],
  [
    1790812800000,
    3590.0
  ],
  [
    1790899200000,
    3590.0
  ]
]
Definition (from the chart description)

Value: P20 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P15cost_basis_per_coin_pct15

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct15?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    389.0
  ],
  [
    1790812800000,
    389.0
  ],
  [
    1790899200000,
    389.0
  ]
]
Definition (from the chart description)

Value: P15 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P10cost_basis_per_coin_pct10

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct10?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    3.0
  ],
  [
    1790812800000,
    3.0
  ],
  [
    1790899200000,
    3.0
  ]
]
Definition (from the chart description)

Value: P10 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P05cost_basis_per_coin_pct05

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_per_coin_pct05?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    0.0
  ],
  [
    1790812800000,
    0.0
  ],
  [
    1790899200000,
    0.0
  ]
]
Definition (from the chart description)

Value: P05 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

P0cost_basis_min

Data used by the Bitcoin Cost Basis Distribution (BTC-Weighted) chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/cost-basis-distribution-btc/cost_basis_min?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    0.0
  ],
  [
    1790812800000,
    0.0
  ],
  [
    1790899200000,
    0.0
  ]
]
Definition (from the chart description)

Value: P0 — Bitcoin Cost Basis Distribution (BTC-Weighted): BTC-weighted cost basis distribution across percentile bands.

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. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily