Introduction to Etherscan's Statistical APIs
Etherscan provides a comprehensive set of API endpoints for accessing real-time and historical Ethereum network data. These statistics offer valuable insights into network health, adoption metrics, and economic indicators crucial for developers, analysts, and blockchain enthusiasts.
Core Ethereum Supply Metrics
Total Ether Supply (Base Calculation)
This fundamental endpoint returns the circulating supply of Ether, excluding:
- ETH2 staking rewards
- EIP1559 burned fees
API Endpoint:https://api.etherscan.io/api?module=stats&action=ethsupply&apikey=YourApiKeyToken
๐ Explore live Ethereum supply data
Expanded Ether Supply Calculation
For a more comprehensive view including:
- ETH2 staking rewards
- Burned fees from EIP1559
- Withdrawn ETH from beacon chain
API Endpoint:https://api.etherscan.io/api?module=stats&action=ethsupply2&apikey=YourApiKeyToken
Network Performance Indicators
Current Ether Price
API Endpoint:https://api.etherscan.io/api?module=stats&action=ethprice&apikey=YourApiKeyToken
Blockchain Size Metrics
Returns blockchain size in bytes over specified date ranges with parameters:
startdate: YYYY-MM-DD formatenddate: YYYY-MM-DD formatsort: asc/desc
API Endpoint:https://api.etherscan.io/api?module=stats&action=chainsize&startdate=2019-02-01&enddate=2019-02-28&clienttype=geth&syncmode=default&sort=asc&apikey=YourApiKeyToken
Network Activity Statistics
Daily Transaction Metrics
Key parameters for all daily endpoints:
startdate: Required in YYYY-MM-DD formatenddate: Required in YYYY-MM-DD formatsort: asc/desc sorting preference
1. Network Transaction Fees:https://api.etherscan.io/api?module=stats&action=dailytxnfee&startdate=2019-02-01&enddate=2019-02-28&sort=asc&apikey=YourApiKeyToken
2. New Address Creation:https://api.etherscan.io/api?module=stats&action=dailynewaddress&startdate=2019-02-01&enddate=2019-02-28&sort=asc&apikey=YourApiKeyToken
3. Network Utilization:https://api.etherscan.io/api?module=stats&action=dailynetutilization&startdate=2019-02-01&enddate=2019-02-28&sort=asc&apikey=YourApiKeyToken
Mining and Network Health Data
Hash Rate and Difficulty
1. Average Hash Rate:https://api.etherscan.io/api?module=stats&action=dailyavghashrate&startdate=2019-02-01&enddate=2019-02-28&sort=asc&apikey=YourApiKeyToken
2. Network Difficulty:https://api.etherscan.io/api?module=stats&action=dailyavgnetdifficulty&startdate=2019-02-01&enddate=2019-02-28&sort=asc&apikey=YourApiKeyToken
๐ Monitor Ethereum mining statistics
Historical Price Data
API Endpoint:https://api.etherscan.io/api?module=stats&action=ethdailyprice&startdate=2019-02-01&enddate=2019-02-28&sort=asc&apikey=YourApiKeyToken
FAQ Section
What's the difference between ethsupply and ethsupply2?
ethsupply shows base circulation while ethsupply2 includes staking rewards and burned fees for complete supply analysis.
How frequently should I poll these API endpoints?
For most use cases, daily polling suffices as metrics like supply and price don't require minute-by-minute updates.
Can I get blockchain size data in real-time?
Blockchain size endpoints require date ranges as this metric accumulates over time rather than providing instant snapshots.
Why do some endpoints require date ranges?
Historical metrics like transaction counts and network utilization only make sense when analyzed over specific time periods.
How accurate are the node count statistics?
Node counts represent discoverable nodes and may not capture the entire network, but provide reliable relative metrics.
What's the best way to visualize this data?
Combine multiple endpoints to create comprehensive dashboards showing correlations between price, network activity, and mining metrics.
Conclusion
Etherscan's statistical APIs provide developers and analysts with powerful tools to monitor Ethereum's network health, adoption trends, and economic indicators. By understanding these metrics, stakeholders can make more informed decisions about network participation and investment strategies.