21btc.cc Bitcoin Data

Live BTC price in USD and 7 other currencies (official FX reference rates). Same data as GET /api/v1/price. Read-only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

US spot Bitcoin ETFs: BTC held, fee, latest/5d/20d/cumulative flows (USD millions). Same data as GET /api/v1/etf. Read-only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Risk On/Off composite score (0–100) with every input, formula and source. Same data as GET /api/v1/risk. Read-only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Annualised realised volatility over 7/30/90/365 days and by year. Same data as GET /api/v1/volatility. Read-only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Bitcoin holders: companies, funds, governments (BTC, 7-day change). Same data as GET /api/v1/holders. Read-only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Rainbow model fit parameters and today's deviation (a model, not a forecast). Same data as GET /api/v1/rainbow. Read-only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Stock-to-flow ratio and PlanB 2019 model value (a model, not a forecast). Same data as GET /api/v1/stock-to-flow. Read-only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Bitcoin network now: block height, hashrate (EH/s), difficulty and the next difficulty adjustment, mempool size, average block time, halving countdown. Sources: mempool.space, blockchain.info, Blockchair. Read-only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Recommended Bitcoin transaction fees in sat/vB (fastest, 30 minutes, 1 hour, economy, minimum) and mempool size, from mempool.space. Read-only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

BTC perpetual futures on Binance, Bybit, OKX and Deribit: open interest (BTC and USD), mark price, funding rate per interval and annualised, a 30-day Binance open interest history and recent OKX liquidations. Public keyless exchange APIs, cached 60 seconds. Liquidations cover one exchange only; no free all-exchange total exists. Not advice. Read-only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

How many Bitcoin addresses hold at least 0.1, 1, 10, 100, 1,000 and 10,000 BTC and how coins split across holder classes. Addresses, not people. Source: BitInfoCharts and four cross-checks, with an as-of date. Read-only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Search the site's pages, Bitcoin glossary terms, wiki articles, blog posts, videos, pools, wallets and hacks. Matches English and Russian. Returns title, kind, URL and a short summary. Use kind=glossary for definitions. Read-only.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Words to look for, English or Russian",
      "maxLength": 200
    },
    "kind": {
      "type": "string",
      "enum": [
        "section",
        "blog",
        "glossary",
        "wiki",
        "video",
        "pool",
        "wallet",
        "museum",
        "hack"
      ],
      "description": "Limit to one kind of result"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 8
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "ru"
      ],
      "default": "en",
      "description": "Language of titles and summaries"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Upcoming Bitcoin-only conferences with dates, city, official URL, ticket offer (price only where verified on the official page) and the 21btc.cc event page where one exists. Dates in the venue's local time. Read-only.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "default": 15
    },
    "country": {
      "type": "string",
      "description": "Filter by country name in English, e.g. Switzerland",
      "maxLength": 60
    }
  },
  "additionalProperties": false
}

Recent shipped changes to 21btc.cc with dates and links. Same data as the /changelog page and its RSS feed. Read-only.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "additionalProperties": false
}