Skip to main content
GET
https://api.etherscan.io
/
v2
/
api
curl "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=desc&apikey=YourApiKeyToken"

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "7156164",
      "chainTimeStamp": "2019-02-01",
      "chainSize": "184726421279",
      "clientType": "Geth",
      "syncMode": "Default"
    },
    {
      "blockNumber": "7161012",
      "chainTimeStamp": "2019-02-02",
      "chainSize": "184726654448",
      "clientType": "Geth",
      "syncMode": "Default"
    }
  ]
}

​
Query Parameters

​
apikey
string
default:"YourApiKeyToken"
Your Etherscan API key.
​
chainid
string
default:"1"
Chain ID to query, eg 1 for Ethereum, 8453 for Base from our supported chains.
​
module
string
default:"stats"
Set to stats for this endpoint.
​
action
string
default:"chainsize"
Set to chainsize for this endpoint.
​
startdate
string
default:"2019-02-01"
Starting date in yyyy-MM-dd format.
​
enddate
string
default:"2019-02-28"
Ending date in yyyy-MM-dd format.
​
clienttype
string
default:"geth"
Node client to query, either geth or parity.
​
syncmode
string
default:"default"
Node type to run, either default or archive.
​
sort
string
default:"desc"
Sort order either desc for the latest results first or asc for the oldest results first.
curl "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=desc&apikey=YourApiKeyToken"

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "7156164",
      "chainTimeStamp": "2019-02-01",
      "chainSize": "184726421279",
      "clientType": "Geth",
      "syncMode": "Default"
    },
    {
      "blockNumber": "7161012",
      "chainTimeStamp": "2019-02-02",
      "chainSize": "184726654448",
      "clientType": "Geth",
      "syncMode": "Default"
    }
  ]
}