Stats
Endpoints with
are under the API Pro subscription. To upgrade your API plan, kindly visit Etherscan API Pro.
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
Request
Response
No parameters required.
Sample Response
{
"status":"1",
"message":"OK",
"result":"116487067186500000000000000"
}
Returns the current amount of Ether in circulation, ETH2 Staking rewards and EIP1559 burnt fees statistics.
https://api.etherscan.io/api
?module=stats
&action=ethsupply2
&apikey=YourApiKeyToken
Request
Response
No parameters required.
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"EthSupply":"118068179561500000000000000",
"Eth2Staking":"298499690799106000000000",
"BurntFees":"613630199504818876443012"
}
}
Note: The
📝
EthSupply
is calculated before adding ETH minted as Eth2Staking
rewards and subtracting BurntFees
from EIP-1559. Returns the latest price of 1 ETH.
https://api.etherscan.io/api
?module=stats
&action=ethprice
&apikey=YourApiKeyToken
Request
Response
No parameters required.
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"ethbtc":"0.06116",
"ethbtc_timestamp":"1624961308",
"ethusd":"2149.18",
"ethusd_timestamp":"1624961308"
}
}
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
Request
Response
Query Parameters
Parameter | Description |
---|---|
startdate | the starting date in yyyy-MM-dd format, eg. 2019-02-01 |
enddate | the ending date in yyyy-MM-dd format, eg. 2019-02-28 |
clienttype | |
syncmode | |
sort | 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.Returns the total number of discoverable Ethereum nodes.
https://api.etherscan.io/api
?module=stats
&action=nodecount
&apikey=YourApiKeyToken
Request
Response
No parameters required.
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
Request
Response
No parameters required.
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
Request
Response
Query Parameters
Parameter | Description |
---|---|
startdate | the starting date in yyyy-MM-dd format, eg. 2019-02-01 |
enddate | the ending date in yyyy-MM-dd format, eg. 2019-02-28 |
sort | 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/api
?module=stats
&action=dailynetutilization
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
startdate | the starting date in yyyy-MM-dd format, eg. 2019-02-01 |
enddate | the ending date in yyyy-MM-dd format, eg. 2019-02-28 |
sort | 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/api
?module=stats
&action=dailyavghashrate
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
startdate | the starting date in yyyy-MM-dd format, eg. 2019-02-01 |
enddate | the ending date in yyyy-MM-dd format, eg. 2019-02-28 |
sort | 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/api
?module=stats
&action=dailytx
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
startdate | the starting date in yyyy-MM-dd format, eg. 2019-02-01 |
enddate | the ending date in yyyy-MM-dd format, eg. 2019-02-28 |
sort | 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/api
?module=stats
&action=dailyavgnetdifficulty
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
startdate | the starting date in yyyy-MM-dd format, eg. 2019-02-01 |
enddate | the ending date in yyyy-MM-dd format, eg. 2019-02-28 |
sort | 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/api
?module=stats
&action=ethdailymarketcap
&startdate=2019-02-01
&enddate=2019-02-28
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
startdate | the starting date in yyyy-MM-dd format, eg. 2019-02-01 |
enddate | the ending date in yyyy-MM-dd format, eg. 2019-02-28 |
sort | 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"
}
]
}
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
Request
Response
Query Parameters
Parameter | Description |
---|---|
startdate | the starting date in yyyy-MM-dd format, eg. 2019-02-01 |
enddate | the ending date in yyyy-MM-dd format, eg. 2019-02-28 |
sort | 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 ).Last modified 1yr ago