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/v2/api
?chainid=1
&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/v2/api
?chainid=1
&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"
}
}
📝 Note: The EthSupply is calculated before adding ETH minted as Eth2Staking rewards and subtracting BurntFees from EIP-1559.
For more information, check out our Ether Total Supply Dashboard.
Get Ether Last Price
Returns the latest price of 1 ETH.
https://api.etherscan.io/v2/api
?chainid=1
&module=stats
&action=ethprice
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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/v2/api
?chainid=1
&module=stats
&action=chainsize
&startdate=2019-02-01
&enddate=2019-02-28
&clienttype=geth
&syncmode=default
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2019-02-01
the ending date in yyyy-MM-dd format, eg. 2019-02-28
the sorting preference, use asc to sort by ascending and desc to sort by descending
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"
}
]
}
⛓️ Tip : The chainSize is represented in bytes.
Get Total Nodes Count
Returns the total number of discoverable Ethereum nodes.
https://api.etherscan.io/v2/api
?chainid=1
&module=stats
&action=nodecount
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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/v2/api
?chainid=1
&module=stats
&action=dailytxnfee
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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/v2/api
?chainid=1
&module=stats
&action=dailynewaddress
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2019-02-01
the ending date in yyyy-MM-dd format, eg. 2019-02-28
the sorting preference, use asc to sort by ascending and desc to sort by descending
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/v2/api
?chainid=1
&module=stats
&action=dailynetutilization
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2019-02-01
the ending date in yyyy-MM-dd format, eg. 2019-02-28
the sorting preference, use asc to sort by ascending and desc to sort by descending
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/v2/api
?chainid=1
&module=stats
&action=dailyavghashrate
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2019-02-01
the ending date in yyyy-MM-dd format, eg. 2019-02-28
the sorting preference, use asc to sort by ascending and desc to sort by descending
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/v2/api
?chainid=1
&module=stats
&action=dailytx
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2019-02-01
the ending date in yyyy-MM-dd format, eg. 2019-02-28
the sorting preference, use asc to sort by ascending and desc to sort by descending
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/v2/api
?chainid=1
&module=stats
&action=dailyavgnetdifficulty
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2019-02-01
the ending date in yyyy-MM-dd format, eg. 2019-02-28
the sorting preference, use asc to sort by ascending and desc to sort by descending
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/v2/api
?chainid=1
&module=stats
&action=ethdailymarketcap
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2019-02-01
the ending date in yyyy-MM-dd format, eg. 2019-02-28
the sorting preference, use asc to sort by ascending and desc to sort by descending
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"
}
]
}
💰 Tip : The marketCap is represented in million US Dollars ( USD ).
Returns the historical price of 1 ETH.
https://api.etherscan.io/v2/api
?chainid=1
&module=stats
&action=ethdailyprice
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2019-02-01
the ending date in yyyy-MM-dd format, eg. 2019-02-28
the sorting preference, use asc to sort by ascending and desc to sort by descending
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"
}
]
}
💰 Tip : The value is represented in US Dollars ( USD ).
