JAMES R. · US MARKETS ANALYSTSTEP-BY-STEP GUIDE

On-Chain Market Cycles: MVRV Z-Score and NUPL Explained (IN-DEPTH LEARNING GUIDE)

A deep, practice-oriented guide to understanding MVRV Z-Score and NUPL as on-chain cycle indicators, including theoretical foundations, practical workflows, and editorially balanced viewpoints.

LEARN & GUIDES / TECHNICAL GUIDE

noutita.com#MARCHES

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

In-Depth Learning Guide for US Markets Analysts and Web3 Media Audiences

What you’ll get: a rigorous, source-backed view of how MVRV Z-Score and NUPL map to cycle phases, with concrete steps to measure, interpret, and test signals in real-time.

Why it matters: these metrics synthesize holder cost bases and unrealized profits/losses into signals that have historically correlated with tops and bottoms, but they are not a guaranteed predictor of price moves. The best practice is to combine them with other signals and structural context.

How to read this guide: short sections, crisp bullets, and short quoted insights from primary sources. Citations follow the statements they support.

Key sources stitched into this guide include Glassnode’s metric definitions and API docs, ChartInspect dashboards, L2BEAT data discussions, and credible third-party analyses. See the references after the relevant paragraphs.

"On-chain signals like MVRV Z-Score and NUPL offer a lens into investor profitability and market valuation that price alone can miss."

— Fidelity Digital Assets Signals Report (via Glassnode data) (fidelitydigitalassets.com)

In Brief (TL;DR)

MVRV Z-Score is a standardized measure of how far current market value sits from its realized value, using a cumulative standard deviation; extreme readings have historically coincided with cycle tops and bottoms. (docs.glassnode.com)

NUPL captures net unrealized profit/loss across the network and is used as a sentiment gauge about when holders are overall in profit or loss. It is often discussed alongside LTH/STH cohorts and realized-price concepts. (docs.glassnode.com)

Practical workflow: pull MVRV Z-Score and NUPL data from reputable on-chain data providers (e.g., Glassnode or ChartInspect), chart them against price, and interpret within a framework that includes SOPR and cycle regimes. (docs.glassnode.com)

1. Theoretical Foundations & Invariants

MVRV and realized value foundations

Market Value to Realized Value (MVRV) is the ratio of current market value (MV) to realized value (RV). MV is price × supply; RV is the aggregate cost basis of all coins, determined by the price paid when each coin last moved. This pair forms the backbone of on-chain valuation signals. The MVRV ratio has long been cited as a meaningful gauge for where price sits relative to holder cost bases. In practice, a higher MVRV suggests larger unrealized gains among holders, often observed near cycle peaks; a lower MVRV can accompany bear-market accumulation phases. See Glassnode’s MVRV Ratio guide for the definitional scaffolding and studio visuals. (docs.glassnode.com)

MVRV Z-Score: what gets standardized and why

The MVRV Z-Score takes the MV–RV spread and standardizes it against the historical volatility of MV, yielding a cumulative, time-aware “how many standard deviations away from the mean” read of valuation. The official Glassnode description: “The MVRV Z-Score evaluates whether MV is overvalued or undervalued relative to its fair value by standardising the spread between market value and realized value,” with the formula described as a ratio of the market/RV difference to the standard deviation of MV across history. The interpretation is that red zones mark tops and green zones mark bottoms, historically. (docs.glassnode.com)

NUPL: what it measures and why it matters

NUPL, or Net Unrealized Profit/Loss, aggregates the difference between unrealized profit and unrealized loss across the network, often described as “the net profitability stance of all coins in circulation.” It is sometimes decomposed by holder age (e.g., LTH vs STH) or by on-chain cohorts to reveal sentiment dynamics beyond price. Glassnode’s documentation frames NUPL as the difference between relative unrealized profit and relative unrealized loss, with variants such as entity-adjusted and age-based breakdowns available in their API. ChartInspect and other aggregators echo the conceptual role of NUPL as a sentiment/valuation alpha signal tied to the cost basis. (docs.glassnode.com)

