Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
LABS
Glossary

On-chain KPIs

On-chain Key Performance Indicators (KPIs) are objective metrics defined, measured, and verified directly on a blockchain, enabling the automatic execution of agreements via smart contracts.
Chainscore © 2026
definition
BLOCKCHAIN ANALYTICS

What is On-chain KPIs?

On-chain KPIs (Key Performance Indicators) are quantifiable metrics derived directly from blockchain data, used to measure the activity, health, and economic state of a decentralized network or protocol.

On-chain KPIs are objective, verifiable metrics calculated from data permanently recorded on a blockchain's public ledger. Unlike traditional KPIs, which often rely on self-reported or private data, these indicators—such as Total Value Locked (TVL), daily active addresses, and transaction volume—are extracted directly from the immutable transaction history. This provides a transparent and auditable foundation for analysis, free from the reporting biases common in off-chain systems. Analysts use these metrics to gauge user adoption, network security (via hashrate or stake), and overall economic throughput.

The primary categories of on-chain KPIs include network activity, financial metrics, and decentralization indicators. Network activity KPIs, like new address creation and transaction counts, measure raw usage. Financial metrics, such as TVL in DeFi or exchange flow, track capital movement and protocol revenue. Decentralization indicators assess the distribution of network control, examining metrics like the Gini coefficient of token holdings or the number of active validators. These KPIs are foundational for building dashboards and analytics platforms that serve developers, investors, and protocol governance participants.

For developers and protocol teams, monitoring on-chain KPIs is essential for product iteration and growth hacking. A sudden drop in daily active users might signal UX issues, while a spike in failed transactions could indicate network congestion or smart contract bugs. CTOs use these metrics for capacity planning and to benchmark their protocol's performance against competitors. Furthermore, KPIs like fee revenue and protocol-owned liquidity are critical for assessing a project's long-term sustainability and economic viability without relying on inflationary token emissions.

In the realm of decentralized finance (DeFi), on-chain KPIs become particularly nuanced. Metrics such as liquidity depth, impermanent loss rates for liquidity providers, and collateralization ratios for lending protocols offer real-time insight into market stability and risk. Analysts cross-reference these with off-chain price data to calculate derived metrics like the Network Value to Transactions (NVT) ratio, a blockchain analog to the price-to-earnings ratio, to identify potential market over- or under-valuation based on underlying utility.

The technical pipeline for generating on-chain KPIs involves data indexing, event decoding, and metric aggregation. Raw blockchain data from nodes is processed by indexers (e.g., The Graph) which structure the data into queryable subgraphs. Analysts then write queries to filter, transform, and aggregate this data—counting transactions, summing token values, or tracking smart contract interactions—to produce the final time-series metrics. This infrastructure enables the real-time dashboards and alerting systems that power modern blockchain analytics.

While powerful, on-chain KPIs have limitations. They cannot capture off-chain sentiment, the intent behind transactions, or the identity of users (who may control multiple addresses). Therefore, a comprehensive analysis often combines on-chain data with off-chain signals, such as social media sentiment or development activity from GitHub. Nevertheless, as the primary source of truth for blockchain activity, on-chain KPIs remain the indispensable core for any objective assessment of crypto-economic systems and their traction.

how-it-works
MECHANICS

How On-chain KPIs Work

On-chain KPIs are quantifiable metrics derived directly from blockchain data, providing an objective, real-time view of protocol health, user activity, and financial performance.

An on-chain Key Performance Indicator (KPI) is a measurable value calculated from data permanently recorded on a blockchain, such as transaction counts, wallet addresses, token transfers, and smart contract interactions. Unlike traditional metrics, these KPIs are verifiable and tamper-proof because they are sourced from the immutable public ledger. Analysts and developers compute these metrics by querying blockchain nodes or using specialized data indexing services to aggregate raw transactional data into actionable insights like Daily Active Users (DAU), Total Value Locked (TVL), and transaction fee revenue.

