Skip to content

← On-chain Bitcoin

Market Tension Spectrum

Five forms of market stress, each placed within its own historical distribution rather than against the others. A low reading marks a rare state, not a calm one. The five take turns: none dominates for long.

Tier proOn-chain Bitcoinriskstresspercentiletensionextremebehaviour

What is it?

Five quantities are tracked, and they are not measured in the same unit. Realized profit, realized loss and peak regret are expressed in dollars; the quantity of coins in loss is expressed in bitcoin; seller exhaustion is a dimensionless ratio. Nothing would allow comparing them as they stand. Each is therefore replaced by a single question, put to its own past: what fraction of history is more extreme than today's value? The answer is a percentage, and that answer is what gets plotted. The five lines become comparable not because they measure the same thing, but because they all answer the same question against separate histories.

How to read

The direction of reading is inverted relative to intuition, and that is the first thing to absorb: a low value marks a rare state, therefore a tense one, while a high value marks the ordinary. A line diving toward the bottom of the frame is not weakening: it indicates that its quantity has reached a level history has rarely known. The scale is linear from zero to one hundred, because that is where the measurements live: the central half of observations sits between a few percent and a third of the frame, and rare states read as sharp dives toward the axis rather than as lines stretched over several orders of magnitude. A logarithmic toggle remains available to anyone wanting to detail the bottom of the frame. So one reads first which line descends, then how far, then how long it stays low. The price overlay is on from the moment the chart opens, because a tension only takes on meaning against the move it accompanies.

Key zones

Two thresholds structure the reading. Below one percent, the observation belongs to the most extreme hundredth of its history: over the covered period, at least one of the five families crosses that threshold roughly one day in five, which makes it a notable but not exceptional state. Below one tenth of a percent, the situation changes in nature and concerns only about one day in twenty. One fact deserves to be known before looking for convergences: across the whole available history there is not a single day on which all five families sit simultaneously below the first threshold. Waiting for the five to align means waiting for an event that has never occurred.

What to observe

Watch which of the five descends, because they do not descend together and do not tell the same story. Extreme profit taking and extreme capitulation describe opposite markets, yet they share the same frame and the same scale. Then watch the handover: over the covered period, profit taking is the family most often at its lowest, roughly one day in three, with capitulation next at about one day in five; none exceeds half the calendar. A family that stays the most tense for a long stretch is itself information. Finally watch the depth reached rather than the mere descent: crossing the first threshold is common, crossing the second markedly less so, and the gap between the two is worth more than any qualitative appreciation.

Historical context

The five families did not appear on the same day upstream: three have existed since the second halving, a fourth about fifteen months later, the fifth four months after that. The chart begins only on the first day all five coexist, which costs eighteen months of history to the three oldest but avoids two orphan lines in a frame holding five. That date was not chosen: the criterion is stated and the date is derived from it at each run, so the plot adjusts itself the day the source revises its own history. More than twelve years remain covered, or three complete cycles.

Expert notes

Three points the visual reading does not give. The first concerns relative heights: two lines sit structurally higher than the other three, and it would be wrong to read them as less tense markets. Each family is compared to its own past, and a more dispersed distribution mechanically places its median higher. The second concerns seller exhaustion, the only family read over a rolling window where the other four are read over full history: its reference past renews continuously, which explains its high position and forbids comparing its height to the others'. The third concerns the occasional interruptions in the coins-in-loss line. They are not data gaps: verification across the whole history shows they all fall, without exception, on a day when price sets its highest level of the past year. When almost no coin is in loss, the quantity no longer has a tail to measure.

Common mistakes to avoid

The first mistake, and by far the most common, is to read a low line as a calm market. It is the opposite: low means rare. The second is to compare the five lines against each other by value, as if the lower one were more tense than the higher one. They share only a scale, not an origin: each compares validly only to itself over time. The third is to add or average the five into a single index. These are percentiles, not quantities; their average has no definition and the result would be a number without a referent. The fourth is to wait for all five to descend together before concluding: that configuration has never occurred, and treating it as an entry condition amounts to never reading anything at all.

Programmatic access

REST API

curl -sS \
  'https://api.trinityinsights.io/api/v1/onchain/metrics/market-tension-spectrum/data?timeframe=90d' \
  -H 'X-API-Key: $TRINITY_API_KEY'

MCP server

{
  "tool": "get_chart_value",
  "metric_id": "market-tension-spectrum",
  "timeframe": "1y"
}

Required tier: pro. See the pricing grid for the tier list and the MCP documentation for multi-client configuration.

Related metrics

Institutional disclaimer

Trinity Insights is an educational and analytical tool. The metric above does not constitute investment advice. Trinity Insights is not a Crypto-Asset Service Provider (CASP) registered under MiCA Regulation (EU) 2023/1114. See the full disclaimer.