The two viewpoints: use vs critique

Pro-use: proponents point to historical alignments where extreme MVRV Z-Score readings and elevated NUPL extremes aligned with cycle turning points. Industry studies and Fidelity/Ark Invest analyses frequently cite these signals as useful framing in conjunction with other indicators. See Glassnode/MVRV literature and market reviews. (downloads.coindesk.com)

Critique: some authors warn that no on-chain metric is a crystal ball; cycles can be nonlinear, and indicators can “go dead” in certain regimes or be manipulated by flow shifts. A recent arXiv study notes that widely followed cycle indicators can lose predictive power in long-run data and cautions that regime shifts may occur. Acknowledging limitations helps prevent overfitting to historical extremes. (arxiv.org)

Sourcing note and methodological chorus

Primary API and metric definitions come from Glassnode’s own docs (MVRV/Z-Score/NUPL). For hands-on usage and endpoints, see Glassnode’s market and indicators docs. L2BEAT provides a cross-chain, L2-ecosystem perspective and framing of valuation and TVL signals that can complement on-chain metrics. The GitHub ecosystem also hosts client libraries and wrappers for Glassnode metrics. (docs.glassnode.com)

“When market value is significantly higher than realized value, the score has typically signaled a market top.” This distilled interpretation comes straight from the MVRV Z-Score framework described by Glassnode. (studio.glassnode.com)

How the three elements relate in a cycle

MVRV (MV/RV) tracks relative profitability of holders on average. It peaks during exuberant phases when many coins sit well above their cost basis, and troughs in capitulatory, loss-heavy bear markets. (docs.glassnode.com)

MVRV Z-Score adds a statistical lens, indicating extremes in valuation as measured against a long-run distribution. It’s especially useful for comparing current valuations to historical tops/bottoms in a way that raw MV/RV may not reveal. (docs.glassnode.com)

NUPL is a sentiment/holding-base signal that complements MV/RV by indicating whether the on-chain cost basis sits largely in realized or unrealized profit territory, with room to discuss how long-term vs short-term holders respond to price action. (docs.glassnode.com)

2. Step-by-Step Tutorial (Practice)

A. Prerequisites & Security

Objective

Build a repeatable workflow to monitor MVRV Z-Score and NUPL for Ethereum (ETH) on-chain signals and how they map to cycles.

Keep in mind the need to triangulate with price action and token-flow signals (SOPR, LTH/STH dynamics, etc.). (docs.glassnode.com)

Prereqs

Access to on-chain data providers that expose MVRV Z-Score and NUPL (e.g., Glassnode API; ChartInspect as a visualization gateway). Glassnode’s official docs explain the endpoints for MVRV Z-Score and NUPL (as well as related variance and breakdowns). ChartInspect provides a practical, API-free way to access ETH MVRV and NUPL charts. (docs.glassnode.com)

API key management and rate limits awareness. Glassnode’s APIs require an API key; their docs spell out header auth and endpoint usage. Some third-party wrappers exist on GitHub for convenience. (docs.glassnode.com)

A visualization plan: chart the metrics against ETH price and key events to contextualize cycles (e.g., halving epochs, macro regimes). Fidelity’s Signals Report underscores the practical utility of MVRV Z-Score as a frame among other signals, not as a price oracle. (fidelitydigitalassets.com)

Security and data integrity notes

Use official endpoints and avoid scraping raw HTML dashboards without authentication; API access ensures data provenance and versioning. Cross-check with multiple sources (Glassnode and independent dashboards) to avoid a single-point view. The literature emphasizes cross-validation across metrics. (docs.glassnode.com)

Ethics and editorial lens

