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

Parameter
Description

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

Parameter
Description

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

Parameter
Description

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

Parameter
Description

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

Parameter
Description

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

Parameter
Description

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.

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

Parameter
Description

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.

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

Parameter
Description

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

Parameter
Description

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

Parameter
Description

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

Parameter
Description

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

Parameter
Description

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

Parameter
Description

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

Parameter
Description

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

Parameter
Description

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

Parameter
Description

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

Parameter
Description

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.

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

Parameter
Description

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.

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

Parameter
Description

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.

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

Parameter
Description

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?