API PRO Endpoints

The following is a complete list of additional API endpoints available under the API PRO subscription.

To upgrade your API plan, kindly visit Etherscan APIs.

Returns the balance of an address at a certain block height.

📝 Note : This API endpoint is throttled to 2 calls/second regardless of API PRO tier.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=account
   &action=balancehistory
   &address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
   &blockno=8000000
   &apikey=YourApiKeyToken

Try this endpoint in your [browser](https://api.etherscan.io/v2/api?chainid=1 &module=account&action=balancehistory&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae&blockno=8000000&apikey=YourApiKeyToken) 🔗

Query Parameters

Parameter Description

Parameter	Description
address	the `string` representing the address to check for balance
blockno	the `integer` block number to check balance for eg. `12697906`

address

the string representing the address to check for balance

blockno

the integer block number to check balance for eg. 12697906

Sample Response

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

📖 Note: The result field is denoted in wei.

Returns the daily average block size within a date range.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=stats
   &action=dailyavgblocksize
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your [browser](https://api.etherscan.io/v2/api?chainid=1 &module=stats&action=dailyavgblocksize&startdate=2019-02-01&enddate=2019-02-28&sort=asc&apikey=YourApiKeyToken) 🔗

Query Parameters

Parameter Description

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

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",
         "blockSize_bytes":20373
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "blockSize_bytes":25117
      }
   ]
}

Returns the number of blocks mined daily and the amount of block rewards.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=stats
   &action=dailyblkcount
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your [browser](https://api.etherscan.io/v2/api?chainid=1 &module=stats&action=dailyblkcount&startdate=2019-02-01&enddate=2019-02-28&sort=asc&apikey=YourApiKeyToken) 🔗

Query Parameters

Parameter Description

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

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",
         "blockCount":4848,
         "blockRewards_Eth":"14929.464690870590355682"
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "blockCount":4366,
         "blockRewards_Eth":"12808.485512162356907132"
      }
   ]
}

Returns the amount of block rewards distributed to miners daily.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=stats
   &action=dailyblockrewards
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your [browser](https://api.etherscan.io/v2/api?chainid=1 &module=stats&action=dailyblockrewards&startdate=2019-02-01&enddate=2019-02-28&sort=asc&apikey=YourApiKeyToken) 🔗

Query Parameters

Parameter Description

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

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",
         "blockRewards_Eth":"15300.65625"
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "blockRewards_Eth":"12954.84375"
      }
   ]
}

Returns the daily average of time needed for a block to be successfully mined.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=stats
   &action=dailyavgblocktime
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your [browser](https://api.etherscan.io/v2/api?chainid=1 &module=stats&action=dailyavgblocktime&startdate=2019-02-01&enddate=2019-02-28&sort=asc&apikey=YourApiKeyToken) 🔗

Query Parameters

Parameter Description

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

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",
         "blockTime_sec":"17.67"
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "blockTime_sec":"19.61"
      }
   ]
}

Returns the number of 'Uncle' blocks mined daily and the amount of 'Uncle' block rewards.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=stats
   &action=dailyuncleblkcount
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your [browser](https://api.etherscan.io/v2/api?chainid=1 &module=stats&action=dailyuncleblkcount&startdate=2019-02-01&enddate=2019-02-28&sort=asc&apikey=YourApiKeyToken) 🔗

Query Parameters

Parameter Description

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

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",
         "uncleBlockCount":287,
         "uncleBlockRewards_Eth":"729.75"
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "uncleBlockCount":288,
         "uncleBlockRewards_Eth":"691.5"
      }
   ]
}

Returns the amount of an ERC-20 token in circulation at a certain block height.

📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=stats
   &action=tokensupplyhistory
   &contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
   &blockno=8000000
   &apikey=YourApiKeyToken

Try this endpoint in your [browser](https://api.etherscan.io/v2/api?chainid=1 &module=stats&action=tokensupplyhistory&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&blockno=8000000&apikey=YourApiKeyToken) 🔗

Query Parameters

Parameter Description

Parameter	Description
contractaddress	the `contract address` of the ERC-20 token
blockno	the `integer` block number to check total supply for eg. `12697906`

contractaddress

the contract address of the ERC-20 token

blockno

the integer block number to check total supply for eg. 12697906

Sample Response

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

📈 Tip : The result is returned in the token's smallest decimal representation.

Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398

Returns the balance of an ERC-20 token of an address at a certain block height.

📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=account
   &action=tokenbalancehistory
   &contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
   &address=0xe04f27eb70e025b78871a2ad7eabe85e61212761
   &blockno=8000000
   &apikey=YourApiKeyToken

Try this endpoint in your [browser](https://api.etherscan.io/v2/api?chainid=1 &module=account&action=tokenbalancehistory&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761&blockno=8000000&apikey=YourApiKeyToken) 🔗

Query Parameters

Parameter Description

Parameter	Description
contractaddress	the `contract address` of the ERC-20 token
address	the `string` representing the address to check for balance
blockno	the `integer` block number to check total supply for eg. `12697906`

contractaddress

the contract address of the ERC-20 token

address

the string representing the address to check for balance

blockno

the integer block number to check total supply for eg. 12697906

Sample Response

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

📈 Tip : The result is returned in the token's smallest decimal representation.

Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398

Returns project information and social media links of an ERC-20/ERC-721 token.

📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.

https://api.etherscan.io/v2/api
   ?module=token
   &action=tokeninfo
   &contractaddress=0x0e3a2a1f2146d86a604adc220b4967a898d7fe07
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

Parameter Description

Parameter	Description
contractaddress	the `contract address` of the ERC-20/ERC-721 token to retrieve token info

contractaddress

the contract address of the ERC-20/ERC-721 token to retrieve token info

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "contractAddress":"0x0e3a2a1f2146d86a604adc220b4967a898d7fe07",
         "tokenName":"Gods Unchained Cards",
         "symbol":"CARD",
         "divisor":"0",
         "tokenType":"ERC721",
         "totalSupply":"6962498",
         "blueCheckmark":"true",
         "description":"A TCG on the Ethereum blockchain that uses NFT's to bring real ownership to in-game assets.",
         "website":"https://godsunchained.com/",
         "email":"",
         "blog":"https://medium.com/@fuelgames",
         "reddit":"https://www.reddit.com/r/GodsUnchained/",
         "slack":"",
         "facebook":"https://www.facebook.com/godsunchained/",
         "twitter":"https://twitter.com/godsunchained",
         "bitcointalk":"",
         "github":"",
         "telegram":"",
         "wechat":"",
         "linkedin":"",
         "discord":"https://discordapp.com/invite/DKGr2pW",
         "whitepaper":"",
         "tokenPriceUSD":"0.000000000000000000"
      }
   ]
}

