Skip to content

Public API

One open endpoint. Plain JSON.

The desk and your scripts read the same public, edge-cached API. No account, no key, no paywall. Read-only.

curl, and an example response
$ curl https://btc.ochk.io/api/valuation

{
  "ok": true,
  "score": 12.2,
  "band": "deep value",
  "headline": "Bitcoin screens deeply undervalued …",
  "components": [ … ],
  "generated_at": 1782414827,
  "age_seconds": 41
}

Bundles

Every bundle is GET https://btc.ochk.io/api/<bundle> and returns { ok, …bundle, generated_at, age_seconds }. The index is at /api (opens in a new tab).

The public API's bundles
EndpointTypeDescription
/api/snapshotGETFast overview — spot, market cap, network, sentiment, key valuation rails. Open it (opens in a new tab)
/api/valuationGETComposite 0–100 valuation score — cheap vs. expensive vs. history. Open it (opens in a new tab)
/api/macroGETMacro & liquidity conditions — dollar, rates, equities, vol, Fed/M2. Open it (opens in a new tab)
/api/liquidityGETFed net liquidity — balance sheet − reverse repo − TGA, plus M2 and a BTC overlay. Open it (opens in a new tab)
/api/correlationsGETBTC↔macro correlation — rolling correlation of BTC returns vs. equities, the dollar, rates. Open it (opens in a new tab)
/api/cyclesGETCycle rails — 200WMA, Mayer bands, Pi-Cycle, drawdown, halvings. Open it (opens in a new tab)
/api/onchainGETOn-chain valuation — MVRV, MVRV-Z, realized price, active addresses. Open it (opens in a new tab)
/api/networkGETNetwork health — hashrate, difficulty, fees, Puell, NVT. Open it (opens in a new tab)
/api/treasuriesGETCorporate bitcoin treasuries — public-company BTC holdings, plus mNAV / premium to NAV for pure bitcoin-treasury companies only (miners and operating companies are listed without it). Open it (opens in a new tab)
/api/derivativesGETDerivatives — OKX perp funding history (per 8h + annualized) and daily OKX open interest. Open it (opens in a new tab)
/api/sentimentGETSentiment — Fear & Greed index, current + history. Open it (opens in a new tab)
/api/intelligenceGETAI desk read — scenarios, theses, signals, explained. It describes the data; not financial advice. Open it (opens in a new tab)
/api/tickerGETSpot price only — the lightest possible read. Open it (opens in a new tab)

Sources

Every number comes from one of these public sources. Each chart names its own.

Every source the desk reads
SourceWhat it feeds
blockchain.info (opens in a new tab)Daily price since 2010, difficulty, transactions, miner revenue, fees, NVT inputs.
Coinbase (opens in a new tab)Live spot price.
CoinGecko (opens in a new tab)Market cap, public-company treasury holdings.
mempool.space (opens in a new tab)Block height, hashrate, fee rates.
Coin Metrics (opens in a new tab)MVRV, realized cap and price, active addresses.
OKX (opens in a new tab)Perp funding, open interest.
Kraken (opens in a new tab)Spot for the Coinbase premium; perp funding and open interest in /api/snapshot.
alternative.me (opens in a new tab)Fear & greed index.
FRED (opens in a new tab)Dollar, rates, equities, Fed balance sheet, reverse repo, TGA, M2.
Nasdaq.com (opens in a new tab)Equity market caps for mNAV, from the quote summary that nasdaq.com’s own pages load (api.nasdaq.com). It is not a published API and answers only a browser’s user-agent, so we send one. Best effort: a blank mNAV means it did not answer.
Anthropic (opens in a new tab)The AI desk read at /api/intelligence (Claude, with web search).
  • Read-only

    Nothing here writes, trades, or holds anything. It is a read of public data.

  • Cached and dated

    Cached briefly: the ticker for 30 seconds, most reads for five minutes, the AI read for thirty. Most FRED series update daily; the Fed balance sheet, the Treasury account and M2 weekly. Every response says how old it is: generated_at and age_seconds.

  • No account

    No key, no signup, no rate-limit games. CORS-open, so a browser can call it.

Not financial advice

OC BTC is informational only. Bitcoin is volatile and purely speculative: you can lose your entire investment. Scores and verdicts are a structured read of public data, not a recommendation to buy, sell, or hold anything. Do your own research. See the family at ochk.io (opens in a new tab).