The technical workflow for generating on-chain KPIs involves several layers. First, a node or indexer extracts raw block data. This data is then parsed and transformed using query languages or frameworks (e.g., GraphQL for The Graph protocol) to filter for specific events like token mint or transfer function calls. The processed data is aggregated over timeframes (hourly, daily) and dimensions (by protocol, by chain) to produce the final metric. This pipeline ensures KPIs reflect the canonical state of the network, free from the reporting biases of centralized entities.

Effective on-chain KPIs serve distinct analytical purposes. Growth metrics track adoption (e.g., new unique addresses). Financial metrics assess economic activity (e.g., fee revenue, yield). Security and decentralization metrics evaluate network robustness (e.g., validator count, stake distribution). For example, a sudden drop in a DeFi protocol's TVL KPI could signal user withdrawal and liquidity stress, while a spike in gas fee KPIs on Ethereum might indicate network congestion. These indicators allow stakeholders to make data-driven decisions regarding investment, development, and governance.

Challenges in working with on-chain KPIs include data granularity—distinguishing between human users and smart contract bots—and cross-chain comparability. A wallet's activity may span multiple blockchains, requiring sophisticated entity resolution. Furthermore, raw data often needs contextual interpretation; a high transaction count KPI could indicate genuine usage or simply airdrop farming. Therefore, robust KPI frameworks often combine multiple metrics and apply filters to isolate meaningful signal from noise, creating a composite view of on-chain health.

key-features
CORE ATTRIBUTES

Key Features of On-chain KPIs

On-chain Key Performance Indicators (KPIs) are quantifiable metrics derived directly from blockchain data, offering a transparent and verifiable foundation for analyzing protocol health, user behavior, and market dynamics.

01

Transparency & Verifiability

Every data point is anchored to a public ledger, allowing anyone to audit the source transaction and verify calculations. This eliminates reliance on opaque, self-reported data from centralized entities, establishing a single source of truth for performance analysis.

  • Example: Total Value Locked (TVL) can be verified by summing the token balances in a protocol's smart contracts on-chain.
02

Real-Time & Granular

Data is updated with each new block, providing a near real-time pulse on network activity. This granularity allows for analysis at the level of individual wallets, transactions, and smart contract interactions, enabling deep dives into user cohorts and behavioral trends.

  • Example: Tracking the hourly inflow/outflow of capital to a lending protocol to gauge market sentiment.
03

Composability & Standardization

On-chain data follows standardized formats (e.g., ERC-20, event logs), making it inherently composable. KPIs from different protocols can be combined to create new, higher-order metrics and cross-protocol analyses, powering sophisticated DeFi dashboards and risk models.

  • Example: Calculating a user's health factor across multiple lending platforms by compositing their collateral and debt positions.
04

Objective & Tamper-Resistant

Once confirmed on the blockchain, data is immutable and resistant to manipulation by any single party. This objectivity makes on-chain KPIs crucial for trust-minimized applications like smart contract-based triggers, decentralized governance, and automated risk management systems that execute based on verifiable conditions.

05

Leading Indicator Potential

On-chain activity often precedes market price movements. Metrics like exchange net flows, large wallet (whale) movements, and funding rates can serve as leading indicators for volatility, identifying accumulation or distribution phases before they are reflected in centralized exchange order books.

06

Common Metric Categories

On-chain KPIs are typically grouped into analytical categories:

  • Financial Health: TVL, Revenue, Fees, Market Cap/TVL Ratio.
  • User Adoption: Active Addresses, New Addresses, Transaction Count.
  • Network Security: Staking Ratio, Validator Count, Total Hashrate.
  • DeFi-Specific: Borrow/Lend Volumes, Liquidity Pool Depth, Impermanent Loss.
  • NFT & Social: Unique Holders, Floor Price, Trading Volume.
examples
ON-CHAIN KPIs

Examples & Use Cases

On-chain KPIs transform raw blockchain data into actionable metrics for protocol health, user behavior, and financial performance. These examples illustrate how key performance indicators are derived and applied across the Web3 ecosystem.

