NOUTITA NEWSROOMSTEP-BY-STEP GUIDE

On-Chain Market Cycles: MVRV Z-Score and NUPL Explained

An in-depth, practitioner-focused guide to Bitcoin and Ethereum on-chain valuation signals. Learn the theory, practice, and editorial debates around MVRV Z-Score and NUPL, with actionable steps and credible sources.

LEARN & GUIDES / TECHNICAL GUIDE

noutita.com#MARCHES

On-Chain Market Cycles: MVRV Z-Score and NUPL Explained

In Brief (TL;DR)

MVRV and NUPL are two cornerstone on-chain valuation metrics used to gauge where price sits relative to holders’ cost bases and profits. They are best used as a toolkit rather than stand-alone buy/sell signals.

MVRV (Market Value to Realized Value) compares the current market cap to a user-cost basis (Realized Cap). Spikes in MVRV have historically coincided with cycle tops; lows often align with capitulation/bottoming phases. (github.com)

The MVRV Z-Score takes the raw MVRV concept and standardizes it by historical volatility, helping cross-cycle comparisons. When the Z-score spikes or collapses beyond historical norms, researchers interpret that as potential inflection points. (docs.corecharts.com)

NUPL (Net Unrealized Profit/Loss) measures the network’s aggregate unrealized profits or losses as a share of market value, offering a sentiment gauge that complements MVRV signals. Zones such as extreme greed or fear have historically foreshadowed turns in the market. (docs.blocklens.co)

In practice, many analysts monitor both MVRV Z-Score and NUPL together, often alongside related metrics (SOPR, Realized Price) to triangulate cycle timing. Contemporary interpretation is informed by institutional and research reports that document how these signals behaved in recent quarters. (fidelitydigitalassets.com)

"The MVRV Z-Score is used to assess when ether is over/undervalued relative to its ‘fair value’... current readings offer context for potential tops and bottoms." — Fidelity Signals Report (Q4 2024). (fidelitydigitalassets.com)

1. Theoretical Foundations & Invariants

Bitcoin and other major assets live on-chain, and so do the cost bases and realized prices that underpin valuation metrics. This section distills how MVRV, MVRV Z-Score, and NUPL are defined, what they measure, and how researchers interpret them as part of a disciplined learning toolkit.

A. MVRV: Market Value to Realized Value

Definition in brief: The ratio of market capitalization to realized capitalization. Realized cap is often described as the aggregate cost basis of coins in circulation, computed by valuing each UTXO at its last move. In plain terms, MVRV answers: how far is the market price from the average price paid for coins currently on the chain? (github.com)

How it’s calculated (core idea): Market Cap divided by Realized Cap. In the CoinMetrics framing, MVRV = CapMrktCurUSD / CapRealUSD. This framing emphasizes overvaluation when market value runs hot relative to the cost base represented by realized value. (github.com)

Practical intuition and interpretation:

High MVRV historically signals that the market value is well above the aggregate realized cost basis, often associated with local or cycle-top phenomena.

Very low MVRV (below 1) has historically coincided with strong buying opportunities for patient accumulators. (github.com)

Where this comes from (conceptual lineage): The ratio was conceived to factor in dormant coins and the cost basis, offering a fundamental lens on price, rather than price alone. Conceptual description appears in the same GitHub-hosted documentation. (github.com)

Reference note for practitioners: MVRV has been cited as a historically reliable on-chain indicator for Bitcoin tops and bottoms by academic and industry writers, and the GitHub project maintains an interpretation that aligns with empirical observations. (github.com)

B. MVRV Z-Score: Standardizing MVRV Across Cycles

Definition and formula: The classic MVRV Z-Score measures how far current Market Cap deviates from its realized value, expressed in units of Market Cap volatility. Formally, Z-Score = (Market Cap − Realized Cap) / sigma(Market Cap), where sigma(Market Cap) is the standard deviation (volatility) of Market Cap over a chosen historical window. This formulation uses an absolute dollar spread in the numerator, and a volatility scale in the denominator to enable cross-cycle comparisons. (docs.corecharts.com)

Why the Z-score matters: By standardizing the gap with volatility, the Z-Score helps analysts compare across cycles that have grown in nominal size. A spike in the Z-Score signals a valuation extreme relative to the asset’s long-run price volatility; a sharp drop can warn of a potential regime shift. (docs.corecharts.com)

Distinction from the plain MVRV ratio: MVRV Z-Score uses an absolute price spread rather than a multiplicative ratio. This makes it more interpretable when the market cap itself is scaling over time, enabling cross-cycle comparisons. See the CoreCharts documentation for the explicit formula and a discussion of the difference from the MVRV ratio. (docs.corecharts.com)

