{
  "profile": "data-package",
  "name": "coinbucha-open-data",
  "title": "CoinBucha open datasets",
  "description": "Every public CoinBucha dataset: Bitcoin signals, sovereign reserves and snapshots, corporate treasury totals, hiring counts, network hashrate and the Listed Bitcoin Index. Information, not financial advice.",
  "homepage": "https://coinbucha.com/data",
  "version": "2026-10-04",
  "licenses": [
    {
      "path": "https://coinbucha.com/methodology#terms",
      "title": "CoinBucha terms: reuse with attribution; third-party figures keep their sources' rights"
    }
  ],
  "contributors": [
    {
      "title": "CoinBucha",
      "path": "https://coinbucha.com",
      "role": "publisher"
    }
  ],
  "resources": [
    {
      "name": "signals-json",
      "title": "Bitcoin signals",
      "description": "One row per current signal: its value, 0–100 strength, direction, the one-line reason and its sources.",
      "path": "https://coinbucha.com/signals.json",
      "format": "json",
      "mediatype": "application/json",
      "profile": "data-resource",
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "CoinGecko API: /companies/public_treasury/bitcoin (treasury totals) and /simple/price (BTC reference price)"
        }
      ]
    },
    {
      "name": "signals-csv",
      "title": "Bitcoin signals",
      "description": "One row per current signal: its value, 0–100 strength, direction, the one-line reason and its sources.",
      "path": "https://coinbucha.com/data/signals.csv",
      "format": "csv",
      "mediatype": "text/csv",
      "profile": "tabular-data-resource",
      "encoding": "utf-8",
      "dialect": {
        "delimiter": ",",
        "lineTerminator": "\r\n",
        "header": true
      },
      "schema": {
        "fields": [
          {
            "name": "type",
            "type": "string",
            "description": "Signal key, e.g. sovereign_adoption."
          },
          {
            "name": "title",
            "type": "string",
            "description": "Signal name."
          },
          {
            "name": "value",
            "type": "number",
            "description": "The observed figure, in `unit`."
          },
          {
            "name": "unit",
            "type": "string",
            "description": "Unit of `value`."
          },
          {
            "name": "signal_strength",
            "type": "integer",
            "description": "0–100 strength score (CoinBucha's)."
          },
          {
            "name": "direction",
            "type": "string",
            "description": "tailwind, headwind or neutral (CoinBucha's)."
          },
          {
            "name": "validated",
            "type": "boolean",
            "description": "Whether the predictive claim is backtested."
          },
          {
            "name": "as_of",
            "type": "date",
            "description": "Date of the reading."
          },
          {
            "name": "why",
            "type": "string",
            "description": "One-line reason for the score."
          },
          {
            "name": "sources",
            "type": "string",
            "description": "Source URLs, pipe-separated."
          }
        ]
      },
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "CoinGecko API: /companies/public_treasury/bitcoin (treasury totals) and /simple/price (BTC reference price)"
        }
      ]
    },
    {
      "name": "sovereigns-json",
      "title": "Sovereign Bitcoin reserves (live)",
      "description": "One row per tracked state: Bitcoin held, status, tier, provenance grade and sources.",
      "path": "https://coinbucha.com/sovereigns.json",
      "format": "json",
      "mediatype": "application/json",
      "profile": "data-resource",
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "press, trackers and Wikipedia pages cited per country"
        }
      ]
    },
    {
      "name": "sovereigns-csv",
      "title": "Sovereign Bitcoin reserves (live)",
      "description": "One row per tracked state: Bitcoin held, status, tier, provenance grade and sources.",
      "path": "https://coinbucha.com/data/sovereigns.csv",
      "format": "csv",
      "mediatype": "text/csv",
      "profile": "tabular-data-resource",
      "encoding": "utf-8",
      "dialect": {
        "delimiter": ",",
        "lineTerminator": "\r\n",
        "header": true
      },
      "schema": {
        "fields": [
          {
            "name": "country_code",
            "type": "string",
            "description": "ISO 3166-1 alpha-2 code."
          },
          {
            "name": "country_name",
            "type": "string",
            "description": "Country name."
          },
          {
            "name": "holdings_btc",
            "type": "number",
            "description": "Bitcoin held, as reported by the row's sources."
          },
          {
            "name": "status",
            "type": "string",
            "description": "CoinBucha's status class, e.g. strategic_reserve."
          },
          {
            "name": "tier",
            "type": "integer",
            "description": "Holding tier; 1 = largest holders."
          },
          {
            "name": "as_of",
            "type": "date",
            "description": "Date the holding is established at."
          },
          {
            "name": "source_quality",
            "type": "string",
            "description": "primary = the state's own publication; secondary = reported."
          },
          {
            "name": "sources",
            "type": "string",
            "description": "Source URLs, pipe-separated."
          }
        ]
      },
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "press, trackers and Wikipedia pages cited per country"
        }
      ]
    },
    {
      "name": "sovereign-snapshots-2026-10-01-json",
      "title": "State of Sovereign Bitcoin — dated snapshots",
      "description": "The sovereign table frozen on a date and never revised; one row per state per snapshot.",
      "path": "https://coinbucha.com/sovereign-snapshots/2026-10-01.json",
      "format": "json",
      "mediatype": "application/json",
      "profile": "data-resource",
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "press, trackers and Wikipedia pages cited per country"
        },
        {
          "title": "CoinGecko API: /companies/public_treasury/bitcoin (treasury totals) and /simple/price (BTC reference price)"
        }
      ]
    },
    {
      "name": "sovereign-snapshots-2026-09-04-json",
      "title": "State of Sovereign Bitcoin — dated snapshots",
      "description": "The sovereign table frozen on a date and never revised; one row per state per snapshot.",
      "path": "https://coinbucha.com/sovereign-snapshots/2026-09-04.json",
      "format": "json",
      "mediatype": "application/json",
      "profile": "data-resource",
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "press, trackers and Wikipedia pages cited per country"
        },
        {
          "title": "CoinGecko API: /companies/public_treasury/bitcoin (treasury totals) and /simple/price (BTC reference price)"
        }
      ]
    },
    {
      "name": "sovereign-snapshots-2026-10-01-csv",
      "title": "State of Sovereign Bitcoin — dated snapshots",
      "description": "The sovereign table frozen on a date and never revised; one row per state per snapshot.",
      "path": "https://coinbucha.com/sovereign-snapshots/2026-10-01.csv",
      "format": "csv",
      "mediatype": "text/csv",
      "profile": "data-resource",
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "press, trackers and Wikipedia pages cited per country"
        },
        {
          "title": "CoinGecko API: /companies/public_treasury/bitcoin (treasury totals) and /simple/price (BTC reference price)"
        }
      ]
    },
    {
      "name": "sovereign-snapshots-2026-09-04-csv",
      "title": "State of Sovereign Bitcoin — dated snapshots",
      "description": "The sovereign table frozen on a date and never revised; one row per state per snapshot.",
      "path": "https://coinbucha.com/sovereign-snapshots/2026-09-04.csv",
      "format": "csv",
      "mediatype": "text/csv",
      "profile": "data-resource",
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "press, trackers and Wikipedia pages cited per country"
        },
        {
          "title": "CoinGecko API: /companies/public_treasury/bitcoin (treasury totals) and /simple/price (BTC reference price)"
        }
      ]
    },
    {
      "name": "sovereign-events-events-json",
      "title": "Sovereign Bitcoin events",
      "description": "One row per dated state action on Bitcoin — legislation, purchases, seizures — with its source.",
      "path": "https://coinbucha.com/events.json",
      "format": "json",
      "mediatype": "application/json",
      "profile": "data-resource",
      "sources": [
        {
          "title": "press, trackers and Wikipedia pages cited per country"
        }
      ]
    },
    {
      "name": "sovereign-events-csv",
      "title": "Sovereign Bitcoin events",
      "description": "One row per dated state action on Bitcoin — legislation, purchases, seizures — with its source.",
      "path": "https://coinbucha.com/data/sovereign-events.csv",
      "format": "csv",
      "mediatype": "text/csv",
      "profile": "tabular-data-resource",
      "encoding": "utf-8",
      "dialect": {
        "delimiter": ",",
        "lineTerminator": "\r\n",
        "header": true
      },
      "schema": {
        "fields": [
          {
            "name": "date",
            "type": "date",
            "description": "Date of the event."
          },
          {
            "name": "country_code",
            "type": "string",
            "description": "ISO 3166-1 alpha-2 code."
          },
          {
            "name": "type",
            "type": "string",
            "description": "Event class, e.g. legislation."
          },
          {
            "name": "headline",
            "type": "string",
            "description": "What happened, in one line."
          },
          {
            "name": "source_url",
            "type": "string",
            "description": "Where it is reported."
          }
        ]
      },
      "sources": [
        {
          "title": "press, trackers and Wikipedia pages cited per country"
        }
      ]
    },
    {
      "name": "treasury-history-treasury-json",
      "title": "Corporate Bitcoin treasuries — daily total",
      "description": "One row per day: total Bitcoin held by the public companies in the tracked feed.",
      "path": "https://coinbucha.com/treasury.json",
      "format": "json",
      "mediatype": "application/json",
      "profile": "data-resource",
      "sources": [
        {
          "title": "CoinGecko API: /companies/public_treasury/bitcoin (treasury totals) and /simple/price (BTC reference price)"
        },
        {
          "title": "Yahoo Finance chart endpoint (query1.finance.yahoo.com/v8/finance/chart)"
        },
        {
          "title": "stockanalysis.com statistics pages"
        }
      ]
    },
    {
      "name": "treasury-history-csv",
      "title": "Corporate Bitcoin treasuries — daily total",
      "description": "One row per day: total Bitcoin held by the public companies in the tracked feed.",
      "path": "https://coinbucha.com/data/treasury-history.csv",
      "format": "csv",
      "mediatype": "text/csv",
      "profile": "tabular-data-resource",
      "encoding": "utf-8",
      "dialect": {
        "delimiter": ",",
        "lineTerminator": "\r\n",
        "header": true
      },
      "schema": {
        "fields": [
          {
            "name": "date",
            "type": "date",
            "description": "Day of the reading."
          },
          {
            "name": "total_btc",
            "type": "integer",
            "description": "Total Bitcoin held by tracked public companies."
          }
        ]
      },
      "sources": [
        {
          "title": "CoinGecko API: /companies/public_treasury/bitcoin (treasury totals) and /simple/price (BTC reference price)"
        },
        {
          "title": "Yahoo Finance chart endpoint (query1.finance.yahoo.com/v8/finance/chart)"
        },
        {
          "title": "stockanalysis.com statistics pages"
        }
      ]
    },
    {
      "name": "hiring-history-hiring-json",
      "title": "Bitcoin hiring — open roles by day",
      "description": "One row per employer per day: open roles counted on the employer's own job board.",
      "path": "https://coinbucha.com/hiring.json",
      "format": "json",
      "mediatype": "application/json",
      "profile": "data-resource",
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "Greenhouse Job Board API (boards-api.greenhouse.io)"
        },
        {
          "title": "Ashby Job Postings API (api.ashbyhq.com/posting-api)"
        }
      ]
    },
    {
      "name": "hiring-history-csv",
      "title": "Bitcoin hiring — open roles by day",
      "description": "One row per employer per day: open roles counted on the employer's own job board.",
      "path": "https://coinbucha.com/data/hiring-history.csv",
      "format": "csv",
      "mediatype": "text/csv",
      "profile": "tabular-data-resource",
      "encoding": "utf-8",
      "dialect": {
        "delimiter": ",",
        "lineTerminator": "\r\n",
        "header": true
      },
      "schema": {
        "fields": [
          {
            "name": "date",
            "type": "date",
            "description": "Day of the count."
          },
          {
            "name": "company",
            "type": "string",
            "description": "Employer."
          },
          {
            "name": "ticker",
            "type": "string",
            "description": "Employer's ticker, where listed."
          },
          {
            "name": "ats",
            "type": "string",
            "description": "Job-board system the count is read from."
          },
          {
            "name": "open_roles",
            "type": "integer",
            "description": "Open postings counted that day."
          },
          {
            "name": "count_source_url",
            "type": "string",
            "description": "The job-board endpoint counted."
          }
        ]
      },
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "Greenhouse Job Board API (boards-api.greenhouse.io)"
        },
        {
          "title": "Ashby Job Postings API (api.ashbyhq.com/posting-api)"
        }
      ]
    },
    {
      "name": "network-hashrate-network-json",
      "title": "Bitcoin network hashrate",
      "description": "One row per sampled day: network hashrate in EH/s.",
      "path": "https://coinbucha.com/network.json",
      "format": "json",
      "mediatype": "application/json",
      "profile": "data-resource",
      "sources": [
        {
          "title": "blockchain.com charts API (api.blockchain.info/charts/hash-rate)"
        }
      ]
    },
    {
      "name": "listed-bitcoin-json",
      "title": "Listed Bitcoin Index — constituents",
      "description": "One row per admitted company: Bitcoin held, share count and listing, each with its primary source and access date.",
      "path": "https://coinbucha.com/listed-bitcoin.json",
      "format": "json",
      "mediatype": "application/json",
      "profile": "data-resource",
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "SEC EDGAR filings (8-K, 10-Q, 10-K, 6-K, 20-F)"
        },
        {
          "title": "non-US exchange filings and listing records, issuers' own investor-relations releases"
        },
        {
          "title": "Yahoo Finance chart endpoint (query1.finance.yahoo.com/v8/finance/chart)"
        }
      ]
    },
    {
      "name": "listed-bitcoin-csv",
      "title": "Listed Bitcoin Index — constituents",
      "description": "One row per admitted company: Bitcoin held, share count and listing, each with its primary source and access date.",
      "path": "https://coinbucha.com/data/listed-bitcoin.csv",
      "format": "csv",
      "mediatype": "text/csv",
      "profile": "tabular-data-resource",
      "encoding": "utf-8",
      "dialect": {
        "delimiter": ",",
        "lineTerminator": "\r\n",
        "header": true
      },
      "schema": {
        "fields": [
          {
            "name": "cb_id",
            "type": "string",
            "description": "Permanent CoinBucha ID (the ID table)."
          },
          {
            "name": "id",
            "type": "string",
            "description": "Company slug; the page is /listed-bitcoin/<id>."
          },
          {
            "name": "name",
            "type": "string",
            "description": "Company name."
          },
          {
            "name": "venue",
            "type": "string",
            "description": "Primary listing venue."
          },
          {
            "name": "ticker",
            "type": "string",
            "description": "Ticker on that venue."
          },
          {
            "name": "country",
            "type": "string",
            "description": "Listing country."
          },
          {
            "name": "holdings_btc",
            "type": "number",
            "description": "Bitcoin held, as disclosed."
          },
          {
            "name": "holdings_as_of",
            "type": "date",
            "description": "Date the disclosed holding is stated at."
          },
          {
            "name": "holdings_source_url",
            "type": "string",
            "description": "The disclosure."
          },
          {
            "name": "holdings_accessed",
            "type": "date",
            "description": "Date the disclosure was read."
          },
          {
            "name": "shares_m",
            "type": "number",
            "description": "Shares outstanding, millions."
          },
          {
            "name": "shares_as_of",
            "type": "date",
            "description": "Date the share count is stated at."
          },
          {
            "name": "shares_source_url",
            "type": "string",
            "description": "The document stating the share count."
          },
          {
            "name": "shares_accessed",
            "type": "date",
            "description": "Date that document was read."
          },
          {
            "name": "listing_source_url",
            "type": "string",
            "description": "The listing record."
          }
        ]
      },
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "SEC EDGAR filings (8-K, 10-Q, 10-K, 6-K, 20-F)"
        },
        {
          "title": "non-US exchange filings and listing records, issuers' own investor-relations releases"
        },
        {
          "title": "Yahoo Finance chart endpoint (query1.finance.yahoo.com/v8/finance/chart)"
        }
      ]
    },
    {
      "name": "listed-bitcoin-series-json",
      "title": "Listed Bitcoin Index — level series",
      "description": "One row per recorded data date, append-only and hash-chained; a withdrawn row stays, voided by a later one.",
      "path": "https://coinbucha.com/listed-bitcoin-series.json",
      "format": "json",
      "mediatype": "application/json",
      "profile": "data-resource",
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "Yahoo Finance chart endpoint (query1.finance.yahoo.com/v8/finance/chart)"
        }
      ]
    },
    {
      "name": "listed-bitcoin-series-csv",
      "title": "Listed Bitcoin Index — level series",
      "description": "One row per recorded data date, append-only and hash-chained; a withdrawn row stays, voided by a later one.",
      "path": "https://coinbucha.com/data/listed-bitcoin-series.csv",
      "format": "csv",
      "mediatype": "text/csv",
      "profile": "tabular-data-resource",
      "encoding": "utf-8",
      "dialect": {
        "delimiter": ",",
        "lineTerminator": "\r\n",
        "header": true
      },
      "schema": {
        "fields": [
          {
            "name": "date",
            "type": "date",
            "description": "Data date of the row."
          },
          {
            "name": "status",
            "type": "string",
            "description": "level, or void for a row that withdraws an earlier one."
          },
          {
            "name": "effective",
            "type": "boolean",
            "description": "true if the row is in the level series (neither void nor withdrawn)."
          },
          {
            "name": "level",
            "type": "number",
            "description": "Index level (base 100)."
          },
          {
            "name": "methodology_version",
            "type": "string",
            "description": "Methodology the level was computed under."
          },
          {
            "name": "constituent_count",
            "type": "integer",
            "description": "Constituents in the row."
          },
          {
            "name": "priced_rows",
            "type": "integer",
            "description": "Constituents priced on the data date."
          },
          {
            "name": "stale_rows",
            "type": "integer",
            "description": "Constituents carried from an earlier close."
          },
          {
            "name": "divisor_usd",
            "type": "number",
            "description": "Index divisor."
          },
          {
            "name": "base_value",
            "type": "integer",
            "description": "Base level."
          },
          {
            "name": "supersedes",
            "type": "string",
            "description": "For a void row: the row_sha256 it withdraws."
          },
          {
            "name": "inputs_sha256",
            "type": "string",
            "description": "SHA-256 of the row's `inputs` array as served in the JSON (the closes are not in this file)."
          },
          {
            "name": "prev_sha256",
            "type": "string",
            "description": "row_sha256 of the previous row (the chain)."
          },
          {
            "name": "row_sha256",
            "type": "string",
            "description": "SHA-256 of the row as served in the JSON; verify against the JSON."
          }
        ]
      },
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "Yahoo Finance chart endpoint (query1.finance.yahoo.com/v8/finance/chart)"
        }
      ]
    },
    {
      "name": "listed-ids-ids-json",
      "title": "Listed Bitcoin ID table",
      "description": "One permanent CoinBucha ID per company the register has considered; a ticker change never changes it.",
      "path": "https://coinbucha.com/api/listed-bitcoin/ids.json",
      "format": "json",
      "mediatype": "application/json",
      "profile": "data-resource",
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "non-US exchange filings and listing records, issuers' own investor-relations releases"
        }
      ]
    },
    {
      "name": "listed-ids-ids-csv",
      "title": "Listed Bitcoin ID table",
      "description": "One permanent CoinBucha ID per company the register has considered; a ticker change never changes it.",
      "path": "https://coinbucha.com/api/listed-bitcoin/ids.csv",
      "format": "csv",
      "mediatype": "text/csv",
      "profile": "data-resource",
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        },
        {
          "title": "non-US exchange filings and listing records, issuers' own investor-relations releases"
        }
      ]
    },
    {
      "name": "daily-brew-signals-json",
      "title": "Daily Brew archive",
      "description": "One row per published Daily Brew: the date and its headline.",
      "path": "https://coinbucha.com/signals.json",
      "format": "json",
      "mediatype": "application/json",
      "profile": "data-resource",
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        }
      ]
    },
    {
      "name": "daily-brew-brew-archive-json",
      "title": "Daily Brew archive",
      "description": "One row per published Daily Brew: the date and its headline.",
      "path": "https://coinbucha.com/brew-archive.json",
      "format": "json",
      "mediatype": "application/json",
      "profile": "data-resource",
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        }
      ]
    },
    {
      "name": "daily-brew-csv",
      "title": "Daily Brew archive",
      "description": "One row per published Daily Brew: the date and its headline.",
      "path": "https://coinbucha.com/data/daily-brew.csv",
      "format": "csv",
      "mediatype": "text/csv",
      "profile": "tabular-data-resource",
      "encoding": "utf-8",
      "dialect": {
        "delimiter": ",",
        "lineTerminator": "\r\n",
        "header": true
      },
      "schema": {
        "fields": [
          {
            "name": "date",
            "type": "date",
            "description": "Day the brew covers; the page is /brew/<date>."
          },
          {
            "name": "headline",
            "type": "string",
            "description": "The brew's headline."
          }
        ]
      },
      "sources": [
        {
          "title": "CoinBucha's own work: signal strengths and directions, sovereign status and tier, index levels, the ID table, ATS role counts as counted, the Daily Brew"
        }
      ]
    }
  ]
}