DATA SOURCE COMPARISON

On-chain vs. Off-chain KPIs

A comparison of the defining characteristics, verification methods, and typical use cases for metrics derived from blockchain data versus traditional external sources.

FeatureOn-chain KPIsOff-chain KPIs

Data Source

Native blockchain state (blocks, transactions, smart contracts)

External APIs, centralized databases, social platforms

Verification Method

Cryptographically provable via consensus and Merkle proofs

Trusted third-party attestation or oracle networks

Data Integrity

Transparency & Auditability

Update Latency

Near real-time (block time dependent)

Variable (API poll interval, manual updates)

Example Metrics

TVL, Active Addresses, Gas Fees, Transaction Count

Brand Sentiment, App Store Downloads, Team Headcount, Fiat Revenue

Primary Use Case

Protocol health, network security, DeFi risk analysis

Market adoption, competitive analysis, traditional financial modeling

Manipulation Resistance

High (costly to manipulate consensus)

Low (susceptible to reporting bias)

technical-components
ON-CHAIN KPIS

Technical Components

On-chain Key Performance Indicators (KPIs) are quantifiable metrics derived directly from blockchain data, used to measure the health, activity, and economic state of a protocol, application, or network.

01

Total Value Locked (TVL)

The aggregate value of all crypto assets deposited into a DeFi protocol's smart contracts. It is the primary metric for assessing a protocol's size and user trust.

  • Calculation: Sum of all collateral, liquidity pool tokens, and staked assets.
  • Example: A lending protocol with $1B in deposits and $500M in borrowed assets would report a TVL of $1B.
  • Limitation: Can be inflated by double-counting across interconnected protocols.
$50B+
Ethereum DeFi TVL (Peak)
02

Daily Active Addresses (DAA)

The number of unique wallet addresses that were active as a sender or receiver in a given day. It is a core metric for gauging network or dApp user engagement.

  • Measures: Raw participation, not unique users (one user can have multiple addresses).
  • Use Case: Tracking adoption trends for Layer 1 blockchains like Ethereum or specific applications like Uniswap.
  • Context: Should be compared with transaction count to understand activity depth.
03

Transaction Count & Fees

The raw number of transactions processed and the total fees paid over a period. These are fundamental throughput and economic KPIs.

  • Transaction Count: Indicates network utilization and demand for block space.
  • Total Fees: Represents the real economic value captured by the network (e.g., EIP-1559 burn on Ethereum) or paid to validators.
  • Analysis: A rising count with stable/low fees suggests healthy scalability.
04

Network Security Metrics

Quantitative measures of a blockchain's resistance to attack, primarily for Proof-of-Work and Proof-of-Stake networks.

  • Hash Rate (PoW): The total computational power securing the network (e.g., Bitcoin). Higher is more secure.
  • Total Staked (PoS): The value of tokens locked in the staking contract to act as validators (e.g., Ethereum).
  • Staking Ratio: The percentage of the total token supply that is staked, influencing security and inflation.
05

Protocol Revenue & Fees

The fees accrued to the protocol's treasury or token holders, distinct from total network fees. It measures a protocol's sustainable business model.

  • Calculation: For a DEX like Uniswap, it's a portion of swap fees. For a lending protocol like Aave, it's a share of interest payments.
  • Key Distinction: Protocol Revenue is fees kept by the protocol; Total Fees includes rewards distributed to liquidity providers.
  • Significance: Used in valuation models like Price-to-Sales (P/S) ratios.
06

Concentration & Decentralization

Metrics that analyze the distribution of tokens, voting power, or network control to assess systemic risk and censorship resistance.

  • Gini Coefficient: Measures token distribution inequality among addresses.
  • Nakamoto Coefficient: The minimum number of entities required to compromise the network (e.g., control 51% of stake or hash rate).
  • Governance Power: Analysis of proposal voting and delegate influence.
security-considerations
ON-CHAIN KPIS

Security & Trust Considerations

