diff --git a/data-catalog/crypto-metrics-data-dictionary.mdx b/data-catalog/crypto-metrics-data-dictionary.mdx
new file mode 100644
index 00000000..49d106c9
--- /dev/null
+++ b/data-catalog/crypto-metrics-data-dictionary.mdx
@@ -0,0 +1,367 @@
+---
+title: Crypto Metrics Data Dictionary
+description: A comprehensive reference for key cryptocurrency metrics used in blockchain analytics, including definitions, formulas, use cases, and Dune query examples.
+icon: "chart-line"
+---
+
+# Crypto Metrics Data Dictionary
+
+This comprehensive data dictionary provides definitions, formulas, use cases, and Dune query examples for key cryptocurrency metrics across different categories: Blockchain, Protocol, and Wallet metrics.
+
+## Blockchain Metrics
+
+### MVRV (Market Value to Realized Value)
+**Definition:** Market Value to Realized Value ratio - assesses if a cryptocurrency is overvalued or undervalued
+**Formula:** Market Cap / Realized Value
+**Use Case:** Identify market tops/bottoms; MVRV > 3.5 often indicates overvaluation
+**TradFi Analogy:** Similar to Price-to-Book ratio (Note: Not exact equivalent - MVRV uses on-chain cost basis)
+
+
+
+ View the complete MVRV calculation query
+
+
+
+### RSOV (Realized Store of Value)
+**Definition:** For (L1s only) Realized Store of Value - quantifies long-term value drivers of L1 tokens through staking and DeFi usage
+**Formula:** Realized Value Staked + Realized Value in DeFi
+**Use Case:** Evaluate L1 token adoption as store of value asset; compare growth expectations
+**TradFi Analogy:** Similar to measuring bank deposits + investment AUM
+
+
+
+ View the complete RSOV calculation query
+
+
+
+### REV (Real Economic Value)
+**Definition:** Real Economic Value - tracks actual fees users pay to use blockchain, excluding inflationary rewards
+**Formula:** Transaction Fees + MEV Tips
+**Use Case:** Measure genuine demand for blockspace; compare economic intensity across chains
+**TradFi Analogy:** Similar to revenue or GDP for blockchains (Note: High REV can indicate inefficiency, not just demand)
+
+
+
+ View the complete REV calculation query
+
+
+
+### TVL (Total Value Locked)
+**Definition:** Total Value Locked - total value of assets locked or staked in a blockchain/protocol
+**Formula:** Σ(Asset Amount × Current Price)
+**Use Case:** Measure trust and liquidity committed; compare DeFi protocol adoption
+**TradFi Analogy:** Similar to Assets Under Management (AUM)
+
+
+
+ View the complete TVL calculation query
+
+
+
+### Active Addresses
+**Definition:** Number of unique addresses that sent or received transactions in a period
+**Formula:** COUNT(DISTINCT address)
+**Use Case:** Measure network adoption and user activity trends
+**TradFi Analogy:** Similar to Monthly Active Users (MAU)
+
+
+
+ View the complete Active Addresses calculation query
+
+
+
+### Transaction Count & Volume
+**Definition:** Number of transactions and their total USD value
+**Formula:** COUNT(transactions), SUM(value × price)
+**Use Case:** Track network usage and economic throughput
+**TradFi Analogy:** Similar to payment processing volume
+
+
+
+ View the complete Transaction Count & Volume calculation query
+
+
+
+### Average Transaction Fee
+**Definition:** Average cost in USD to execute a transaction
+**Formula:** Total Fees / Transaction Count
+**Use Case:** Evaluate network accessibility and congestion
+**TradFi Analogy:** Similar to transaction processing fees
+
+
+
+ View the complete Average Transaction Fee calculation query
+
+
+
+### Network Revenue
+**Definition:** Total fees collected by validators/miners
+**Formula:** Σ(Transaction Fees + MEV)
+**Use Case:** Assess blockchain's revenue generation and validator incentives
+**TradFi Analogy:** Similar to exchange/payment network revenue
+
+
+
+ View the complete Network Revenue calculation query
+
+
+
+### Exchange Netflows
+**Definition:** Net token flow in/out of exchanges (inflow - outflow)
+**Formula:** Deposits - Withdrawals
+**Use Case:** Gauge selling pressure; negative = accumulation, positive = distribution
+**TradFi Analogy:** Similar to fund flows data
+
+
+
+ View the complete Exchange Netflows calculation query
+
+
+
+### Staking Ratio
+**Definition:** Percentage of total supply staked (PoS chains)
+**Formula:** Staked Supply / Total Supply × 100
+**Use Case:** Measure network security and token holder confidence
+**TradFi Analogy:** Similar to bond participation rate
+
+
+
+ View the complete Staking Ratio calculation query
+
+
+
+## Protocol Metrics
+
+### Protocol Revenue
+**Definition:** Total fees generated by the protocol
+**Formula:** Σ(Protocol Fees)
+**Use Case:** Evaluate protocol profitability and sustainability
+**TradFi Analogy:** Direct equivalent to company revenue
+
+
+
+ View the complete Protocol Revenue calculation query
+
+
+
+### Total Active Addresses
+**Definition:** Unique addresses interacting with protocol contracts
+**Formula:** COUNT(DISTINCT user_address)
+**Use Case:** Track user adoption and engagement
+**TradFi Analogy:** Similar to customer count
+
+
+
+ View the complete Total Active Addresses calculation query
+
+
+
+### Transaction Volume
+**Definition:** Total value of transactions processed by protocol
+**Formula:** Σ(Transaction Values)
+**Use Case:** Measure protocol's market share and growth
+**TradFi Analogy:** Similar to Gross Merchandise Value (GMV)
+
+
+
+ View the complete Transaction Volume calculation query
+
+
+
+### Fee Generation
+**Definition:** Fees collected from users per transaction or period
+**Formula:** Total Fees / Time Period
+**Use Case:** Analyze protocol's fee efficiency and user costs
+**TradFi Analogy:** Similar to commission rates
+
+
+
+ View the complete Fee Generation calculation query
+
+
+
+### Protocol Treasury Value
+**Definition:** Total value of assets held in protocol treasury
+**Formula:** Σ(Treasury Assets × Price)
+**Use Case:** Assess protocol's financial reserves and runway
+**TradFi Analogy:** Similar to cash reserves/balance sheet
+
+
+
+ View the complete Protocol Treasury Value calculation query
+
+
+
+### Daily/Monthly Active Addresses
+**Definition:** Unique addresses interacting daily or monthly
+**Formula:** COUNT(DISTINCT address) per period
+**Use Case:** Track user retention and growth patterns
+**TradFi Analogy:** Standard DAU/MAU metrics
+
+
+
+ View the complete Daily/Monthly Active Addresses calculation query
+
+
+
+### Protocol Efficiency Ratio
+**Definition:** Fees generated per dollar of TVL
+**Formula:** Total Fees / TVL
+**Use Case:** Compare capital efficiency across protocols
+**TradFi Analogy:** Similar to Return on Assets (ROA)
+
+
+
+ View the complete Protocol Efficiency Ratio calculation query
+
+
+
+### New vs Returning Users
+**Definition:** Breakdown of first-time vs repeat users
+**Formula:** New Users / Total Users
+**Use Case:** Measure user acquisition vs retention
+**TradFi Analogy:** Similar to customer acquisition metrics
+
+
+
+ View the complete New vs Returning Users calculation query
+
+
+
+### Gas Usage/Fees Paid
+**Definition:** Total gas consumed and fees paid by protocol users
+**Formula:** Σ(Gas Used × Gas Price)
+**Use Case:** Evaluate protocol's cost to users and efficiency
+**TradFi Analogy:** Similar to transaction costs
+
+
+
+ View the complete Gas Usage/Fees Paid calculation query
+
+
+
+## Wallet Metrics
+
+### Wallet Balance Distribution
+**Definition:** Distribution of holdings across wallet tiers
+**Formula:** Grouped by balance ranges
+**Use Case:** Analyze wealth concentration and user segments
+**TradFi Analogy:** Similar to wealth distribution analysis
+
+
+
+ View the complete Wallet Balance Distribution calculation query
+
+
+
+### Transaction Frequency
+**Definition:** Average number of transactions per wallet per period
+**Formula:** Total Transactions / Active Wallets
+**Use Case:** Measure user engagement and activity levels
+**TradFi Analogy:** Similar to transaction frequency in banking
+
+
+
+ View the complete Transaction Frequency calculation query
+
+
+
+### Active Wallet Count
+**Definition:** Number of wallets with at least one transaction
+**Formula:** COUNT(DISTINCT active_wallets)
+**Use Case:** Track network growth and adoption
+**TradFi Analogy:** Similar to active account metrics
+
+
+
+ View the complete Active Wallet Count calculation query
+
+
+
+### Wallet Age/Cohort Analysis
+**Definition:** Analysis of wallets grouped by creation date
+**Formula:** Grouped by first transaction date
+**Use Case:** Understand user retention and lifecycle
+**TradFi Analogy:** Similar to customer cohort analysis
+
+
+
+ View the complete Wallet Age/Cohort Analysis calculation query
+
+
+
+### Cross-chain Activity
+**Definition:** Wallets active on multiple blockchains
+**Formula:** Wallets on Chain A ∩ Chain B
+**Use Case:** Measure multi-chain adoption and user sophistication
+**TradFi Analogy:** Similar to multi-product usage
+
+
+
+ View the complete Cross-chain Activity calculation query
+
+
+
+### DeFi Participation Rate
+**Definition:** Percentage of wallets interacting with DeFi protocols
+**Formula:** DeFi Users / Total Active Wallets × 100
+**Use Case:** Gauge DeFi adoption and market penetration
+**TradFi Analogy:** Similar to investment product adoption rate
+
+
+
+ View the complete DeFi Participation Rate calculation query
+
+
+
+### Average Transaction Value
+**Definition:** Mean transaction size per wallet
+**Formula:** Total Value / Transaction Count
+**Use Case:** Profile user behavior and wealth levels
+**TradFi Analogy:** Direct equivalent to average transaction size
+
+
+
+ View the complete Average Transaction Value calculation query
+
+
+
+### Wallet Growth Rate
+**Definition:** Rate of new wallet creation over time
+**Formula:** (New Wallets(t) - New Wallets(t-1)) / New Wallets(t-1)
+**Use Case:** Track adoption acceleration or deceleration
+**TradFi Analogy:** Similar to new account growth rate
+
+
+
+ View the complete Wallet Growth Rate calculation query
+
+
+
+### Dormant vs Active Ratio
+**Definition:** Ratio of inactive to active wallets
+**Formula:** Dormant Wallets / Total Wallets
+**Use Case:** Assess network health and true active user base
+**TradFi Analogy:** Similar to inactive account ratio
+
+
+
+ View the complete Dormant vs Active Ratio calculation query
+
+
+
+### First-time vs Power Users
+**Definition:** Segmentation by transaction count tiers
+**Formula:** Categorized by lifetime transactions
+**Use Case:** Identify user segments for targeted analysis
+**TradFi Analogy:** Similar to customer segmentation
+
+
+
+ View the complete First-time vs Power Users calculation query
+
+
+
+
+This data dictionary provides a comprehensive reference for key cryptocurrency metrics used in blockchain analytics. Each metric includes its definition, formula, use case, and a practical Dune query example to help you implement these calculations in your own analyses.
+
diff --git a/mint.json b/mint.json
index dab351e4..82e3de5d 100644
--- a/mint.json
+++ b/mint.json
@@ -197,7 +197,8 @@
"pages": [
"data-catalog/overview",
"data-catalog/data-freshness",
- "data-catalog/bring-your-own-data"
+ "data-catalog/bring-your-own-data",
+ "data-catalog/crypto-metrics-data-dictionary"
]
},
{