LogoLogo
HomeMetadata APIAPI PROTwitter
Etherscan V2
Etherscan V2
  • Introduction
  • Chef's Pick
  • Rate Limits
  • V1 to V2 API Migration Guide
  • ✨Getting Started
    • Creating an Account
    • Getting an API Key
    • Supported Chains
    • Supported Endpoints
  • 🎯API Endpoints
    • Nametags
    • Accounts
    • Contracts
    • Transactions
    • Blocks
    • Logs
    • Geth/Parity Proxy
    • Tokens
    • Gas Tracker
    • Stats
    • L2 Deposits/Withdrawals
    • Usage
  • 🏆API PRO
    • Etherscan API PRO
    • Metadata/Name Tag API
  • 🍳Cookbook
    • Track Uniswap V4 DEX Trades
  • Get An Address's Full Transaction History
  • 🤝Support
    • FAQ
    • Legacy V1 Docs
    • Checking Usage
    • Common Error Messages
    • Getting Help
  • Visit Etherscan.io
Powered by GitBook
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 Price
  1. API Endpoints

Stats

PreviousGas TrackerNextL2 Deposits/Withdrawals

Last updated 3 months ago

Endpoints with are under the API Pro subscription. To upgrade your API plan, kindly visit .

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

No parameters required.

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":"116487067186500000000000000"
}

Tip : Easily convert Ethereum units using our

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

No parameters required.

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":{
      "EthSupply":"122373866217800000000000000",
      "Eth2Staking":"1157529105115885000000000",
      "BurntFees":"3102505506455601519229842",
      "WithdrawnTotal":"1170200333006131000000000"
   }
}

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

No parameters required.

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

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

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

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/v2/api
   ?chainid=1
   &module=stats
   &action=dailytxnfee
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken 

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/v2/api
   ?chainid=1
   &module=stats
   &action=dailynewaddress
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken 

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/v2/api
   ?chainid=1
   &module=stats
   &action=dailynetutilization
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken 

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/v2/api
   ?chainid=1
   &module=stats
   &action=dailyavghashrate
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken 

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/v2/api
   ?chainid=1
   &module=stats
   &action=dailytx
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken 

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/v2/api
   ?chainid=1
   &module=stats
   &action=dailyavgnetdifficulty
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken 

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

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

Try this endpoint in your

Note: The EthSupply is calculated before adding ETH minted as Eth2Staking rewards and subtracting BurntFees from EIP-1559.

For more information, check out our

Try this endpoint in your

Tip : The timestamps are represented in

Try this endpoint in your

the Ethereum to use, either geth or parity

the to run, either default or archive

Tip : The chainSize is represented in bytes.

Try this endpoint in your

Get Daily Network Transaction Fee

Try this endpoint in your

Get Daily New Address Count

Try this endpoint in your

Get Daily Network Utilization

Try this endpoint in your

Get Daily Average Network Hash Rate

Try this endpoint in your

Tip : The networkHashRate is represented in .

Get Daily Transaction Count

Try this endpoint in your

Get Daily Average Network Difficulty

Try this endpoint in your

​​ Tip : The networkDifficulty is represented in .

Get Ether Historical Price

Try this endpoint in your

​​ Tip : The value is represented in US Dollars ( USD ).

🎯
📝
⛓️
💰
🔗
browser
Ether Total Supply Dashboard.
🔗
browser
⏳
Unix timestamp.
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔥
GigaHashes ( GH/s )
🔗
browser
🔗
browser
🔥
TeraHashes ( TH/s )
🔗
browser
node client
type of node
🔗
📖
Etherscan API Pro
browser
unit converter.