Stock-to-Flow scarcity ratio (+ debated model price)

Code snippets

curl "https://api.oanor.com/bitcoinvaluation-api/v1/s2f" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/bitcoinvaluation-api/v1/s2f", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/bitcoinvaluation-api/v1/s2f");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/bitcoinvaluation-api/v1/s2f",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "Stock-to-Flow = circulating supply / realised annual issuance (the flow is measured empirically as the actual supply minted over the last 365 days, not a theoretical figure). A higher ratio means greater scarcity; each halving roughly doubles it. The s2f_model_price_usd is the much-debated PlanB S2F price model (≈0.4 × S2F³): it has historically OVER-estimated Bitcoin's price by a wide margin and is provided for reference only, NOT as a forecast or investment advice. Updates daily, cached ~10m.",
        "source": "blockchain.com charts (total-bitcoins) + Yahoo Finance (BTC-USD), keyless",
        "indicator": "Stock-to-Flow",
        "price_usd": 63604.69,
        "stock_btc": 20041547,
        "stock_to_flow": 122.3,
        "annual_flow_btc": 163900,
        "model_vs_actual": 11.5,
        "s2f_model_price_usd": 731336
    },
    "meta": {
        "timestamp": "2026-06-12T19:35:44.613Z",
        "request_id": "6b9acd93-c028-4672-8f1f-0f249da4e55c"
    },
    "status": "ok",
    "message": "Stock-to-Flow retrieved successfully",
    "success": true
}