Context from research and practitioner voices: Several industry reports and research notes describe MVRV Z-Score as a leading indicator for cycle timing, with notable attention paid to how extreme readings have aligned with peaks and troughs in prior Bitcoin cycles. (downloads.coindesk.com)

C. NUPL: Net Unrealized Profit/Loss, a Pulse of Holder Sentiment

Core definition: NUPL measures the network’s net unrealized profit or loss as a share of market value. In plain terms, it captures how much of the market’s value is held as unrealized profits vs. unrealized losses across all coins currently in circulation. One widely cited formulation is NUPL = (Market Cap − Realized Cap) / Market Cap. This normalizes unrealized profitability relative to the market’s size, producing a dimensionless reading that can be tracked across price levels and cycles. (docs.blocklens.co)

How to read the metric: Positive NUPL values indicate aggregate unrealized profits; negative values indicate unrealized losses. Broadly, the metric is mapped into zones such as “Hope/Fear,” “Optimism,” “Greed,” and “Extreme Greed,” with higher positive readings traditionally associated with distribution risk and potential tops. The Blocklens documentation explicitly outlines these zones and their interpretation. (docs.blocklens.co)

Why NUPL matters in a cycle toolkit: NUPL complements MVRV by focusing on aggregate profit/loss position across holders, rather than the price relative to cost basis alone. It has been used in research and practitioner reports to help identify distributional phases and capitulation moments, often in tandem with MVRV-related signals. (docs.blocklens.co)

Editorial note on formula debates: Some sources describe related expressions or alternative views (for instance, tying NUPL to MVRV through algebraic relationships). The most consistent, practice-oriented formulation in on-chain analytics documentation is NUPL = (Market Cap − Realized Cap) / Market Cap, which yields a reading in the range [−1, +1]. (docs.blocklens.co)

Editorial quote (contextual): In a Q4 2024 signals brief, industry researchers emphasize that MVRV Z-Score and NUPL jointly inform cycle states and sentiment, while noting that “the metric has historically marked cycle inflection points” and that valuation context should be triangulated with other metrics. This reflects a contemporary consensus about using these metrics in concert. (fidelitydigitalassets.com)

Interplay and practical use: Analysts often plot MVRV Z-Score and NUPL together with related metrics (e.g., SOPR, Realized Price) to triangulate cycle turns. The idea is that extreme MVRV Z-Score readings (valuation extremes) paired with extreme NUPL readings (greed or fear zones) strengthen the case for a potential inflection, though neither metric alone guarantees a move. See the corresponding notes in industry literature and the cited Fidelity and Blocklens sources for concrete interpretations. (fidelitydigitalassets.com)

2. Step-by-Step Tutorial (Practice)

This section translates theory into a hands-on workflow you can reproduce in a research notebook or a dashboard. It emphasizes prerequisites, data provenance, calculations, and interpretation. The steps rely on standard on-chain data practices and publicly documented formulas.

A. Prerequisites & Security

Data sources you can trust (and why): On-chain data providers (Etherscan API, Glassnode/Blocklens alternative data, and GitHub-distributed references) give you the raw inputs for MVRV, Realized Cap, and NUPL. Official Etherscan API documentation underpins how to fetch on-chain data programmatically with a single API key across chains. This ensures you’re not guessing at balances or movements when building an analysis pipeline. (etherscan.io)

Core definitions to memorize:

MVRV = Market Cap / Realized Cap (CapMrktCurUSD / CapRealUSD). Realized Cap is the sum of the USD values of coins at their last on-chain move. (github.com)

MVRV Z-Score = (Market Cap − Realized Cap) / sigma(Market Cap). Standard deviation is taken over a historical window to normalize the spread. (docs.corecharts.com)

NUPL = (Market Cap − Realized Cap) / Market Cap. This yields a unitless ratio that captures aggregate unrealized profitability as a share of market value. (docs.blocklens.co)

Security fundamentals for practitioners: Use open data responsibly, respect API rate limits, and cross-check results with multiple sources when possible. Etherscan’s API terms and rate-limits outline how to structure calls and manage keys. (etherscan.io)

Editorial stance: Treat these metrics as signals in a broader toolkit. Conflicting viewpoints exist on how predictive these metrics are in different market regimes; the best practice is to triangulate with additional signals and context. See the referenced reports for both the pros and caveats of these indicators. (fidelitydigitalassets.com)

B. Executing the Steps

Step 1. Gather inputs (Market Cap, Realized Cap) and compute MVRV

Source the two core inputs: Market Cap (current price × circulating supply) and Realized Cap (sum of UTXO values at last move, per coin). The formal definition and calculation guidance are documented in the MVRV-capability documentation. (github.com)

Example data points (illustrative; not pulled from live data here): If Market Cap = 400B and Realized Cap = 200B, MVRV = 2.0. Note: use live data from your chosen provider for real analysis results. (github.com)

Step 2. Compute MVRV Z-Score

