{
  "schema_version": "sg_data_download_metadata.v1",
  "id": "sg-public-miners",
  "name": "Public miners",
  "description": "Mined, sold and held per quarter, as the 11 listed miners on the roster filed it.",
  "page": "https://satoshigazette.org/data/mining/miners",
  "dictionary": "https://satoshigazette.org/data/dictionary#sg-public-miners",
  "version": "1.0.0",
  "latest": {
    "date": "2026-09-30",
    "block_height": null
  },
  "snapshot": "quarters through 30 Sep 2026 · read 10 Nov 2026",
  "licence": {
    "name": "CC BY 4.0",
    "title": "Creative Commons Attribution 4.0 International",
    "url": "https://creativecommons.org/licenses/by/4.0/",
    "covers": "Satoshi Gazette’s compilation, selection and annotations in the files offered for download.",
    "upstream": "Upstream records keep their own terms, stated per dataset. The Gazette’s articles stay under copyright."
  },
  "cite": "Satoshi Gazette Data Desk, Public miners (sg-public-miners), version 1.0.0, data through 30 Sep 2026. https://satoshigazette.org/data/downloads/sg-public-miners.json",
  "sources": [
    {
      "label": "SEC EDGAR",
      "url": "https://www.sec.gov/edgar/search/"
    },
    {
      "label": "The filings’ documents on EDGAR",
      "url": "https://www.sec.gov/Archives/edgar/data/"
    }
  ],
  "source_terms": "SEC filings are US federal records in the public domain; each row cites its accession. The SEC’s fair-access notice allows ten requests a second from a declared user agent; the Gazette’s reads stay under five.",
  "files": {
    "json": {
      "url": "https://satoshigazette.org/data/downloads/sg-public-miners.json",
      "media_type": "application/json",
      "bytes": 888643,
      "sha256": "4100d9a8ae3a71cb8b555b888c9d6b227fd6b98a69d4e2e81db12f5da70e3bd1"
    },
    "csv": {
      "url": "https://satoshigazette.org/data/downloads/sg-public-miners.csv",
      "media_type": "text/csv",
      "bytes": 459417,
      "sha256": "a8433a230783dd5f0faf514e57d801e4cd1e2560d94600ebda63c03548fa7040",
      "row_is": "One row per figure: a company, a calendar quarter and one quantity, with its state and the first place its number is printed. Quantities stated only for a longer period, the roster, the log of documents read, and every further place and quote are in the JSON.",
      "columns": [
        {
          "name": "entity",
          "note": "The company’s key in the file."
        },
        {
          "name": "company",
          "note": "The company’s name at the end of the window."
        },
        {
          "name": "cik",
          "note": "The registrant’s CIK on EDGAR."
        },
        {
          "name": "ticker",
          "note": "Its ticker."
        },
        {
          "name": "basis",
          "note": "The basis of the company’s rows, as its own reports state them: consolidated, subsidiary or parent_excluding_subsidiary."
        },
        {
          "name": "period_start",
          "note": "First day of the calendar quarter."
        },
        {
          "name": "period_end",
          "note": "Last day of the calendar quarter."
        },
        {
          "name": "fiscal_label",
          "note": "The quarter as the company’s reports name it in its fiscal year, in the Gazette’s words."
        },
        {
          "name": "field",
          "note": "Which quantity the row is: held_start, mined, sold, purchased, other_in, other_out, held_end, pledged_or_posted, lent or joint_venture_share."
        },
        {
          "name": "label",
          "note": "The filing’s own name for the row or the movement; words in square brackets are the Gazette’s."
        },
        {
          "name": "state",
          "note": "stated, derived, not_stated_in_units, none_in_complete_rollforward or not_separable; only the first two carry a number."
        },
        {
          "name": "value_btc",
          "note": "The quantity, an exact decimal in BTC; empty where the state carries no number, which is unknown, not zero. A reported nil is 0."
        },
        {
          "name": "approximate",
          "note": "true when the filing says approximately, or the like, of this number."
        },
        {
          "name": "pool_fee_basis",
          "note": "For a mined figure with a number, as the filing says of that number: after_pool_fees, before_pool_fees, or not_said where it is silent or says both."
        },
        {
          "name": "derivation",
          "note": "For a derived figure, the arithmetic in words; its components are in the JSON."
        },
        {
          "name": "basis_note",
          "note": "What the number contains or leaves out, and for a pledged, posted or lent quantity whether it sits inside the held figure or beside it."
        },
        {
          "name": "sources",
          "note": "How many places the JSON holds for the figure."
        },
        {
          "name": "receipt_form",
          "note": "The form of the filing the number is printed in; for a derived figure, the first number of its arithmetic."
        },
        {
          "name": "receipt_accession",
          "note": "That filing’s EDGAR accession number."
        },
        {
          "name": "receipt_filed_on",
          "note": "The day that filing was made."
        },
        {
          "name": "receipt_document_url",
          "note": "Address of the document the number is printed in, on sec.gov."
        },
        {
          "name": "receipt_locator",
          "note": "Where in that document the number stands."
        },
        {
          "name": "receipt_covers_start",
          "note": "First day of the period the printed number covers; the day itself for a balance."
        },
        {
          "name": "receipt_covers_end",
          "note": "Last day of the period the printed number covers."
        },
        {
          "name": "longer_period",
          "note": "true when the row has no number and the JSON’s spans hold this quantity for a longer period that takes in the quarter; the longer period’s number is in the JSON and is never divided."
        },
        {
          "name": "later_values",
          "note": "How many different numbers later reports print for the same period; each is in the JSON, and the first-reported value stands."
        }
      ]
    }
  },
  "csv_absent": null,
  "notes": [
    "Filed figures, read from each company’s own SEC reports: not a count of what public miners as a whole mined or sold. A figure with no number has an empty value_btc and a state that says why, which is unknown, not zero. The file holds no amount of money: its numbers are bitcoin quantities, and beside them stand dates, form types, accession numbers and the Gazette’s notes in words; mined minus sold and the roll-forward remainder are worked out on the page and are in no file."
  ]
}