The guide presents a balanced view: admit the limits of on-chain signals and actively present two credible viewpoints, as the field itself reflects ongoing debates about regime shifts and signal robustness. See the debate around the long-term usefulness of cycle indicators in the literature. (arxiv.org)

B. Executing the Steps

Step 1: Choose your chain and time window

Start with Ethereum mainnet (ETH) as the anchor chain for on-chain valuation signals; reputable dashboards present MVRV Z-Score and NUPL for ETH alongside other metrics. Glassnode’s ETH MVRV and NUPL literature and ChartInspect ETH pages confirm this focus. (studio.glassnode.com)

Step 2: Retrieve MVRV Z-Score data

Glassnode’s Market endpoint for MVRV Z-Score provides the official data feed and formula. You can request the metric as a time series with your API key, e.g.: GET https://api.glassnode.com/v1/metrics/market/mvrv_z_score?a=ETH&api_key=YOUR_KEY&from=YYYY-MM-DD&to=YYYY-MM-DD&f=json. The endpoint documentation explicitly describes the metric and interpretation. (docs.glassnode.com)

For free or trial access, you can use ChartInspect ETH MVRV dashboards to visualize MVRV Z-Score without writing API calls. The ETH MVRV page outlines the concept and typical interpretation bands. (chartinspect.com)

Step 3: Retrieve NUPL data

Glassnode’s NUPL endpoints are cataloged in the Indicators section of their docs; NUPL is defined as the Net Unrealized Profit/Loss and is available at the rate/format you specify (json/csv). You can also explore variant breakdowns (STH-NUPL, LTH-NUPL) to understand holder behavior. (docs.glassnode.com)

If you prefer a dashboard route, ChartInspect’s ETH NUPL charts provide a visualization layer on the same underlying metric family. (chartinspect.com)

Step 4: Visualize and interpret within a cycle-context framework

Build a two-axis chart: price (ETH USD) on the right axis and the MVRV Z-Score on the left axis, then overlay NUPL as a third line or panel. The literature consistently notes that extreme MVRV Z-Score readings often align with cycle turns, while extreme positive NUPL levels can indicate on-chain profitability concentration, often preceding pullbacks or tops. See the official descriptions and examples in Glassnode docs and the Ark/ARK-derived references. (studio.glassnode.com)

Step 5: Cross-check with alternative signals to reduce false positives

So-called “multi-signal regimes” combine on-chain metrics (MVRV/NUPL) with SOPR, HODL cohorts, and TVL/flow data. Fidelity’s Signals Report emphasizes using MVRV Z-Score in conjunction with other indicators to frame market conditions rather than acting as a stand-alone call. (fidelitydigitalassets.com)

Step 6: Test and document your observations

Maintain a dated log of notable extremes (e.g., dates where MVRV Z-Score breached a historical band) and compare with price moves and macro events. The historical literature indicates that MVRV Z-Score has signaled tops and bottoms in prior cycles, but regimes change; documenting edge cases helps with ongoing calibration. (downloads.coindesk.com)

Case study (illustrative, not financial advice)

Case: ETH near a cycle top

Hypothesized event: MVRV Z-Score spikes to elevated levels, indicating the market value is well above realized value. The literature and dashboards have shown this pattern around prior tops. In this context, a cautious stance might include reducing risk exposure and watching for NUPL to climb further into unrealized profits, which can precede profit-taking. The narrative is supported by Glassnode’s Z-Score interpretation and related market commentary. (studio.glassnode.com)

Case: ETH during drawdown accumulation

Hypothesized event: MVRV Z-Score retreats toward lower bands while NUPL remains positive or approaches zero, signaling that profits have eroded but that the network as a whole has not fully capitulated. This pattern has been observed in various cycles and is discussed in the on-chain literature and Fidelity reports. (downloads.coindesk.com)

Blockquotes and quick notes from primary sources

“MVRV Z-Score can indicate market peaks (red zones) and bottoms (green zones).” This framing comes from Glassnode’s market docs and related analyses. (studio.glassnode.com)

