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.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=ethsupply
4
&apikey=YourApiKeyToken
Copied!
Try this endpoint in your browser
πŸ”—
​
Request
Response
No parameters required.
Sample Response
1
{
2
"status":"1",
3
"message":"OK",
4
"result":"116487067186500000000000000"
5
}
Copied!
​
πŸ“–
Tip : Easily convert Ethereum units using our unit converter. ​

Get Ether Last Price

Returns the latest price of 1 ETH.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=ethprice
4
&apikey=YourApiKeyToken
Copied!
Try this endpoint in your browser
πŸ”—
​
Request
Response
No parameters required.
Sample Response
1
{
2
"status":"1",
3
"message":"OK",
4
"result":{
5
"ethbtc":"0.06116",
6
"ethbtc_timestamp":"1624961308",
7
"ethusd":"2149.18",
8
"ethusd_timestamp":"1624961308"
9
}
10
}
Copied!
​
⏳
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.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=chainsize
4
&startdate=2019-02-01
5
&enddate=2019-02-28
6
&clienttype=geth
7
&syncmode=default
8
&sort=asc
9
&apikey=YourApiKeyToken
Copied!
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
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"blockNumber":"7156164",
7
"chainTimeStamp":"2019-02-01",
8
"chainSize":"184726421279",
9
"clientType":"Geth",
10
"syncMode":"Default"
11
}
12
{
13
"blockNumber":"7276521",
14
"chainTimeStamp":"2019-02-28",
15
"chainSize":"197073145113",
16
"clientType":"Geth",
17
"syncMode":"Default"
18
}
19
]
20
}
Copied!
​
β›“
Tip : The chainSize is represented in bytes.

Get Total Nodes Count

Returns the total number of discoverable Ethereum nodes.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=nodecount
4
&apikey=YourApiKeyToken
Copied!
Try this endpoint in your browser
πŸ”—
​
Request
Response
No parameters required.
Sample Response
1
{
2
"status":"1",
3
"message":"OK",
4
"result":{
5
"UTCDate":"2021-06-29",
6
"TotalNodeCount":"6413"
7
}
8
}
Copied!

Get Daily Network Transaction Fee
​

Returns the amount of transaction fees paid to miners per day.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=dailytxnfee
4
&startdate=2019-02-01
5
&enddate=2019-02-28
6
&sort=asc
7
&apikey=YourApiKeyToken
Copied!
Try this endpoint in your browser
πŸ”—
​
Request
Response
No parameters required.
Sample Response
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"UTCDate":"2019-02-01",
7
"unixTimeStamp":"1548979200",
8
"transactionFee_Eth":"358.558440870590355682"
9
}
10
{
11
"UTCDate":"2019-02-28",
12
"unixTimeStamp":"1551312000",
13
"transactionFee_Eth":"545.141762162356907132"
14
}
15
]
16
}
Copied!

Get Daily New Address Count
​

Returns the number of new Ethereum addresses created per day.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=dailynewaddress
4
&startdate=2019-02-01
5
&enddate=2019-02-28
6
&sort=asc
7
&apikey=YourApiKeyToken
Copied!
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
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"UTCDate":"2019-02-01",
7
"unixTimeStamp":"1548979200",
8
"newAddressCount":54081
9
},
10
{
11
"UTCDate":"2019-02-28",
12
"unixTimeStamp":"1551312000",
13
"newAddressCount":53117
14
}
15
]
16
}
Copied!

Get Daily Network Utilization
​

Returns the daily average gas used over gas limit, in percentage.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=dailynetutilization
4
&startdate=2019-02-01
5
&enddate=2019-02-28
6
&sort=asc
7
&apikey=YourApiKeyToken
Copied!
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
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"UTCDate":"2019-02-01",
7
"unixTimeStamp":"1548979200",
8
"networkUtilization":"0.8464"
9
},
10
{
11
"UTCDate":"2019-02-28",
12
"unixTimeStamp":"1551312000",
13
"networkUtilization":"0.9472"
14
}
15
]
16
}
Copied!

Get Daily Average Network Hash Rate
​

Returns the historical measure of processing power of the Ethereum network.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=dailyavghashrate
4
&startdate=2019-02-01
5
&enddate=2019-02-28
6
&sort=asc
7
&apikey=YourApiKeyToken
Copied!
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
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"UTCDate":"2019-02-01",
7
"unixTimeStamp":"1548979200",
8
"networkHashRate":"143116.0140"
9
},
10
{
11
"UTCDate":"2019-02-28",
12
"unixTimeStamp":"1551312000",
13
"networkHashRate":"157689.3983"
14
}
15
]
16
}
Copied!
​
πŸ”₯
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.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=dailytx
4
&startdate=2019-02-01
5
&enddate=2019-02-28
6
&sort=asc
7
&apikey=YourApiKeyToken
Copied!
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
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"UTCDate":"2019-02-01",
7
"unixTimeStamp":"1548979200",
8
"transactionCount":498856
9
},
10
{
11
"UTCDate":"2019-02-28",
12
"unixTimeStamp":"1551312000",
13
"transactionCount":541458
14
}
15
]
16
}
Copied!

Get Daily Average Network Difficulty
​

Returns the historical mining difficulty of the Ethereum network.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=dailyavgnetdifficulty
4
&startdate=2019-02-01
5
&enddate=2019-02-28
6
&sort=asc
7
&apikey=YourApiKeyToken
Copied!
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
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"UTCDate":"2019-02-01",
7
"unixTimeStamp":"1548979200",
8
"networkDifficulty":"2,408.028"
9
},
10
{
11
"UTCDate":"2019-02-28",
12
"unixTimeStamp":"1551312000",
13
"networkDifficulty":"2,927.453"
14
}
15
]
16
}
Copied!
​​
πŸ”₯
Tip : The networkDifficulty is represented in TeraHashes ( TH/s ).

Get Ether Historical Daily Market Cap
​

Returns the historical Ether daily market capitalization.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=ethdailymarketcap
4
&startdate=2019-02-01
5
&enddate=2019-02-28
6
&sort=asc
7
&apikey=YourApiKeyToken
Copied!
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
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"UTCDate":"2019-02-01",
7
"unixTimeStamp":"1548979200",
8
"supply":"104672819.281250",
9
"marketCap":"11203.1318476721875",
10
"price":"107.03"
11
},
12
{
13
"UTCDate":"2019-02-28",
14
"unixTimeStamp":"1551312000",
15
"supply":"105048576.406250",
16
"marketCap":"14317.0704784078125",
17
"price":"136.29"
18
}
19
]
20
}
Copied!
​​
πŸ’°
Tip : The marketCap is represented in million US Dollars ( USD ).

Get Ether Historical Price
​

Returns the historical price of 1 ETH.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=ethdailyprice
4
&startdate=2019-02-01
5
&enddate=2019-02-28
6
&sort=asc
7
&apikey=YourApiKeyToken
Copied!
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
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"UTCDate":"2019-02-01",
7
"unixTimeStamp":"1548979200",
8
"value":"107.03"
9
},
10
{
11
"UTCDate":"2019-02-28",
12
"unixTimeStamp":"1551312000",
13
"value":"136.29"
14
}
15
]
16
}
Copied!
​​
πŸ’°
Tip : The value is represented in US Dollars ( USD ).
Last modified 7d ago