Links

Stats

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
🔗
Request
Response
No parameters required.
Sample Response
{
"status":"1",
"message":"OK",
"result":"116487067186500000000000000"
}
📖
Tip : Easily convert Ethereum units using our unit converter.

Get Total Supply of Ether 2

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
Try this endpoint in your browser
🔗
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.
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/api
?module=stats
&action=ethprice
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
No parameters required.
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"ethbtc":"0.06116",
"ethbtc_timestamp":"1624961308",
"ethusd":"2149.18",
"ethusd_timestamp":"1624961308"
}
}
Tip : The timestamps are represented in Unix timestamp.

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
Try this endpoint in your browser
🔗
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
the Ethereum node client to use, either geth or parity
syncmode
the type of node to run, either default or archive
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.

Get Total Nodes Count

Returns the total number of discoverable Ethereum nodes.
https://api.etherscan.io/api
?module=stats
&action=nodecount
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
No parameters required.
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"UTCDate":"2021-06-29",
"TotalNodeCount":"6413"
}
}

Get Daily Network Transaction Fee

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
Try this endpoint in your browser
🔗
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"
}
]
}

Get Daily New Address Count

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
Try this endpoint in your browser
🔗
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
}
]
}

Get Daily Network Utilization

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
Try this endpoint in your browser
🔗
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"
}
]
}

Get Daily Average Network Hash Rate

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
Try this endpoint in your browser
🔗
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"
}
]
}
🔥
Tip : The networkHashRate is represented in GigaHashes ( GH/s ).

Get Daily Transaction Count

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
Try this endpoint in your browser
🔗
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
}
]
}

Get Daily Average Network Difficulty

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
Try this endpoint in your browser
🔗
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"
}
]
}
🔥
Tip : The networkDifficulty is represented in TeraHashes ( TH/s ).

Get Ether Historical Daily Market Cap

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
Try this endpoint in your browser
🔗
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"
}
]
}
💰
Tip : The marketCap is represented in million US Dollars ( USD ).

Get Ether Historical Price

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
Try this endpoint in your browser
🔗
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 ).