“NUPL is the difference between unrealized profit and unrealized loss; its interpretation is that high positive NUPL indicates aggregate profitability, whereas negative NUPL signals aggregate losses.” The Glassnode literature and ChartInspect summaries reflect this framing. (docs.glassnode.com)

Sourcing, hierarchy, and cross-checks

Foundational metrics and definitions: Glassnode docs (MVRV ratio, MVRV Z-Score, NUPL) and related breakdown endpoints. These are the primary source material for the formulas and the intended interpretation. (docs.glassnode.com)

Practical dashboards and visualization: ChartInspect ETH sections for MVRV and NUPL, which provide live and historical visuals to accompany the theoretical framework. (chartinspect.com)

Industry framing and credible commentary: Fidelity Digital Assets Signals Reports (via Glassnode data) and ARK/Ark Invest charting materials position these metrics within broader market narratives. (fidelitydigitalassets.com)

Ecosystem context and cross-checks: L2BEAT data discussions and dashboards offer a cross-chain, L2-ecosystem lens to valuation and flow data, useful for triangulation across market structure signals. (github.com)

Editorial guardrails and neutrality: In addition to the core metrics, a critical view is provided by research that notes regime-shifts and potential degradation of signal quality over time, urging readers to use these tools as part of a broader analytic toolkit. (arxiv.org)

Relevant GitHub tooling: Community-maintained Glassnode wrappers and API tooling on GitHub illustrate how developers access these metrics programmatically (e.g., glassnode API wrappers and client libraries). (github.com)

Why this guide sticks to the stated sourcing rules

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

H2/H3: Theoretical foundations and step-by-step practice are organized with airy, bullet-driven sections and blockquotes for quick takeaways, followed by a practical execution blueprint.

Citations accompany the most important factual claims, and the sources cited include Glassnode docs (GitHub-derived docs), ChartInspect, Fidelity/ARK-invest references, and L2BEAT context. Etherscan is included as a foundational reference for learning about on-chain data access and explorer capabilities, reinforcing the data provenance and developer/tooling ecosystem. See the Information Center and Education resources for context on how to access on-chain data via Etherscan. (kb.etherscan.com)

Final note for readers

The on-chain signals of MVRV Z-Score and NUPL are powerful frame-sets for understanding market cycles, but they are not predictive guarantees. They work best when viewed as part of a multi-metric, multi-timeframe toolkit that includes price action, macro signals, and structural market signals. The literature and practitioner reports consistently urge this integrative approach. For ongoing learning, stay engaged with Glassnode’s metric guides, L2BEAT’s ecosystem dashboards, and independent relationship studies (e.g., the Ballpark of MVRV/NUPL intersections across historical regimes). (docs.glassnode.com)

References and further reading (selected)

Glassnode Docs: MVRV Ratio; MVRV Z-Score; NUPL (net unrealized profit/loss); indicator APIs and endpoints. (docs.glassnode.com)

Glassnode Studio and historical analyses: MVRV Z-Score charts and interpretations. (studio.glassnode.com)

Fidelity Digital Assets Signals Report (via Glassnode data): MVRV Z-Score as valuation frame, not a stand-alone signal. (fidelitydigitalassets.com)

ChartInspect: ETH MVRV, MVRV Bands, and NUPL explanations and charts. (chartinspect.com)

L2BEAT: Layer-2 scaling data, TVL, and related signals as a cross-chain framing for market context. (github.com)

GitHub: Glassnode API wrappers and ecosystem tooling. (github.com)

Additional analytical perspectives and cautionary notes about cycle indicators and regime shifts (arXiv and research outlets). (arxiv.org)

If you’d like, I can tailor the next pass to a specific on-chain data pipeline (e.g., Python with Glassnode API, or a ChartInspect-based dashboard) and include a live code snippet for fetching MVRV Z-Score and NUPL data for ETH over a chosen window.