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.
1
https://api.etherscan.io/api
2
?module=account
3
&action=balancehistory
4
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
5
&blockno=8000000
6
&apikey=YourApiKeyToken
Copied!
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
1
{
2
"status":"1",
3
"message":"OK",
4
"result":"610538078574759898951277"
5
}
Copied!
​
πŸ“–
Note: The result field is denoted in wei.

Get Daily Average Block Size
​

Returns the daily average block size within a date range.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=dailyavgblocksize
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
"blockSize_bytes":20373
9
},
10
{
11
"UTCDate":"2019-02-28",
12
"unixTimeStamp":"1551312000",
13
"blockSize_bytes":25117
14
}
15
]
16
}
Copied!

Get Daily Block Count and Rewards
​

Returns the number of blocks mined daily and the amount of block rewards.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=dailyblkcount
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
"blockCount":4848,
9
"blockRewards_Eth":"14929.464690870590355682"
10
},
11
{
12
"UTCDate":"2019-02-28",
13
"unixTimeStamp":"1551312000",
14
"blockCount":4366,
15
"blockRewards_Eth":"12808.485512162356907132"
16
}
17
]
18
}
Copied!

Get Daily Block Rewards
​

Returns the amount of block rewards distributed to miners daily.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=dailyblockrewards
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
"blockRewards_Eth":"15300.65625"
9
},
10
{
11
"UTCDate":"2019-02-28",
12
"unixTimeStamp":"1551312000",
13
"blockRewards_Eth":"12954.84375"
14
}
15
]
16
}
Copied!

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.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=dailyavgblocktime
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
"blockTime_sec":"17.67"
9
},
10
{
11
"UTCDate":"2019-02-28",
12
"unixTimeStamp":"1551312000",
13
"blockTime_sec":"19.61"
14
}
15
]
16
}
Copied!

Get Daily Uncle Block Count and Rewards
​

Returns the number of 'Uncle' blocks mined daily and the amount of 'Uncle' block rewards.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=dailyuncleblkcount
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
"uncleBlockCount":287,
9
"uncleBlockRewards_Eth":"729.75"
10
},
11
{
12
"UTCDate":"2019-02-28",
13
"unixTimeStamp":"1551312000",
14
"uncleBlockCount":288,
15
"uncleBlockRewards_Eth":"691.5"
16
}
17
]
18
}
Copied!

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.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=tokensupplyhistory
4
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
5
&blockno=8000000
6
&apikey=YourApiKeyToken
Copied!
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
1
{
2
"status":"1",
3
"message":"OK",
4
"result":"21265524714464"
5
}
Copied!
​
πŸ“ˆ
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.
1
https://api.etherscan.io/api
2
?module=account
3
&action=tokenbalancehistory
4
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
5
&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761
6
&blockno=8000000
7
&apikey=YourApiKeyToken
Copied!
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
1
{
2
"status":"1",
3
"message":"OK",
4
"result":"135499"
5
}
Copied!
​
πŸ“ˆ
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.
1
https://api.etherscan.io/api
2
?module=token
3
&action=tokeninfo
4
&contractaddress=0x0e3a2a1f2146d86a604adc220b4967a898d7fe07
5
&apikey=YourApiKeyToken
Copied!
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
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"contractAddress":"0x0e3a2a1f2146d86a604adc220b4967a898d7fe07",
7
"tokenName":"Gods Unchained Cards",
8
"symbol":"CARD",
9
"divisor":"0",
10
"tokenType":"ERC721",
11
"totalSupply":"6962498",
12
"blueCheckmark":"true",
13
"description":"A TCG on the Ethereum blockchain that uses NFT's to bring real ownership to in-game assets.",
14
"website":"https://godsunchained.com/",
15
"email":"",
16
"blog":"https://medium.com/@fuelgames",
17
"reddit":"https://www.reddit.com/r/GodsUnchained/",
18
"slack":"",
19
"facebook":"https://www.facebook.com/godsunchained/",
20
"twitter":"https://twitter.com/godsunchained",
21
"bitcointalk":"",
22
"github":"",
23
"telegram":"",
24
"wechat":"",
25
"linkedin":"",
26
"discord":"https://discordapp.com/invite/DKGr2pW",
27
"whitepaper":"",
28
"tokenPriceUSD":"0.000000000000000000"
29
}
30
]
31
}
Copied!

Get Daily Average Gas Limit
​

Returns the historical daily average gas limit of the Ethereum network.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=dailyavggaslimit
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-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
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"UTCDate":"2019-02-01",
7
"unixTimeStamp":"1548979200",
8
"gasLimit":"8001360"
9
},
10
{
11
"UTCDate":"2019-02-27",
12
"unixTimeStamp":"1551225600",
13
"gasLimit":"8001071"
14
},
15
{
16
"UTCDate":"2019-02-28",
17
"unixTimeStamp":"1551312000",
18
"gasLimit":"8001137"
19
}
20
]
21
}
Copied!

Get Ethereum Daily Total Gas Used
​

Returns the total amount of gas used daily for transctions on the Ethereum network.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=dailygasused
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-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
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"UTCDate":"2019-02-01",
7
"unixTimeStamp":"1548979200",
8
"gasUsed":"32761450415"
9
},
10
{
11
"UTCDate":"2019-02-27",
12
"unixTimeStamp":"1551225600",
13
"gasUsed":"32657440136"
14
},
15
{
16
"UTCDate":"2019-02-28",
17
"unixTimeStamp":"1551312000",
18
"gasUsed":"33081119561"
19
}
20
]
21
}
Copied!

Get Daily Average Gas Price
​

Returns the daily average gas price used on the Ethereum network.
1
https://api.etherscan.io/api
2
?module=stats
3
&action=dailyavggasprice
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-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
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"UTCDate":"2019-02-01",
7
"unixTimeStamp":"1548979200",
8
"maxGasPrice_Wei":"60814303896257",
9
"minGasPrice_Wei":"432495",
10
"avgGasPrice_Wei":"13234562600"
11
},
12
{
13
"UTCDate":"2019-02-27",
14
"unixTimeStamp":"1551225600",
15
"maxGasPrice_Wei":"42000000000000",
16
"minGasPrice_Wei":"1000000",
17
"avgGasPrice_Wei":"16334617513"
18
},
19
{
20
"UTCDate":"2019-02-28",
21
"unixTimeStamp":"1551312000",
22
"maxGasPrice_Wei":"237222222222257",
23
"minGasPrice_Wei":"100000000",
24
"avgGasPrice_Wei":"18834674068"
25
}
26
]
27
}
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