Bitcoin Cost Basis Distribution (USD-Weighted)

USD-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-usd/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.

20 metrics
Metric

Allinvestor_price

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: All — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct95

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P95 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct90

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P90 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct85

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P85 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct80

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P80 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct75

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P75 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct70

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P70 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct65

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P65 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct60

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P60 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct55

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P55 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct50

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P50 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct45

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P45 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct40

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P40 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct35

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P35 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct30

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P30 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct25

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P25 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct20

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P20 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct15

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P15 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct10

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P10 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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_dollar_pct05

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

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

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

Replace `YOUR_TOKEN` with your API token.

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

Value: P05 — Bitcoin Cost Basis Distribution (USD-Weighted): USD-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