Endpoints with are under the API Pro subscription. To upgrade your API plan, kindly visit Etherscan API Pro.
Get Total Supply of Ether
Returns the current amount of Ether in circulation excluding ETH2 Staking rewards and EIP1559 burnt fees.
https://api.etherscan.io/api
?module=stats
&action=ethsupply
&apikey=YourApiKeyToken
Try this endpoint in your browser
Sample Response
{
"status":"1",
"message":"OK",
"result":"116487067186500000000000000"
}
Get Total Supply of Ether 2
Returns the current amount of Ether in circulation, ETH2 Staking rewards, EIP1559 burnt fees, and total withdrawn ETH from the beacon chain.
https://api.etherscan.io/api
?module=stats
&action=ethsupply2
&apikey=YourApiKeyToken
Try this endpoint in your browser
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"EthSupply":"122373866217800000000000000",
"Eth2Staking":"1157529105115885000000000",
"BurntFees":"3102505506455601519229842",
"WithdrawnTotal":"1170200333006131000000000"
}
}
Get Ether Last Price
Returns the latest price of 1 ETH.
https://api.etherscan.io/api
?module=stats
&action=ethprice
&apikey=YourApiKeyToken
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"ethbtc":"0.06116",
"ethbtc_timestamp":"1624961308",
"ethusd":"2149.18",
"ethusd_timestamp":"1624961308"
}
}
Get Ethereum Nodes Size
Returns the size of the Ethereum blockchain, in bytes, over a date range.
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
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"7156164",
"chainTimeStamp":"2019-02-01",
"chainSize":"184726421279",
"clientType":"Geth",
"syncMode":"Default"
}
{
"blockNumber":"7276521",
"chainTimeStamp":"2019-02-28",
"chainSize":"197073145113",
"clientType":"Geth",
"syncMode":"Default"
}
]
}
Get Total Nodes Count
Returns the total number of discoverable Ethereum nodes.
https://api.etherscan.io/api
?module=stats
&action=nodecount
&apikey=YourApiKeyToken
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"UTCDate":"2021-06-29",
"TotalNodeCount":"6413"
}
}
Returns the amount of transaction fees paid to miners per day.
https://api.etherscan.io/api
?module=stats
&action=dailytxnfee
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2019-02-01",
"unixTimeStamp":"1548979200",
"transactionFee_Eth":"358.558440870590355682"
}
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"transactionFee_Eth":"545.141762162356907132"
}
]
}
Returns the number of new Ethereum addresses created per day.
https://api.etherscan.io/api
?module=stats
&action=dailynewaddress
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2019-02-01",
"unixTimeStamp":"1548979200",
"newAddressCount":54081
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"newAddressCount":53117
}
]
}
Returns the daily average gas used over gas limit, in percentage.
https://api.etherscan.io/api
?module=stats
&action=dailynetutilization
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2019-02-01",
"unixTimeStamp":"1548979200",
"networkUtilization":"0.8464"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"networkUtilization":"0.9472"
}
]
}
Returns the historical measure of processing power of the Ethereum network.
https://api.etherscan.io/api
?module=stats
&action=dailyavghashrate
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2019-02-01",
"unixTimeStamp":"1548979200",
"networkHashRate":"143116.0140"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"networkHashRate":"157689.3983"
}
]
}
Returns the number of transactions performed on the Ethereum blockchain per day.
https://api.etherscan.io/api
?module=stats
&action=dailytx
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2019-02-01",
"unixTimeStamp":"1548979200",
"transactionCount":498856
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"transactionCount":541458
}
]
}
Returns the historical mining difficulty of the Ethereum network.
https://api.etherscan.io/api
?module=stats
&action=dailyavgnetdifficulty
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2019-02-01",
"unixTimeStamp":"1548979200",
"networkDifficulty":"2,408.028"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"networkDifficulty":"2,927.453"
}
]
}
Returns the historical Ether daily market capitalization.
https://api.etherscan.io/api
?module=stats
&action=ethdailymarketcap
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2019-02-01",
"unixTimeStamp":"1548979200",
"supply":"104672819.281250",
"marketCap":"11203.1318476721875",
"price":"107.03"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"supply":"105048576.406250",
"marketCap":"14317.0704784078125",
"price":"136.29"
}
]
}
Returns the historical price of 1 ETH.
https://api.etherscan.io/api
?module=stats
&action=ethdailyprice
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2019-02-01",
"unixTimeStamp":"1548979200",
"value":"107.03"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"value":"136.29"
}
]
}