Use the standard deviation of Market Cap over your chosen window (for Bitcoin, researchers often use long-run volatility measures; see CoreCharts’ explicit formula). Plug Market Cap and Realized Cap into the Z-Score formula: Z = (Market Cap − Realized Cap) / σ(Market Cap). (docs.corecharts.com)

Quick implementation sketch (Python-like pseudocode):

inputs: cap_market (array), cap_realized (array) over time, window size w

compute: spread = cap_market - cap_realized

compute: sigma = std(cap_market, window=w)

Z = spread / sigma

Why this matters: The Z-Score centers the current gap against historical volatility, enabling cross-cycle comparisons even as the market size grows. See the explanatory notes and the explicit formula in the CoreCharts documentation. (docs.corecharts.com)

Step 3. Compute NUPL

Compute NUPL as (Market Cap − Realized Cap) / Market Cap. This yields a unitless score between −1 and +1 that tracks the share of market value representing unrealized profits. The Blocklens documentation provides the formula and interpretation of the resulting zones. (docs.blocklens.co)

Sanity check: NUPL values above 0.75 have historically coincided with distribution phases and top-heavy sentiment; near 0 to 0.25 suggests hope/early bullishness; negative values tend to precede accumulation periods. (docs.blocklens.co)

Step 4. Visualize and interpret together

Plot MVRV Z-Score and NUPL on the same timeline alongside price. Look for confirmations or divergences: extreme high MVRV Z-Score with high NUPL often signals risk of distribution and potential top; conversely, low MVRV Z-Score with negative or low NUPL may align with accumulation. Fidelity’s Q4 2024 Signals Report explicitly treats MVRV Z-Score as a valuation gauge and notes NUPL’s role in sentiment assessment. (fidelitydigitalassets.com)

Triangulation with related metrics (SOPR, realized price): Industry researchers consistently advocate a multi-signal approach; a single metric rarely suffices to time a market. The literature and practitioner notes emphasize cross-checking with multiple indicators. (fidelitydigitalassets.com)

Step 5. Cross-check data provenance

If you’re building a live dashboard, consider sourcing from Etherscan API (multi-chain support) for granular on-chain events and movements, then corroborating with node-accurate price-derived market caps when possible. Etherscan provides a mature API layer that can underpin such workflows. (etherscan.io)

For a broader, cross-provider perspective, you can compare outputs with other public charts and APIs (e.g., Blocklens/NUPL chapters) to understand how different methodological choices affect readings. (docs.blocklens.co)

Step 6. Security & risk considerations

Privilege and data sensitivity: Don’t expose private keys or sensitive API credentials. Use read-only API clients and rate-limit your requests. Follow best practices outlined by API providers (Etherscan’s API terms and policy pages). (etherscan.io)

Interpretation caveats: Market cycles are influenced by macro forces, investor psychology, and technical dynamics. Use MVRV Z-Score and NUPL as part of a broader framework, not as a guaranteed timing signal. See the editorial debates and performance studies cited in the notes above. (fidelitydigitalassets.com)

Step 7. A quick, illustrative sanity-check (purely hypothetical)

Suppose over a given window: Market Cap = 500B, Realized Cap = 250B, σ(Market Cap) = 50B. Then MVRV = 2.0 and MVRV Z-Score = (500 − 250) / 50 = 5.0. NUPL = (500 − 250)/500 = 0.50. Interpreting this combination would require context, but a high Z-Score alongside a mid-range NUPL could hint at a valuation extreme with still-moderate unrealized profits. This illustration follows the formulas and zone vocabularies described in the cited sources. (docs.corecharts.com)

Step 8. Communicating findings responsibly

Always state the time window for the calculations, the data sources, and any assumptions (e.g., circulating supply estimates, realized price methodology). If you report time-bound values, anchor them to reliable sources and dates. For example, Fidelity’s Q4 2024 Signals Report discusses contemporaneous MVRV Z-Score readings and NUPL sentiment zones in the context of that period. (fidelitydigitalassets.com)

C. Practical Security & Tooling Notes

Data provenance is critical. When possible, cross-check on-chain inputs with multiple providers to reduce the risk of data inaccuracies propagating into your analysis. Etherscan’s API is designed to be the reference data layer, but independent cross-checks help guard against edge-case outages or data gaps. (etherscan.io)

If you’re deploying a dashboard publicly, be mindful of API usage terms and attribution requirements. Etherscan APIs require attribution and can enforce plan-based limits; structure your calls accordingly. (etherscan.io)

3. Case Studies & Editorial Debate

The research and practitioner community has produced a lively set of views on how best to read MVRV Z-Score and NUPL, especially around major BTC and ETH cycles. Here are two credible, competing perspectives you’ll commonly encounter, along with supporting data points.

A. Case for cycle-timing usefulness of MVRV Z-Score + NUPL

