--:--:--LOCAL ·--:--UTC
    MKT CAP$2.93T+0.6%
    24H VOL$109.8B
    BTC DOM58.0%
    HEALTH75BULLISH
    SHORT-TERM67NEUTRAL
    LONG-TERM83BULLISH
    OI$14.0B
    24H LIQ$78M
    LONG/SHORT53.9% / 46.1%
    REGIME (LT)BTC-LED BULL MARKET
    REGIME (ST)SQUEEZE
    HL OI$13.0B
    WHALESSHORT 43.8%
    MKT CAP$2.93T+0.6%
    24H VOL$109.8B
    BTC DOM58.0%
    HEALTH75BULLISH
    SHORT-TERM67NEUTRAL
    LONG-TERM83BULLISH
    OI$14.0B
    24H LIQ$78M
    LONG/SHORT53.9% / 46.1%
    REGIME (LT)BTC-LED BULL MARKET
    REGIME (ST)SQUEEZE
    HL OI$13.0B
    WHALESSHORT 43.8%
    Plug real-time crypto data into your AI agent — one command: Get your free API key →
    LoginGet API Key
    Home / Trading Indicators / On-Chain Metrics

    On-Chain Metrics Indicators for Crypto Trading

    9 on-chain metrics indicators, from the AlgoBrain wiki. Signals read straight from the chain: holder profit/loss, exchange flows, miner and whale behaviour, cycle gauges. Each lists what it measures, the strategies that use it, the Crypto Data API endpoints that serve it or its inputs, and a prompt for an AI agent to compute it. All of them are in the API: GET /api/v1/indicators/catalog?group=on-chain.

    Every On-Chain Metrics indicator

    Coinbase Premium #

    Coinbase PremiumCoinbase Premium IndexCoinbase Premium Gap

    The Coinbase Premium is the price gap between Bitcoin on Coinbase (quoted in USD, dominated by US institutional and retail flow) and Bitcoin on Binance (quoted in USDT, dominated by offshore/retail flow).

    CDA endpoints/api/v1/on-chain/score/api/v1/on-chain/exchange-flows/spike-alerts/api/v1/market-intelligence/btc/cycle-indicators/api/v1/on-chain/whales
    Via API/api/v1/indicators/catalog/coinbase-premium
    AI-agent prompt
    Compute it with an AI agent
    Compute the Coinbase Premium for BTC, ETH and SOL using the CryptoDataAPI (X-API-Key header).
    
    1. Definition and parameters: GET https://cryptodataapi.com/api/v1/algobrain/page?path=wiki/concepts/market-microstructure/coinbase-premium.md
    2. Inputs:
    - GET https://cryptodataapi.com/api/v1/on-chain/score
    - GET https://cryptodataapi.com/api/v1/on-chain/exchange-flows/spike-alerts
    - GET https://cryptodataapi.com/api/v1/market-intelligence/btc/cycle-indicators
    3. Pinned: 4h bars, 500-bar lookback, the playbook's default parameters. Return the latest value, its 30-day percentile, and a one-line read of what it says now. Research only.

    Exchange Net Flows #

    Exchange Net Flowsexchange-netflowExchange NetflowExchange Net FlowExchange Reserve

    The metric rests on a simple boundary idea: an exchange is where most coins are converted to fiat or stablecoins, so the direction of flow across the exchange wallet boundary is a proxy for net intent to sell versus hold.

    CDA endpoints/api/v1/on-chain/score/api/v1/on-chain/exchange-flows/spike-alerts/api/v1/market-intelligence/btc/cycle-indicators/api/v1/on-chain/whales
    Via API/api/v1/indicators/catalog/exchange-netflow
    AI-agent prompt
    Compute it with an AI agent
    Compute the Exchange Net Flows for BTC, ETH and SOL using the CryptoDataAPI (X-API-Key header).
    
    1. Definition and parameters: GET https://cryptodataapi.com/api/v1/algobrain/page?path=wiki/concepts/metrics/exchange-netflow.md
    2. Inputs:
    - GET https://cryptodataapi.com/api/v1/on-chain/score
    - GET https://cryptodataapi.com/api/v1/on-chain/exchange-flows/spike-alerts
    - GET https://cryptodataapi.com/api/v1/market-intelligence/btc/cycle-indicators
    3. Pinned: 4h bars, 500-bar lookback, the playbook's default parameters. Return the latest value, its 30-day percentile, and a one-line read of what it says now. Research only.

    HODL Waves #

    HODL Waveshodl-wavesHODL WaveRealized Cap HODL WavesRHODL

    Every coin (more precisely, every unspent output) carries a timestamp of when it last moved. HODL Waves cohort the entire supply by that coin age:

    Used by A building block; no catalogue strategy declares it directly.
    CDA endpoints/api/v1/on-chain/score/api/v1/on-chain/exchange-flows/spike-alerts/api/v1/market-intelligence/btc/cycle-indicators/api/v1/on-chain/whales
    Via API/api/v1/indicators/catalog/hodl-waves
    AI-agent prompt
    Compute it with an AI agent
    Compute the HODL Waves for BTC, ETH and SOL using the CryptoDataAPI (X-API-Key header).
    
    1. Definition and parameters: GET https://cryptodataapi.com/api/v1/algobrain/page?path=wiki/concepts/metrics/hodl-waves.md
    2. Inputs:
    - GET https://cryptodataapi.com/api/v1/on-chain/score
    - GET https://cryptodataapi.com/api/v1/on-chain/exchange-flows/spike-alerts
    - GET https://cryptodataapi.com/api/v1/market-intelligence/btc/cycle-indicators
    3. Pinned: 4h bars, 500-bar lookback, the playbook's default parameters. Return the latest value, its 30-day percentile, and a one-line read of what it says now. Research only.

    MVRV Ratio #

    MVRVMarket Value to Realized ValueMVRV Ratiomarket-value-to-realized-value

    The MVRV Ratio (Market Value to Realized Value) is an on-chain valuation metric that divides an asset's market cap by its realized cap.

    CDA endpoints/api/v1/on-chain/score/api/v1/on-chain/exchange-flows/spike-alerts/api/v1/market-intelligence/btc/cycle-indicators/api/v1/on-chain/whales
    Via API/api/v1/indicators/catalog/mvrv
    AI-agent prompt
    Compute it with an AI agent
    Compute the MVRV Ratio for BTC, ETH and SOL using the CryptoDataAPI (X-API-Key header).
    
    1. Definition and parameters: GET https://cryptodataapi.com/api/v1/algobrain/page?path=wiki/concepts/metrics/mvrv.md
    2. Inputs:
    - GET https://cryptodataapi.com/api/v1/on-chain/score
    - GET https://cryptodataapi.com/api/v1/on-chain/exchange-flows/spike-alerts
    - GET https://cryptodataapi.com/api/v1/market-intelligence/btc/cycle-indicators
    3. Pinned: 4h bars, 500-bar lookback, the playbook's default parameters. Return the latest value, its 30-day percentile, and a one-line read of what it says now. Research only.

    MVRV Z-Score #

    MVRV Z-ScoreMVRV Z Scoremvrv-zscoreBitcoin MVRV Z-Score

    The MVRV Z-Score is a standardised version of the MVRV Ratio that expresses the gap between an asset's market cap and its realized cap in units of standard deviation.

    CDA endpoints/api/v1/on-chain/score/api/v1/on-chain/exchange-flows/spike-alerts/api/v1/market-intelligence/btc/cycle-indicators/api/v1/on-chain/whales
    Via API/api/v1/indicators/catalog/mvrv-z-score
    AI-agent prompt
    Compute it with an AI agent
    Compute the MVRV Z-Score for BTC, ETH and SOL using the CryptoDataAPI (X-API-Key header).
    
    1. Definition and parameters: GET https://cryptodataapi.com/api/v1/algobrain/page?path=wiki/concepts/metrics/mvrv-z-score.md
    2. Inputs:
    - GET https://cryptodataapi.com/api/v1/on-chain/score
    - GET https://cryptodataapi.com/api/v1/on-chain/exchange-flows/spike-alerts
    - GET https://cryptodataapi.com/api/v1/market-intelligence/btc/cycle-indicators
    3. Pinned: 4h bars, 500-bar lookback, the playbook's default parameters. Return the latest value, its 30-day percentile, and a one-line read of what it says now. Research only.

    Net Unrealized Profit/Loss (NUPL) #

    NUPLNet Unrealized Profit/LossNet Unrealized Profit Lossnet-unrealized-profit-loss

    A common variant separates the supply into long-term and short-term holder cohorts (LTH-NUPL / STH-NUPL), and entity-adjusted versions strip internal exchange transfers so the cost basis better reflects genuine ownership changes — conceptually adjacent to the adjustment that aSOPR makes to SOPR.

    CDA endpoints/api/v1/on-chain/score/api/v1/on-chain/exchange-flows/spike-alerts/api/v1/market-intelligence/btc/cycle-indicators/api/v1/on-chain/whales
    Via API/api/v1/indicators/catalog/nupl
    AI-agent prompt
    Compute it with an AI agent
    Compute the Net Unrealized Profit/Loss (NUPL) for BTC, ETH and SOL using the CryptoDataAPI (X-API-Key header).
    
    1. Definition and parameters: GET https://cryptodataapi.com/api/v1/algobrain/page?path=wiki/concepts/metrics/nupl.md
    2. Inputs:
    - GET https://cryptodataapi.com/api/v1/on-chain/score
    - GET https://cryptodataapi.com/api/v1/on-chain/exchange-flows/spike-alerts
    - GET https://cryptodataapi.com/api/v1/market-intelligence/btc/cycle-indicators
    3. Pinned: 4h bars, 500-bar lookback, the playbook's default parameters. Return the latest value, its 30-day percentile, and a one-line read of what it says now. Research only.

    Pi Cycle Top Indicator #

    Pi Cycle Toppi-cyclePi Cycle Top IndicatorPi Cycle

    The Pi Cycle Top Indicator is a bitcoin cycle-timing tool that compares a short and a long moving average of price to flag potential market-cycle tops.

    Used by A building block; no catalogue strategy declares it directly.
    CDA endpoints/api/v1/on-chain/score/api/v1/on-chain/exchange-flows/spike-alerts/api/v1/market-intelligence/btc/cycle-indicators/api/v1/on-chain/whales
    Via API/api/v1/indicators/catalog/pi-cycle-top-indicator
    AI-agent prompt
    Compute it with an AI agent
    Compute the Pi Cycle Top Indicator for BTC, ETH and SOL using the CryptoDataAPI (X-API-Key header).
    
    1. Definition and parameters: GET https://cryptodataapi.com/api/v1/algobrain/page?path=wiki/concepts/indicators/pi-cycle-top-indicator.md
    2. Inputs:
    - GET https://cryptodataapi.com/api/v1/on-chain/score
    - GET https://cryptodataapi.com/api/v1/on-chain/exchange-flows/spike-alerts
    - GET https://cryptodataapi.com/api/v1/market-intelligence/btc/cycle-indicators
    3. Pinned: 4h bars, 500-bar lookback, the playbook's default parameters. Return the latest value, its 30-day percentile, and a one-line read of what it says now. Research only.

    Realized Price & Realized Cap #

    Realized PriceRealized CapRealized Capitalizationrealized-caprealized-capitalization

    The intuition: every coin carries an on-chain "timestamp of last movement," and the asset's price at that moment is treated as the cost basis for that coin.

    CDA endpoints/api/v1/on-chain/score/api/v1/on-chain/exchange-flows/spike-alerts/api/v1/market-intelligence/btc/cycle-indicators/api/v1/on-chain/whales
    Via API/api/v1/indicators/catalog/realized-price
    AI-agent prompt
    Compute it with an AI agent
    Compute the Realized Price & Realized Cap for BTC, ETH and SOL using the CryptoDataAPI (X-API-Key header).
    
    1. Definition and parameters: GET https://cryptodataapi.com/api/v1/algobrain/page?path=wiki/concepts/metrics/realized-price.md
    2. Inputs:
    - GET https://cryptodataapi.com/api/v1/on-chain/score
    - GET https://cryptodataapi.com/api/v1/on-chain/exchange-flows/spike-alerts
    - GET https://cryptodataapi.com/api/v1/market-intelligence/btc/cycle-indicators
    3. Pinned: 4h bars, 500-bar lookback, the playbook's default parameters. Return the latest value, its 30-day percentile, and a one-line read of what it says now. Research only.

    Spent Output Profit Ratio (SOPR) #

    SOPRSpent Output Profit RatioaSOPRAdjusted SOPRspent-output-profit-ratio

    The Spent Output Profit Ratio (SOPR) is an on-chain metric that measures whether coins being spent (moved) on-chain are, on average, changing hands at a profit or a loss relative to the price they were last acquired.

    CDA endpoints/api/v1/on-chain/score/api/v1/on-chain/exchange-flows/spike-alerts/api/v1/market-intelligence/btc/cycle-indicators/api/v1/on-chain/whales
    Via API/api/v1/indicators/catalog/sopr
    AI-agent prompt
    Compute it with an AI agent
    Compute the Spent Output Profit Ratio (SOPR) for BTC, ETH and SOL using the CryptoDataAPI (X-API-Key header).
    
    1. Definition and parameters: GET https://cryptodataapi.com/api/v1/algobrain/page?path=wiki/concepts/metrics/sopr.md
    2. Inputs:
    - GET https://cryptodataapi.com/api/v1/on-chain/score
    - GET https://cryptodataapi.com/api/v1/on-chain/exchange-flows/spike-alerts
    - GET https://cryptodataapi.com/api/v1/market-intelligence/btc/cycle-indicators
    3. Pinned: 4h bars, 500-bar lookback, the playbook's default parameters. Return the latest value, its 30-day percentile, and a one-line read of what it says now. Research only.

    Get these indicators from the API

    curl -H "X-API-Key: cdk_live_yourkey" \
      "https://cryptodataapi.com/api/v1/indicators/catalog?group=on-chain"
    
    curl -H "X-API-Key: cdk_live_yourkey" \
      "https://cryptodataapi.com/api/v1/indicators/catalog/coinbase-premium"

    Any key works, Free included — mint one in a single call. The list endpoint returns summaries; the per-slug endpoint adds the prompts. Full playbooks come from /api/v1/algobrain/page?path=… using each entry's wiki_path. Or use the MCP server.

    What are on-chain metrics indicators?

    Signals read straight from the chain: holder profit/loss, exchange flows, miner and whale behaviour, cycle gauges.

    Which on-chain metrics indicators are covered?

    9: Coinbase Premium, Exchange Net Flows, HODL Waves, MVRV Ratio, MVRV Z-Score, Net Unrealized Profit/Loss (NUPL), Pi Cycle Top Indicator, Realized Price & Realized Cap, Spent Output Profit Ratio (SOPR).

    Where do I get on-chain metrics data for crypto?

    From these Crypto Data API endpoints: /api/v1/on-chain/score, /api/v1/on-chain/exchange-flows/spike-alerts, /api/v1/market-intelligence/btc/cycle-indicators, /api/v1/on-chain/whales.

    Can an AI agent compute these indicators?

    Yes. GET /api/v1/indicators/catalog/{slug} returns a prompt naming the endpoints to call and the parameters to pin. Any API key works, Free included.