API PRO Endpoints
Additional API endpoints available under the Etherscan V2 subscription.
Get Historical BNB Balance for a Single Address by BlockNo 

Returns the historical BNB balance of an address at a certain block height.
https://api.etherscan.io/v2/api
?chainid=56
&module=account
&action=balancehistory
&address=0x0DB011018728D1B91dDB3C77933a40B9B68C9fa7
&blockno=2000000
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
address
the strings
representing the addresses to check for balance, separated by ,
commas
blockno
the integer
block number to check balance for eg. 2000000
Get Daily Average Block Size 

Returns the daily average block size within a date range.
https://api.etherscan.io/v2/api
?chainid=56
&module=stats
&action=dailyavgblocksize
&startdate=2021-08-01
&enddate=2021-08-31
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
startdate
the starting date in yyyy-MM-dd
format, eg. 2021-08-01
enddate
the ending date in yyyy-MM-dd
format, eg. 2021-08-31
sort
the sorting preference, use asc
to sort by ascending and desc
to sort by descending
Get Daily Block Count and Rewards 

Returns the number of blocks validated daily and the amount of block rewards.
https://api.etherscan.io/v2/api
?chainid=56
&module=stats
&action=dailyblkcount
&startdate=2021-08-01
&enddate=2021-08-31
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
startdate
the starting date in yyyy-MM-dd
format, eg. 2021-08-01
enddate
the ending date in yyyy-MM-dd
format, eg. 2021-08-31
sort
the sorting preference, use asc
to sort by ascending and desc
to sort by descending
Get Daily Block Rewards 

Returns the amount of block rewards distributed to validators daily.
https://api.etherscan.io/v2/api
?chainid=56
&module=stats
&action=dailyblockrewards
&startdate=2021-08-01
&enddate=2021-08-31
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
startdate
the starting date in yyyy-MM-dd
format, eg. 2021-08-01
enddate
the ending date in yyyy-MM-dd
format, eg. 2021-08-31
sort
the sorting preference, use asc
to sort by ascending and desc
to sort by descending
Get Daily Average Time for A Block to be Included in the BNB Smart Chain 

Returns the daily average of time needed for a block to be successfully validated.
https://api.etherscan.io/v2/api
?chainid=56
&module=stats
&action=dailyavgblocktime
&startdate=2021-08-01
&enddate=2021-08-31
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
startdate
the starting date in yyyy-MM-dd
format, eg. 2021-08-01
enddate
the ending date in yyyy-MM-dd
format, eg. 2021-08-31
sort
the sorting preference, use asc
to sort by ascending and desc
to sort by descending
Get Token Holder List by Contract Address 

Return the current token holders and number of tokens held.
https://api.etherscan.io/v2/api
?chainid=56
&module=token
&action=tokenholderlist
&contractaddress=0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82
&page=1
&offset=10
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
contractaddress
the contract address
of the BEP-20 token
page
the integer
page number, if pagination is enabled
offset
the number of transactions displayed per page
Get Historical BEP-20 Token TotalSupply by ContractAddress & BlockNo 

Returns the historical amount of a BEP-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=56
&module=stats
&action=tokensupplyhistory
&contractaddress=0xc9849e6fdb743d08faee3e34dd2d1bc69ea11a51
&blockno=4000000
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
contractaddress
the contract address
of the BEP-20 token
blockno
the integer
block number to check total supply for eg. 4000000
Get Historical BEP-20 Token Account Balance by ContractAddress & BlockNo 

Returns the balance of a BEP-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=56
&module=account
&action=tokenbalancehistory
&contractaddress=0xc9849e6fdb743d08faee3e34dd2d1bc69ea11a51
&address=0x7bb89460599dbf32ee3aa50798bbceae2a5f7f6a
&blockno=4000000
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
contractaddress
the contract address
of the BEP-20 token
address
the string
representing the address to check for balance
blockno
the integer
block number to check total supply for eg. 400000
Get Token Info by ContractAddress 

Returns project information and social media links of a BEP-20 token.
https://api.etherscan.io/v2/api
?chainid=56
&module=token
&action=tokeninfo
&contractaddress=0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
contractaddress
the contract address
of the BEP-20 token to retrieve token info
Get Daily Average Gas Limit

Returns the historical daily average gas limit of the BNB Smart Chain network.
https://api.etherscan.io/v2/api
?module=stats
&action=dailyavggaslimit
&startdate=2021-08-01
&enddate=2021-08-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
startdate
the starting date in yyyy-MM-dd
format, eg. 2021-08-01
enddate
the ending date in yyyy-MM-dd
format, eg. 2021-08-28
sort
the sorting preference, use asc
to sort by ascending and desc
to sort by descending
Get BNB Smart Chain Daily Total Gas Used

