URPD Heatmap Supply
Two-dimensional heatmap of time by price bucket, intensity encoding absolute supply at each level across history.
What is it?
URPD Heatmap Supply materialises the temporal dynamics of URPD distribution. Each column is a date, each row is a price bucket, and color intensity encodes the BTC supply held at that price on that date. The result is a 2D map that reveals how the distribution evolves, where lasting anchors form, and how bull/bear phases redraw the cost basis base. The full temporal dimension replaces 1D snapshots with a historical overview.
How to read
The horizontal axis is temporal (dates, weekly sampling). The vertical axis is USD price (log recommended for multi-cycle amplitude). Color intensity is BTC supply. Dense horizontal bands = price anchors where significant supply persists over time. Bright vertical bands = massive inflow on a given date (often around a halving or institutional event). Dark zones = little supply at these levels. The Trinity rendering uses a unified architecture: BTC price in the top panel (log scale + date marker), aggregated URPD distribution in the bottom panel (bars + `% cumulative` line on the inner right axis), vertical spot marker on the X axis, and on-canvas statistics panel.
Key zones
Persistent bright horizontal bands = long-term structural supports (LTH-dominant). Recent bright vertical bands = post-halving or post-spot-launch inflow. Ascending diagonal migration = price anchors moving upward across cycles (secular growth). Dark zones above historical spot = levels not yet reached by the holder base.
What to observe
Three structural patterns: (1) Formation of a new dense band at a new price plateau = cycle anchor under construction. (2) Preservation of an old bright band over several years = unaltered massive HODL. (3) Slow translation of a bright band upward over months = gradual cost basis rotation to higher levels (typical of post-bear). To explore this chart in institutional mode : the default **Minimal** mode maximises data legibility (compact stats + period presets 1D/7D/1M/3M/6M/1Y/Now + precise date picker). The **⚙️ Expert** button reveals advanced tools : **🎯 Highlight profit** toggle (dims loss BTC to emphasise the support profit zone), **🔍 Hide outliers** toggle (hides the top 1% extreme spikes to zoom on the main distribution), and the clickable historical events bar with badges (▲ cycle tops, ▼ bottoms, ⚡ macro shocks). The **📊 Compare** button opens a second date picker and renders a delta summary card between the 2 snapshots (supply change, profit zone, top accumulation and top distribution per price bucket). The **📥 Export** button offers PNG (all tiers, with trinityinsights.io watermark + logo + copyright) and CSV (Performance+ only, with traceability metadata : slug, date, spot, mode, locale, generation timestamp). Keyboard shortcuts : A/D navigate dates, W/S toggle BTC↔USD, 1-7 select presets, R returns to latest snapshot, ? opens full help. The X axis carries the **acquisition price (USD)** and the inner right line shows the **% BTC cumulative** (cumulative share of BTC below each price level). The URL retains full state for sharing (`?date=YYYY-MM-DD&w=BTC|USD&expert=1&compare=YYYY-MM-DD`).
Historical context
Across the full Bitcoin network history, major URPD anchors correspond to cycle bottoms: each historical bear market has left a dense band at its capitulation prices. The halving progressively redraws the distribution by concentrating recent acquisitions around the post-halving market price.
Expert notes
This heatmap is the reference tool for long-term structural analysis of the Bitcoin market. Crossed with cost-basis-distribution-heatmap (which aggregates realized_cap instead of supply), it gives two complementary perspectives: unit concentration vs capital concentration.
Common mistakes to avoid
Do not confuse color intensity with active defense: the heatmap shows where supply is positioned, not how holders will react. Large bright bands can empty quickly during systemic capitulation. Read as structural cartography, not as target planning.
Programmatic access
REST API
curl -sS \
'https://api.trinityinsights.io/api/v1/onchain/urpd-heatmap-supply/history?days=90' \
-H 'X-API-Key: $TRINITY_API_KEY'MCP server
{
"tool": "get_chart_value",
"metric_id": "urpd-heatmap-supply",
"timeframe": "1y"
}Required tier: performance. 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.