{"uid":"cap_UqIhh8a4MU4gbVJs9d39_","slug":"btc-eth-mvrv-ratio-z-score-valuation-20081145","name":"BTC/ETH MVRV Ratio Z-Score Valuation","description":"Daily MVRV ratio (market cap / realized cap) for BTC or ETH from CoinMetrics' free community data, with the latest value, the window mean and standard deviation, and its z-score. Labels are plain statistics (HIGH_Z, LOW_Z, MID), not buy or sell calls. Realized cap in USD is not in the free tier, so only the ratio is returned.","url":"https://api.fadeandco.workers.dev/api/agent-intel/onchain-mvrv-valuation?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"days":{"type":"string","description":"Window in days, 30 to 365 (default 365)"},"asset":{"type":"string","description":"btc or eth (default btc)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"note":"A statistic over the window, not a trading signal. Data ends yesterday (CoinMetrics community feed).","asset":"btc","label":"MID","latest":{"date":"2026-10-21","mvrv":1.5604,"zScore":1.037},"source":"https://community-api.coinmetrics.io/v4/timeseries/asset-metrics","window":{"max":1.621,"min":1.1887,"days":100,"mean":1.4054,"stdDev":0.1495},"checkedAt":"2026-10-23T09:35:19.826Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6usOOipapWZ9eoL0Px2aE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the daily MVRV ratio (market cap / realized cap) for BTC or ETH with z-score, window statistics, and a plain statistical label (HIGH_Z, MID, LOW_Z) sourced from CoinMetrics community data.","exampleAgentPrompt":"What's the current MVRV ratio z-score for Bitcoin over a 180-day window — is it statistically high, low, or in the middle right now based on CoinMetrics on-chain data?","exampleUseCases":[{"title":"Bitcoin on-chain valuation check","prompt":"Pull the latest MVRV ratio and z-score for BTC using a 365-day window and tell me whether it's in a statistically elevated or depressed zone right now."},{"title":"Ethereum realized-cap ratio scan","prompt":"What's the MVRV ratio z-score for ETH over the past 90 days — is Ethereum's market cap sitting high or low relative to its realized cap historically?"},{"title":"Weekly on-chain briefing for BTC and ETH","prompt":"Get me the MVRV z-score for both Bitcoin and Ethereum over a 180-day lookback window so I can include them in my weekly on-chain market summary."}],"resultDescription":"A JSON object containing: the asset ticker, the latest MVRV ratio with its date and z-score, a statistical label (HIGH_Z, LOW_Z, or MID), window statistics (mean, std dev, min, max, days), the CoinMetrics source URL, and a checkedAt timestamp. Explicitly noted as a statistic, not a trading signal.","failureModes":["Invalid asset parameter (not 'btc' or 'eth') returns an error","Days parameter outside 30–365 range may return an error or be clamped","CoinMetrics community feed lag means data ends the previous day, not real-time","Payment not completed (x402) results in a 402 response before data is returned","Network timeout from upstream CoinMetrics community API"],"whenToPreferThis":"Choose this endpoint when you need a quick, standardized on-chain MVRV valuation metric for BTC or ETH with z-score context over a configurable historical window, without needing to integrate directly with CoinMetrics yourself. It is ideal for agents building on-chain market summaries, valuation dashboards, or screening workflows where realized cap ratio context is needed as a neutral statistical input rather than a buy/sell signal. Prefer this over raw CoinMetrics calls when you want pre-computed window statistics and a labeled z-score in a single low-cost API call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T19:59:32.770Z","isFirstParty":false,"canonicalSlug":"btc-eth-mvrv-ratio-z-score-valuation-20081145"}