Proponents argue that MVRV Z-Score and NUPL together form a coherent cycle-visitation toolkit. When the Z-Score spikes to historically high levels and NUPL sits in the extreme greed zone, many analysts interpret this as a high-probability top or distribution phase. Fidelity’s Signals Report for Q4 2024 explicitly frames MVRV Z-Score as a valuation gauge and associates elevated readings with overheated sentiment, while NUPL tracks the progression of profit-taking risk. This pairing is a recurring theme in on-chain research and is reflected in the published notes and charts. (fidelitydigitalassets.com)

A complementary research note from recent years discusses how MVRV Z-Score-based strategies combine with other cycle indicators to form a more robust predictive toolkit. The literature emphasizes that extreme readings have historically aligned with market turning points (tops and bottoms). (iris.unito.it)

Editorial blockquote (illustrative):

MVRV Z-Score has historically helped identify extremes and potential tops or bottoms when used alongside NUPL and SOPR. The practical takeaway is to treat these signals as complementary rather than definitive calls, calibrating risk as volatility and macro conditions shift. (downloads.coindesk.com)

B. Case for caution: cycles can defy simple metrics

Critics point out that cycles can extend beyond historical norms, especially during periods of structural changes in market participation, macro liquidity, or regime shifts in participation (institutional entrants, retail dynamics). Some studies and academic discussions note that MVRV Z-Score readings can be part of a successful framework but should not be used in isolation, and that performance may vary by cycle context. For example, recent academic and industry overviews highlight that MVRV Z-Score strategies, while informative, do not guarantee predictive accuracy in every market phase. (iris.unito.it)

In practice, this is why many researchers advocate triangulation with multiple signals (SOPR, realized price, exchange flow, and macro indicators) before acting on a single metric. Fidelity’s reports and other industry documents consistently frame these signals as part of a broader sentiment and valuation toolkit rather than buy/sell blueprints. (fidelitydigitalassets.com)

Blockquotes and precise takeaways from these debates appear across research notes and professional reports. For readers who want to dive deeper, the Fidelity Signals Report (Q4 2024) provides contemporary, data-backed interpretation of MVRV Z-Score and NUPL in the Ethereum context, while CoreCharts and CoinMetrics GitHub pages offer the explicit formulations you can reproduce. (fidelitydigitalassets.com)

Conclusion: Building a Practical On-Chain Toolkit

The combination of MVRV, MVRV Z-Score, and NUPL offers a principled way to anchor price action in chain-based cost bases and aggregate holder psychology. The core definitions and interpretations are well-documented in on-chain analytics literature and GitHub-hosted references. (github.com)

The most actionable path is to treat these metrics as a triad within a broader framework: corroborate with SOPR and realized price signals, respect the historical context of each metric, and validate signals against macro-market conditions and risk tolerance. The best practice is synthesis, not overreliance on a single indicator. Fidelity’s and Bit-level research literature provide concrete examples of how this synthesis has played out in real market periods. (fidelitydigitalassets.com)

Sources and further reading (selected):

MVRV (Market Cap / Realized Cap) — definition and interpretation (GitHub/coinmetrics docs). https://github.com/coinmetrics/docs-website/blob/master/asset-metrics/market/capmvrvcur.md (github.com)

MVRV Z-Score formula and rationale — CoreCharts docs. https://docs.corecharts.com/metrics/mvrv-z-std/ (docs.corecharts.com)

NUPL overview, zones, and interpretation — Blocklens docs. https://docs.blocklens.co/metrics/profit/nupl (docs.blocklens.co)

NUPL relation to MVRV and cycle timing discussion — Fidelity Signals Report (Q4 2024). https://www.fidelitydigitalassets.com/sites/g/files/djuvja3256/files/dam/zgtsxd7q3m/fda_us_uk_q4_2024_signalsreport_1186059.3.0_v1.pdf (fidelitydigitalassets.com)

MVRV/Z-Score and related cycle studies (academic and industry briefs). https://iris.unito.it/retrieve/8e104076-d79e-4df7-a1fe-1f86d7630c41/1-s2.0-S0275531926002138-main.pdf (iris.unito.it)

Etherscan API documentation (the reference layer for on-chain data). https://etherscan.io/api (etherscan.io)

Etherscan API overview / apis hub (Getting started, usage, and terms). https://info.etherscan.com/apis/ (info.etherscan.com)

L2BEAT as a cross-reference for on-chain/Layer-2 data context (TVS and layer-2 market data). https://l2beat.com/layer2s/tvs (l2beat.com)

If you’d like, I can turn this into a slide deck with live code snippets to fetch MVRV, MVRV Z-Score, and NUPL from Etherscan or Blocklens data, plus a ready-to-run Python notebook to reproduce the illustrative calculations and generate a combined chart set for your publication.