Returns the total amount of gas used daily for transctions on the BNB Smart Chainnetwork.
https://api.etherscan.io/v2/api
?module=stats
&action=dailygasused
&startdate=2021-02-01
&enddate=2021-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
startdate
the starting date in yyyy-MM-dd
format, eg. 2021-01-01
enddate
the ending date in yyyy-MM-dd
format, eg. 2021-02-28
sort
the sorting preference, use asc
to sort by ascending and desc
to sort by descending
Get Daily Average Gas Price

Returns the daily average gas price used on the BNB Smart Chain network.
https://api.etherscan.io/v2/api
?module=stats
&action=dailyavggasprice
&startdate=2021-02-01
&enddate=2021-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
startdate
the starting date in yyyy-MM-dd
format, eg. 2021-02-01
enddate
the ending date in yyyy-MM-dd
format, eg. 2021-02-28
sort
the sorting preference, use asc
to sort by ascending and desc
to sort by descending
Get BNB Historical Price 

Returns the historical price of 1 BNB.
https://api.etherscan.io/v2/api
?chainid=56
&module=stats
&action=bnbdailyprice
&startdate=2021-08-01
&enddate=2021-08-31
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
startdate
the starting date in yyyy-MM-dd
format, eg. 2021-08-01
enddate
the ending date in yyyy-MM-dd
format, eg. 2021-08-28
sort
the sorting preference, use asc
to sort by ascending and desc
to sort by descending
Get Daily Network Transaction Fee 

Returns the historical amount of transaction fees paid to validators per day.
https://api.etherscan.io/v2/api?
module=stats
&action=dailytxnfee
&startdate=2020-10-01
&enddate=2020-10-31
&apikey=YourApiKeyToken
&sort=asc
Try this endpoint in your browser 🔗
Query Parameters
startdate
the starting date in yyyy-MM-dd
format, eg. 2020-10-01
enddate
the ending date in yyyy-MM-dd
format, eg. 2020-10-31
sort
the sorting preference, use asc
to sort by ascending and desc
to sort by descending
Get Daily New Address Count 

Returns the historical number of new BNB Smart Chain addresses created per day.
https://api.etherscan.io/v2/api
?chainid=56
&module=stats
&action=dailynewaddress
&startdate=2020-10-01
&enddate=2020-10-31
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
startdate
the starting date in yyyy-MM-dd
format, eg. 2020-10-01
enddate
the ending date in yyyy-MM-dd
format, eg. 2020-10-31
sort
the sorting preference, use asc
to sort by ascending and desc
to sort by descending
Get Daily Network Utilization 

Returns the daily average gas used over gas limit percentage.
https://api.etherscan.io/v2/api
?chainid=56
&module=stats
&action=dailynetutilization
&startdate=2021-07-01
&enddate=2021-07-31
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
startdate
the starting date in yyyy-MM-dd
format, eg. 2021-07-01
enddate
the ending date in yyyy-MM-dd
format, eg. 2021-07-28
sort
the sorting preference, use asc
to sort by ascending and desc
to sort by descending
Get Daily Transaction Count 

Returns the number of transactions performed on the BNB Smart Chain per day.
https://api.etherscan.io/v2/api
?chainid=56
&module=stats
&action=dailytx
&startdate=2021-07-01
&enddate=2021-07-31
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
startdate
the starting date in yyyy-MM-dd
format, eg. 2021-07-01
enddate
the ending date in yyyy-MM-dd
format, eg. 2021-07-28
sort
the sorting preference, use asc
to sort by ascending and desc
to sort by descending
Get Address BEP20 Token Holding 

Returns the BEP-20 tokens and amount held by an address.
📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
https://api.etherscan.io/v2/api
?chainid=56
&module=account
&action=addresstokenbalance
&address=0x99817ce62abf5b17f58e71071e590cf958e5a1bf
&page=1
&offset=100
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
address
the string
representing the address to check for balance
page
the integer
page number, if pagination is enabled
offset
the number of transactions displayed per page
Get Address ERC721 Token Holding 

Returns the BEP-721 tokens and amount held by an address.
📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
https://api.etherscan.io/v2/api
?chainid=56
&module=account
&action=addresstokennftbalance
&address=0x99817ce62abf5b17f58e71071e590cf958e5a1bf
&page=1
&offset=100
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
address
the string
representing the address to check for balance
page
the integer
page number, if pagination is enabled
offset
the number of transactions displayed per page
Get Address ERC721 Token Inventory By Contract Address 

Returns the BEP-721 token inventory of an address, filtered by contract address.
📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
https://api.etherscan.io/v2/api
?chainid=56
&module=account
&action=addresstokennftinventory
&address=0x99817ce62abf5b17f58e71071e590cf958e5a1bf
&contractaddress=0x5e74094cd416f55179dbd0e45b1a8ed030e396a1
&page=1
&offset=100
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
address
the string
representing the address to check for inventory
contractaddress
the string
representing the BEP-721 token contractaddress to check for inventory
page
the integer
page number, if pagination is enabled
offset
the number of transactions displayed per page
Last updated
Was this helpful?