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.

Get Historical Ether Balance for a Single Address By BlockNo
​

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/api
?module=account
&action=balancehistory
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
&blockno=8000000
&apikey=YourApiKeyToken
Try this endpoint in your browser
πŸ”—
​
Request
Response
Query Parameters
Parameter
Description
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.

Get Daily Average Block Size
​

Returns the daily average block size within a date range.
https://api.etherscan.io/api
?module=stats
&action=dailyavgblocksize
&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",
"blockSize_bytes":20373
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"blockSize_bytes":25117
}
]
}

Get Daily Block Count and Rewards
​

Returns the number of blocks mined daily and the amount of block rewards.
https://api.etherscan.io/api
?module=stats
&action=dailyblkcount
&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",
"blockCount":4848,
"blockRewards_Eth":"14929.464690870590355682"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"blockCount":4366,
"blockRewards_Eth":"12808.485512162356907132"
}
]
}

Get Daily Block Rewards
​

Returns the amount of block rewards distributed to miners daily.
https://api.etherscan.io/api
?module=stats
&action=dailyblockrewards
&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",
"blockRewards_Eth":"15300.65625"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"blockRewards_Eth":"12954.84375"
}
]
}

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

Returns the daily average of time needed for a block to be successfully mined.
https://api.etherscan.io/api
?module=stats
&action=dailyavgblocktime
&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",
"blockTime_sec":"17.67"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"blockTime_sec":"19.61"
}
]
}

Get Daily Uncle Block Count and Rewards
​

Returns the number of 'Uncle' blocks mined daily and the amount of 'Uncle' block rewards.
https://api.etherscan.io/api
?module=stats
&action=dailyuncleblkcount
&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",
"uncleBlockCount":287,
"uncleBlockRewards_Eth":"729.75"
},
{
"UTCDate":"2019-02-28",
"unixTimeStamp":"1551312000",
"uncleBlockCount":288,
"uncleBlockRewards_Eth":"691.5"
}
]
}

Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo
​

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/api
?module=stats
&action=tokensupplyhistory
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
&blockno=8000000
&apikey=YourApiKeyToken
Try this endpoint in your browser
πŸ”—
​
Request
Response
Query Parameters
Parameter
Description
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

Get Historical ERC20-Token Account Balance for TokenContractAddress by BlockNo
​

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/api
?module=account
&action=tokenbalancehistory
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761
&blockno=8000000
&apikey=YourApiKeyToken
Try this endpoint in your browser
πŸ”—
​
Request
Response
Query Parameters
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​
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

Get Token Info by ContractAddress
​

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/api
?module=token
&action=tokeninfo
&contractaddress=0x0e3a2a1f2146d86a604adc220b4967a898d7fe07
&apikey=YourApiKeyToken
Try this endpoint in your browser
πŸ”—
​
Request
Response
Query Parameters
Parameter
Description
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"
}
]
}

Get Daily Average Gas Limit
​

Returns the historical daily average gas limit of the Ethereum network.
https://api.etherscan.io/api
?module=stats
&action=dailyavggaslimit
&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-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"
}
]
}

Get Ethereum Daily Total Gas Used
​

Returns the total amount of gas used daily for transctions on the Ethereum network.
https://api.etherscan.io/api
?module=stats
&action=dailygasused
&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-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"
}
]
}

Get Daily Average Gas Price
​

Returns the daily average gas price used on the Ethereum network.
https://api.etherscan.io/api
?module=stats
&action=dailyavggasprice
&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-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"
}
]
}

Get Daily Network Transaction Fee
​

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

Get Daily New Address Count
​

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

Get Daily Network Utilization
​

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

Get Daily Average Network Hash Rate
​

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

Get Daily Transaction Count
​

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

Get Daily Average Network Difficulty
​

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

Get Ether Historical Daily Market Cap
​

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

Get Ether Historical Price
​

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