BlockShield/Metrics/Short-Term Holder HODL Waves

Short-Term Holder HODL Waves

The share of Bitcoin supply held by short-term holders, by age band. How BlockShield keeps the whole provider response and why the percentile names its window.

Drawn on the On-Chain tabAPI /api/v1/market/onchain/hodl-waves-sthbitcoin-data.com HODL waves (keyless)

What it measures

HODL waves split the supply by how long it has been since each coin last moved. The short-term-holder view stacks the young age bands and reads their combined share of supply against price.

A rising long-age band means coins are ageing untouched — accumulation and a shrinking liquid float. A rising short-term share means supply has recently changed hands and is closer to the market.

How it is built

Nothing extra is fetched for this chart. The daily poll that feeds the single-value on-chain metrics already returns years of contiguous daily rows, all thirteen bands deep; the previous adapter kept the last row and dropped the rest in the next line. This module simply keeps the response whole.

Rows are keyed by the PROVIDER's date, not by the day we stored them. The older path stamped the local date, so a provider running a day behind was recorded a day late — invisible on a single-value card, and it moves every point on a chart.

The short-term share is internally consistent: the young bands over the sum of all bands. It needs no external supply figure and therefore cannot disagree with one.

It lives in its own table rather than widening the store that already works for the existing tab — the same choice made for the whale bands and the ETF holdings series.

What to watch

The percentile carries its window, always. Our record covers one cycle, while the reference charts people compare against are computed from a full UTXO set going back much further. 'An extreme low' is published as 'lower than X% of the days we hold, since <date>' — never as 'historically', which would borrow authority we do not have.

Age bands are mechanical. A coin that moves between two wallets of the same owner resets to the youngest band and looks like distribution.

The provider's own dating is reported, not silently inherited — if their date lags, the payload says so.

Open the live On-Chain tab →

Related metrics

Spent Output Profit Ratio (SOPR)
SOPR is the ratio of the value of spent outputs at the moment they were spent to their value when they were created.
Bitcoin Whale Band Holdings
The holder structure of the whole Bitcoin chain, banded by balance size: how many addresses sit in each band and how much BTC t….
Bitcoin Supply in Loss
A coin's cost basis is the market price on the day it last moved on-chain.
Net Unrealized Profit/Loss (NUPL)
NUPL is the share of market capitalisation that is unrealized profit: market cap minus realized cap, divided by market cap.
Every rule above is enforced in code and pinned by a test. The doctrine they all follow — NULL is not zero, partial cannot erase, an unfinished period is not evidence — is published on the methodology page.
Descriptive, not advice. Every score, band and verdict on this platform is an automated heuristic over public data and can be wrong in both directions. All metrics · Methodology · About · Dashboard