On-chain Key Performance Indicators (KPIs) are quantitative metrics derived directly from blockchain data, used to assess the health, security, and economic activity of protocols, applications, and networks. Their reliability is foundational to trust in decentralized systems.

01

Data Provenance & Immutability

On-chain KPIs derive trust from the immutable ledger of a blockchain. Once a transaction is confirmed and added to a block, the data cannot be altered, providing a cryptographically secure audit trail. This ensures the KPIs are based on a single source of truth that is publicly verifiable by anyone, eliminating disputes over data origin or historical revision.

02

Oracle Risk & Data Feeds

KPIs that incorporate external data (e.g., asset prices, real-world events) depend on oracles. This introduces oracle risk, where manipulated or incorrect data can lead to flawed metrics and catastrophic failures (e.g., faulty Total Value Locked calculations triggering liquidations). Security relies on the decentralization and cryptographic proofs of the oracle network used.

03

Manipulation Resistance

A core security consideration is whether a KPI can be gamed or manipulated by participants. For example:

  • Wash trading can artificially inflate Daily Trading Volume.
  • Sybil attacks can distort governance participation metrics.
  • Flash loans can temporarily skew Total Value Locked (TVL). Robust KPIs use methodologies resistant to such short-term manipulation.
04

Consensus Finality & Reorgs

KPIs calculated from recent blocks are subject to chain reorganization (reorg) risk, where a different chain becomes canonical. Metrics like Transactions Per Second (TPS) or recent Active Addresses can change if a reorg occurs. The security of a KPI increases with the number of confirmations (finality) it incorporates, moving it further from the chain tip.

05

Smart Contract Risk & Composability

KPIs derived from DeFi protocols (e.g., Annual Percentage Yield, Collateralization Ratio) are only as secure as the underlying smart contracts. A bug or exploit in a lending pool or AMM renders its associated KPIs meaningless. Furthermore, composability means a failure in one protocol can cascade, invalidating KPIs across interconnected systems.

06

Privacy vs. Transparency Trade-off

The transparency of public blockchains means all data for KPIs is exposed. While this enables auditability, it can also lead to privacy leaks and strategic front-running. For instance, a large wallet's movements (affecting Net Flow metrics) are public, allowing others to anticipate and exploit their actions. Zero-knowledge proofs are emerging to provide verifiable metrics without exposing underlying data.

ON-CHAIN KPIS

Common Misconceptions

Clarifying frequent misunderstandings about blockchain metrics and performance indicators used by developers and analysts.

No, a high transaction count does not inherently indicate network health or genuine user activity. A high volume can be artificially inflated by spam transactions, airdrop farming, or protocol-specific mechanics like staking rewards that generate many low-value on-chain events. True health is better measured by fee revenue, unique active addresses, and the economic value being transacted. For example, a network with millions of transactions composed solely of token transfers between a few wallets for yield farming does not reflect sustainable adoption.

ON-CHAIN KPIS

Frequently Asked Questions

Essential questions answered about the key performance indicators used to measure blockchain network health, application usage, and economic security.

Total Value Locked (TVL) is the aggregate value of all crypto assets deposited into a decentralized finance (DeFi) protocol's smart contracts. It is calculated by summing the dollar value of all assets—such as ETH, stablecoins, or LP tokens—that users have staked, lent, or provided as liquidity. For example, a lending protocol's TVL includes all deposited collateral and lent assets, while a decentralized exchange's (DEX) TVL is the sum of all liquidity pools. TVL is a primary metric for gauging a protocol's scale, user trust, and capital efficiency, though it should be analyzed alongside other metrics like revenue and unique active wallets to avoid misinterpretation from token price inflation.

ENQUIRY

Get In Touch
today.

Our experts will offer a free quote and a 30min call to discuss your project.

NDA Protected
24h Response
Directly to Engineering Team
10+
Protocols Shipped
$20M+
TVL Overall
NDA Protected Directly to Engineering Team
On-chain KPIs: Definition & Use in DeSci & DAOs | ChainScore Glossary