# Dollar liquidity and Bitcoin supply: research record

Snapshot: 3 November 2026. Article: `/journal/bitcoin-and-liquidity-what-the-data-can-tell-us`.

## Question

What do the public series behind the word "liquidity" show, and how does the growth of dollars compare with the growth of bitcoin's supply? No price series appears here. The Bitcoin price sources we checked on 3 November 2026 do not grant publication rights without a licence or written permission (see Rights), so the article uses only series we may publish.

## Files

- `request.json`: the dataset declaration (series, verified rights).
- `raw/<ID>.csv`, `raw/<ID>.html`: FRED responses exactly as served, fetched by `scripts/research/fetch-fred.mjs` in GitHub Actions. `raw_snapshot.json`: every observation as its source string, each file's SHA-256, the header fields and the retrieval time.
- `bitcoin-blocks.json`: block hash, height and header time for the last block at or before 00:00 UTC on 1 January, 2010 to 2026, the four halving blocks, and the tip used as the as-of point. Read from mempool.space's public API; each endpoint is recorded in the file.
- `build.mjs`: offline rebuild. Validates the inputs, computes every derived number, writes `liquidity.json`, `validation.json`, the six chart SVGs and `sha256.json`. `node build.mjs` in this directory; no network, no dependencies.
- `scripts/research/chart.mjs`: the chart renderer. `scripts/research/rasterize.py`: SVG to PNG (2x) and WebP with the site font.
- Tests: `scripts/research/chart.test.mjs`, `scripts/research/liquidity.test.mjs` (in `npm test`).

## Series

| ID | Title | Units | Frequency | Adjustment | Range in snapshot | Last updated (FRED) |
| --- | --- | --- | --- | --- | --- | --- |
| M2SL | M2 | Billions of dollars | Monthly | Seasonally adjusted | 1959-01-01 to 2026-09-01 | 2026-10-27 12:01 PM CDT |
| WALCL | Total assets (less eliminations from consolidation), Wednesday level | Millions of dollars | Weekly | Not seasonally adjusted | 2002-12-18 to 2026-10-28 | 2026-10-29 3:32 PM CDT |
| WDTGAL | U.S. Treasury, General Account, Wednesday level | Millions of dollars | Weekly | Not seasonally adjusted | 2002-12-18 to 2026-10-28 | 2026-10-29 3:32 PM CDT |
| WLRRAL | Reverse repurchase agreements, Wednesday level | Millions of dollars | Weekly | Not seasonally adjusted | 2002-12-18 to 2026-10-28 | 2026-10-29 3:32 PM CDT |

Source for all four: Board of Governors of the Federal Reserve System (US), via FRED, Federal Reserve Bank of St. Louis. Retrieved 2026-11-03T02:07:17Z. Vintage: the values published as of that retrieval; M2 and H.4.1 series are revised, and a later retrieval can differ. No missing observations in any series. No smoothing anywhere.

Bitcoin block anchors retrieved 2026-11-03 (times in `bitcoin-blocks.json`). Block header times are set by miners and can differ from wall-clock time by up to about two hours; a year boundary can therefore be off by a block or two, which moves annual growth by a few thousandths of a percent.

## Rights

- FRED tags each of the four series "Public Domain: Citation Requested" (verified on each series page on 2026-11-03; URLs in `request.json`). Every chart carries the requested citation. FRED's page banner "Data in this graph are copyrighted" refers to FRED's own graph images, which we do not reuse.
- mempool.space block data are facts of the public Bitcoin chain; the file records the endpoints read.
- Bitcoin price series checked and not used: FRED CBBTCUSD (Coinbase; "Reproduction of Coinbase data in any form is prohibited except with the prior written permission of Coinbase"), CoinGecko API (plan-scoped licence and mandatory "Powered by CoinGecko" branding), Coin Metrics Community (non-commercial licence). Coinbase Exchange and Kraken API terms could not be fetched from this environment.

## Formulas

- M2 growth, year over year: `100 * (M2SL[t] / M2SL[t - 12 months] - 1)`, monthly, from 1960-01 to 2026-09 (801 rows).
- Balance-sheet series in trillions: FRED millions divided by 1,000,000.
- Assets less Treasury account and reverse repo: `WALCL - WDTGAL - WLRRAL`. A Loop XXI construct for one chart. It is not a Federal Reserve measure of reserves, liquidity or anything else.
- Bitcoin scheduled supply at a block height: the sum of block subsidies for blocks 0 through that height inclusive, 50 BTC per block halved every 210,000 blocks, computed exactly in satoshis. This is the schedule, not coins actually spendable: a few blocks claimed less than the full subsidy, and some coins are lost. The schedule overstates spendable supply by a small amount that this record does not estimate.
- Bitcoin growth in calendar year y: `100 * (supply at the start of y+1 / supply at the start of y - 1)`, where the start of a year is the last block at or before 00:00 UTC on 1 January.
- M2 growth in calendar year y: `100 * (M2SL[December y] / M2SL[December y-1] - 1)`.
- Index: `100 * value / value at 1 January 2013` (M2 uses the January 2013 monthly observation; Bitcoin uses the 2013 boundary block, 214562).

## Headline numbers (from `validation.json`)

- M2 year-over-year growth: peak 26.78% in February 2021; trough -4.66% in April 2023; negative for 15 months, December 2022 to February 2024; 5.71% in September 2026.
- Federal Reserve total assets: peak $8.97 trillion on 2022-04-13; $6.75 trillion on 2026-10-28. Treasury General Account $1.02 trillion and reverse repo $0.33 trillion on 2026-10-28; reverse repo peaked at $2.68 trillion in April 2023.
- Bitcoin scheduled supply: 10,500,000 at the first halving, 15,750,000 at the second, 18,375,000 at the third, 19,687,500 at the fourth, 20,107,246.875 at block 974318. Annual growth 14.9% in 2013, 0.8% in 2025.
- Index, 1 January 2013 = 100: M2 223 in September 2026; Bitcoin supply 189 at block 974318.

## Limits

- U.S. M2 is a U.S. aggregate. It is not global liquidity, global money or global wealth.
- Weekly Wednesday levels are snapshots; intra-week moves are not shown.
- Nothing here is a forecast, a model fit or a trading signal. The charts show history as published.

## Reproduce

```
cd assets/research/liquidity-2026-11-03 && node build.mjs
python3 -I ../../../scripts/research/rasterize.py *.svg
```

`sha256.json` lists the hash of every input and output after a build. Code version: the git commit that last touched this directory.
