Bitcoin Stock to Flow Model (S2F)

Ratio of the current stock of bitcoin and flow of new production

How to call

Request format

GET
curl -X GET "https://newhedge.io/api/v2/metrics/stock-to-flow/METRIC_NAME?api_token=YOUR_TOKEN"
Query params

api_token (required) — 24 character token.

resolution (optional) — 1d only for the metrics on this chart. Any other value is refused with a 400 that names what is available; 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.

2 metrics
Metric

Stock to Flow 463 dayssf_463_days

Data used by the Bitcoin Stock to Flow Model (S2F) chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/stock-to-flow/sf_463_days?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1862092800000,
    4139721.33
  ],
  [
    1862179200000,
    4139721.33
  ],
  [
    1862265600000,
    4139721.33
  ]
]
Definition (from the chart description)

Value: Stock to Flow 463 days — Bitcoin Stock to Flow Model (S2F): Ratio of the current stock of bitcoin and flow of new production.

Units: usd

Metric

Stock to Flow 10 dayssf_10_days

Data used by the Bitcoin Stock to Flow Model (S2F) chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/stock-to-flow/sf_10_days?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1766966400000,
    1343647.55
  ],
  [
    1767052800000,
    1343754.7
  ],
  [
    1767139200000,
    1340736.01
  ]
]
Definition (from the chart description)

Value: Stock to Flow 10 days — Bitcoin Stock to Flow Model (S2F): Ratio of the current stock of bitcoin and flow of new production.