Bitcoin Liquid vs Illiquid Supply

Bitcoin supply split by coinflow mobility into liquid and illiquid cohorts.

Liquid supply (coins that move readily) versus illiquid supply (coins that stay dormant), from Bitview's coinflow classification model.

View in Newhedge External link

How to call

Request format

GET 
curl -X GET "https://newhedge.io/api/v2/metrics/liquid-vs-illiquid-supply/METRIC_NAME?api_token=YOUR_TOKEN"
Query params

api_token (required) — 24 character token.

resolution (optional) — day1 (default), hour12, hour4, hour1, 30mn, 10mn. Finer buckets are served to Advanced and Enterprise accounts; see Resolutions.

before (optional) — exclusive cursor, returns observations older than this timestamp_ms. Finer resolutions only.

limit (optional) — page size for finer resolutions. Default 2500, maximum 5000. Ignored for day1.

Path params

:metric_name — one of the metric names listed below.

Responses

200 with JSON payload, 401 for missing/invalid token, 404 for missing resources.

Metrics

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

2 metrics
Metric

Mobile Supply

Data used by the Bitcoin Liquid vs Illiquid Supply chart.

Endpoint 
https://newhedge.io/api/v2/metrics/liquid-vs-illiquid-supply/mobile_supply?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1788652800000,
    11853064.360917
  ],
  [
    1788739200000,
    11853887.99582255
  ],
  [
    1788825600000,
    11853216.04089907
  ]
]
Metric

Immobile Supply

Data used by the Bitcoin Liquid vs Illiquid Supply chart.

Endpoint 
https://newhedge.io/api/v2/metrics/liquid-vs-illiquid-supply/immobile_supply?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1788652800000,
    8227496.14700809
  ],
  [
    1788739200000,
    8227106.88702869
  ],
  [
    1788825600000,
    8228194.46663525
  ]
]