Returns the historical daily average gas limit of the Ethereum network.

 https://api.etherscan.io/v2/api
    ?chainid=1
   &module=stats
    &action=dailyavggaslimit
    &startdate=2019-02-01
    &enddate=2019-02-28
    &sort=asc
    &apikey=YourApiKeyToken

Try this endpoint in your [browser](https://api.etherscan.io/v2/api?chainid=1 &module=stats&action=dailyavggaslimit&startdate=2019-02-01&enddate=2019-02-28&sort=asc&apikey=YourApiKeyToken) 🔗

Query Parameters

Parameter Description

Parameter	Description
startdate	the starting date in `yyyy-MM-dd` format, eg. `2019-01-31`
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

startdate

the starting date in yyyy-MM-dd format, eg. 2019-01-31

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",
         "gasLimit":"8001360"
      },
      {
         "UTCDate":"2019-02-27",
         "unixTimeStamp":"1551225600",
         "gasLimit":"8001071"
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "gasLimit":"8001137"
      }
   ]
}

Returns the total amount of gas used daily for transctions on the Ethereum network.

 https://api.etherscan.io/v2/api
    ?chainid=1
   &module=stats
    &action=dailygasused
    &startdate=2019-02-01
    &enddate=2019-02-28
    &sort=asc
    &apikey=YourApiKeyToken

Try this endpoint in your [browser](https://api.etherscan.io/v2/api?chainid=1 &module=stats&action=dailygasused&startdate=2019-02-01&enddate=2019-02-28&sort=asc&apikey=YourApiKeyToken) 🔗

Query Parameters

Parameter Description

Parameter	Description
startdate	the starting date in `yyyy-MM-dd` format, eg. `2019-01-31`
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

startdate

the starting date in yyyy-MM-dd format, eg. 2019-01-31

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",
         "gasUsed":"32761450415"
      },
      {
         "UTCDate":"2019-02-27",
         "unixTimeStamp":"1551225600",
         "gasUsed":"32657440136"
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "gasUsed":"33081119561"
      }
   ]
}

Returns the daily average gas price used on the Ethereum network.

 https://api.etherscan.io/v2/api
    ?chainid=1
   &module=stats
    &action=dailyavggasprice
    &startdate=2019-02-01
    &enddate=2019-02-28
    &sort=asc
    &apikey=YourApiKeyToken

Try this endpoint in your [browser](https://api.etherscan.io/v2/api?chainid=1 &module=stats&action=dailyavggasprice&startdate=2019-02-01&enddate=2019-02-28&sort=asc&apikey=YourApiKeyToken) 🔗

Query Parameters

Parameter Description

Parameter	Description
startdate	the starting date in `yyyy-MM-dd` format, eg. `2019-01-31`
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

startdate

the starting date in yyyy-MM-dd format, eg. 2019-01-31

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",
         "maxGasPrice_Wei":"60814303896257",
         "minGasPrice_Wei":"432495",
         "avgGasPrice_Wei":"13234562600"
      },
      {
         "UTCDate":"2019-02-27",
         "unixTimeStamp":"1551225600",
         "maxGasPrice_Wei":"42000000000000",
         "minGasPrice_Wei":"1000000",
         "avgGasPrice_Wei":"16334617513"
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "maxGasPrice_Wei":"237222222222257",
         "minGasPrice_Wei":"100000000",
         "avgGasPrice_Wei":"18834674068"
      }
   ]
}

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

Try this endpoint in your [browser](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

Try this endpoint in your [browser](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

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

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

Try this endpoint in your [browser](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

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

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

Try this endpoint in your [browser](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

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

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

Try this endpoint in your [browser](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

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

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

Try this endpoint in your [browser](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

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

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

Try this endpoint in your [browser](https://api.etherscan.io/v2/api?chainid=1 &module=stats&action=ethdailymarketcap&startdate=2019-02-01&enddate=2019-02-28&sort=asc&apikey=YourApiKeyToken) 🔗

Query Parameters

Parameter Description

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

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

Try this endpoint in your [browser](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

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

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

PreviousEtherscan API PRO NextFAQ

Last updated 1 month ago

API PRO Endpoints

Get Historical Ether Balance for a Single Address By BlockNo

Get Daily Average Block Size

Get Daily Block Count and Rewards

Get Daily Block Rewards

Get Daily Average Time for A Block to be Included in the Ethereum Blockchain

Get Daily Uncle Block Count and Rewards

Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo

Get Historical ERC20-Token Account Balance for TokenContractAddress by BlockNo

Get Token Info by ContractAddress

Get Daily Average Gas Limit

Get Ethereum Daily Total Gas Used

Get Daily Average Gas Price

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