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
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. ​
​

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.

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.​

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.

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"
}
}

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"
}
]
}

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
}
]
}

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"
}
]
}

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 ).

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
}
]
}

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 ).

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 ).

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 ).
Copy link
On this page
Get Total Supply of Ether
Get Total Supply of Ether 2
Get Ether Last Price
Get Ethereum Nodes Size
Get Total Nodes Count
Get Daily Network Transaction Fee
Get Daily New Address Count
Get Daily Network Utilization
Get Daily Average Network Hash Rate
Get Daily Transaction Count
Get Daily Average Network Difficulty
Get Ether Historical Daily Market Cap
Get Ether Historical Price