The following is a complete list of additional API endpoints available under the API PRO subscription.
Get Historical ETH Balance for a Single Address by BlockNo
Returns the historical ETH balance of an address at a certain block height.
Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
https://api.arbiscan.io/api
?module=account
&action=balancehistory
&address=0x23eA5Ec7Ea2d4282012313c9899Cdc07bd45243d
&blockno=18798641
&apikey=YourApiKeyToken
Try this endpoint in your browser
Query Parameters
the strings representing the addresses to check for balance, separated by , commas
the integer block number to check balance for eg. 2000000
Sample Response
{
"status":"1",
"message":"OK",
"result":"3885795692543222390"
}
Get Daily Average Block Size
Returns the daily average block size within a date range.
https://api.arbiscan.io/api
?module=stats
&action=dailyavgblocksize
&startdate=2021-08-01
&enddate=2021-08-31
&sort=asc
&apikey=YourApiKeyToken
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2021-08-01
the ending date in yyyy-MM-dd format, eg. 2021-08-31
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2021-08-01",
"unixTimeStamp":"1627776000",
"blockSize_bytes":65856
},
{
"UTCDate":"2021-08-02",
"unixTimeStamp":"1627862400",
"blockSize_bytes":62925
},
{
"UTCDate":"2021-08-03",
"unixTimeStamp":"1627948800",
"blockSize_bytes":63967
},
{
"UTCDate":"2021-08-04",
"unixTimeStamp":"1628035200",
"blockSize_bytes":59825
}
]
}
Returns the number of blocks validated daily and the amount of block rewards.
https://api.arbiscan.io/api
?module=stats
&action=dailyblkcount
&startdate=2021-08-01
&enddate=2021-08-31
&sort=asc
&apikey=YourApiKeyToken
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2021-08-01
the ending date in yyyy-MM-dd format, eg. 2021-08-31
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2021-08-01",
"unixTimeStamp":"1627776000",
"blockCount":38385,
"blockRewards_Eth":"13512.99629741489684839"
},
{
"UTCDate":"2021-08-02",
"unixTimeStamp":"1627862400",
"blockCount":36898,
"blockRewards_Eth":"10415.4627450065115572"
},
{
"UTCDate":"2021-08-03",
"unixTimeStamp":"1627948800",
"blockCount":39485,
"blockRewards_Eth":"21340.315061898381392963"
},
{
"UTCDate":"2021-08-04",
"unixTimeStamp":"1628035200",
"blockCount":37536,
"blockRewards_Eth":"12519.334060666034768668"
}
]
}
Returns the amount of block rewards distributed to validators daily.
https://api.arbiscan.io/api
?module=stats
&action=dailyblockrewards
&startdate=2021-08-01
&enddate=2021-08-31
&sort=asc
&apikey=YourApiKeyToken
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2021-08-01
the ending date in yyyy-MM-dd format, eg. 2021-08-31
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2021-08-01",
"unixTimeStamp":"1627776000",
"blockRewards_Eth":"0"
},
{
"UTCDate":"2021-08-02",
"unixTimeStamp":"1627862400",
"blockRewards_Eth":"0"
},
{
"UTCDate":"2021-08-03",
"unixTimeStamp":"1627948800",
"blockRewards_Eth":"0"
}
]
}
Returns the daily average of time needed for a block to be successfully validated.
https://api.arbiscan.io/api
?module=stats
&action=dailyavgblocktime
&startdate=2021-08-01
&enddate=2021-08-31
&sort=asc
&apikey=YourApiKeyToken
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2021-08-01
the ending date in yyyy-MM-dd format, eg. 2021-08-31
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2021-08-01",
"unixTimeStamp":"1627776000",
"blockTime_sec":"2.26"
},
{
"UTCDate":"2021-08-02",
"unixTimeStamp":"1627862400",
"blockTime_sec":"2.36"
},
{
"UTCDate":"2021-08-03",
"unixTimeStamp":"1627948800",
"blockTime_sec":"2.19"
}
]
}
Returns the historical amount of a ERC-20 token in circulation at a certain block height.
https://api.arbiscan.io/api
?module=stats
&action=tokensupplyhistory
&contractaddress=0x831753dd7087cac61ab5644b308642cc1c33dc13
&blockno=20071631
&apikey=YourApiKeyToken
Query Parameters
the contract address of the ERC-20 token
the integer block number to check total supply for eg. 4000000
Sample Response
{
"status":"1",
"message":"OK",
"result":"951911913447326414573422"
}
Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398
Returns the balance of a ERC-20 token of an address at a certain block height.
https://api.arbiscan.io/api
?module=account
&action=tokenbalancehistory
&contractaddress=0x831753dd7087cac61ab5644b308642cc1c33dc13
&address=0x019ba0325f1988213d448b3472fa1cf8d07618d7
&blockno=20169066
&apikey=YourApiKeyToken
Query Parameters
the contract address of the ERC-20 token
the string representing the address to check for balance
the integer block number to check total supply for eg. 400000
Sample Response
{
"status":"1",
"message":"OK",
"result":"21475814538620954598134"
}
Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398
https://api.arbiscan.io/api
?module=account
&action=addresstokenbalance
&address=0xf977814e90da44bfa03b6295a0616a897441acec
&page=1
&offset=2
&apikey=YourApikeyToken
Query Parameters
the string representing the address to check for Token Holdings
the integer page number, if pagination is enabled
the number of transactions displayed per page
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"TokenAddress": "0x8073600f2aba6d5fa496e3826e0b46b7ea6fe2ba",
"TokenName": "Burnitrum",
"TokenSymbol": "Burni",
"TokenQuantity": "100000000000000000",
"TokenDivisor": "18"
},
{
"TokenAddress": "0x5b6cc799ca90ae99ab015bbc7a185560a6f99a71",
"TokenName": "perennial.finance",
"TokenSymbol": "PERENNIAL",
"TokenQuantity": "100000000000000000000",
"TokenDivisor": "18"
}
]
}
https://api.arbiscan.io/api
?module=account
&action=addresstokennftbalance
&address=0xbb60feb89db9397444cf3c03fe65f6f05c32bd24
&page=1
&offset=2
&apikey=YourApiKeyToken
Query Parameters
the string representing the address to check for Token Holdings
the integer page number, if pagination is enabled
the number of transactions displayed per page
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"TokenAddress": "0x5d340658400e1d2352262c7c361ace0366bf6c24",
"TokenName": "Polyhedra 2024",
"TokenSymbol": "Polyhedra 2024",
"TokenQuantity": "2"
}
]
}
https://api.arbiscan.io/api
?module=account
&action=addresstokennftinventory
&address=0x3dd14d553cfd986eac8e3bddf629d82073e188c8
&contractaddress=0x5d340658400E1D2352262c7c361ace0366bf6c24
&page=1
&offset=20
&apikey=YourApiKeyToken
Query Parameters
the string representing the address to check for inventory
the contract address of the ERC-721 token
the integer page number, if pagination is enabled
the number of transactions displayed per page
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"TokenAddress": "0x5d340658400e1d2352262c7c361ace0366bf6c24",
"TokenId": "6089"
},
{
"TokenAddress": "0x5d340658400e1d2352262c7c361ace0366bf6c24",
"TokenId": "14446"
},
{
"TokenAddress": "0x5d340658400e1d2352262c7c361ace0366bf6c24",
"TokenId": "15636"
},
{
"TokenAddress": "0x5d340658400e1d2352262c7c361ace0366bf6c24",
"TokenId": "16318"
},
{
"TokenAddress": "0x5d340658400e1d2352262c7c361ace0366bf6c24",
"TokenId": "31708"
},
{
"TokenAddress": "0x5d340658400e1d2352262c7c361ace0366bf6c24",
"TokenId": "50530"
}
]
}
https://api.arbiscan.io/api
?module=token
&action=tokenholderlist
&contractaddress=0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9&
&page=1
&offset=10
&apikey=YourApiKeyToken
Query Parameters
the contract address of the ERC-20 token
the integer page number, if pagination is enabled
the number of transactions displayed per page
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"TokenHolderAddress": "0x0000000000000000000000000000000000000001",
"TokenHolderQuantity": "5105147"
},
{
"TokenHolderAddress": "0x0000000000000000000000000000000000000004",
"TokenHolderQuantity": "32623103"
}
]
}
Returns project information and social media links of an ERC-20/ERC-721 token.
https://api.arbiscan.io/api
?module=token
&action=tokeninfo
&contractaddress=0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39
&apikey=YourApiKeyToken
Query Parameters
the contract address of the ERC-20/ERC-721 token to retrieve token info
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"contractAddress":"0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39",
"tokenName":"ChainLink Token",
"symbol":"LINK",
"divisor":"18",
"tokenType":"ERC20",
"totalSupply":"1573879.616930000000000000",
"blueCheckmark":"true",
"description":"A blockchain-based middleware, acting as a bridge between cryptocurrency smart contracts, data feeds, APIs and traditional bank account payments.",
"website":"https://chain.link/",
"email":"support@chain.link",
"blog":"",
"reddit":"",
"slack":"",
"facebook":"",
"twitter":"https://twitter.com/chainlink",
"bitcointalk":"",
"github":"",
"telegram":"",
"wechat":"",
"linkedin":"",
"discord":"",
"whitepaper":"https://link.smartcontract.com/whitepaper",
"tokenPriceUSD":"24.5400000000"
}
]
}
Returns the historical daily average gas limit of the Arbiscan network.
https://api.arbiscan.io/api
?module=stats
&action=dailyavggaslimit
&startdate=2021-02-01
&enddate=2021-02-28
&sort=asc
&apikey=YourApiKeyToken
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2019-01-31
the ending date in yyyy-MM-dd format, eg. 2019-02-28
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2021-02-01",
"unixTimeStamp":"1612137600",
"gasLimit":"19995225"
},
{
"UTCDate":"2021-02-02",
"unixTimeStamp":"1612224000",
"gasLimit":"19992137"
},
{
"UTCDate":"2021-02-03",
"unixTimeStamp":"1612310400",
"gasLimit":"19994117"
}
]
}
Returns the total amount of gas used daily for transactions on the Arbiscan network.
https://api.arbiscan.io/api
?module=stats
&action=dailygasused
&startdate=2021-02-01
&enddate=2021-02-28
&sort=asc
&apikey=YourApiKeyToken
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2019-01-31
the ending date in yyyy-MM-dd format, eg. 2019-02-28
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2021-02-01",
"unixTimeStamp":"1612137600",
"gasUsed":"15209687825"
},
{
"UTCDate":"2021-02-02",
"unixTimeStamp":"1612224000",
"gasUsed":"15486974769"
},
{
"UTCDate":"2021-02-03",
"unixTimeStamp":"1612310400",
"gasUsed":"14214840593"
}
]
}
Returns the daily average gas price used on the Arbiscan network.
https://api.arbiscan.io/api
?module=stats
&action=dailyavggasprice
&startdate=2021-02-01
&enddate=2021-02-28
&sort=asc
&apikey=YourApiKeyToken
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2019-01-31
the ending date in yyyy-MM-dd format, eg. 2019-02-28
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2021-02-01",
"unixTimeStamp":"1612137600",
"maxGasPrice_Wei":"243000000000",
"minGasPrice_Wei":"1000000000",
"avgGasPrice_Wei":"2565412962"
},
{
"UTCDate":"2021-02-02",
"unixTimeStamp":"1612224000",
"maxGasPrice_Wei":"338000000000",
"minGasPrice_Wei":"1000000000",
"avgGasPrice_Wei":"2815449842"
},
{
"UTCDate":"2021-02-03",
"unixTimeStamp":"1612310400",
"maxGasPrice_Wei":"328000000000",
"minGasPrice_Wei":"1000000000",
"avgGasPrice_Wei":"3135220373"
}
]
}
Returns the historical price of 1 ETH.
https://api.arbiscan.io/api
?module=stats
&action=ethdailyprice
&startdate=2021-08-01
&enddate=2021-08-31
&sort=asc
&apikey=YourApiKeyToken
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2021-08-01
the ending date in yyyy-MM-dd format, eg. 2021-08-28
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2021-08-01",
"unixTimeStamp":"1627776000",
"value":"1.05"
},
{
"UTCDate":"2021-08-02",
"unixTimeStamp":"1627862400",
"value":"1.05"
},
{
"UTCDate":"2021-08-03",
"unixTimeStamp":"1627948800",
"value":"1.02"
}
]
}
Returns the historical amount of transaction fees paid to validators per day.
https://api.arbiscan.io/api?
module=stats
&action=dailytxnfee
&startdate=2020-10-01
&enddate=2020-10-31
&sort=asc
&apikey=YourApiKeyToken
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2020-10-01
the ending date in yyyy-MM-dd format, eg. 2020-10-31
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2020-10-01",
"unixTimeStamp":"1601510400",
"transactionFee_Eth":"14.25013925284"
},
{
"UTCDate":"2020-10-02",
"unixTimeStamp":"1601596800",
"transactionFee_Eth":"12.01774328819"
},
{
"UTCDate":"2020-10-03",
"unixTimeStamp":"1601683200",
"transactionFee_Eth":"12.13871641757844851"
}
]
}
Returns the historical number of new Arbitrum Chain addresses created per day.
https://api.arbiscan.io/api
?module=stats
&action=dailynewaddress
&startdate=2020-10-01
&enddate=2020-10-31
&sort=asc
&apikey=YourApiKeyToken
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2020-10-01
the ending date in yyyy-MM-dd format, eg. 2020-10-31
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2020-10-01",
"unixTimeStamp":"1601510400",
"newAddressCount":2131
},
{
"UTCDate":"2020-10-02",
"unixTimeStamp":"1601596800",
"newAddressCount":1405
},
{
"UTCDate":"2020-10-03",
"unixTimeStamp":"1601683200",
"newAddressCount":124
}
]
}
Returns the daily average gas used over gas limit percentage.
https://api.arbiscan.io/api
?module=stats
&action=dailynetutilization
&startdate=2021-07-01
&enddate=2021-07-31
&sort=asc
&apikey=YourApiKeyToken
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2021-07-01
the ending date in yyyy-MM-dd format, eg. 2021-07-28
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2021-07-01",
"unixTimeStamp":"1625097600",
"networkUtilization":"0.8838"
},
{
"UTCDate":"2021-07-02",
"unixTimeStamp":"1625184000",
"networkUtilization":"0.7714"
},
{
"UTCDate":"2021-07-03",
"unixTimeStamp":"1625270400",
"networkUtilization":"0.7928"
}
]
}
Returns the number of transactions performed on the Arbitrum Chain per day.
https://api.arbiscan.io/api
?module=stats
&action=dailytx
&startdate=2021-07-01
&enddate=2021-07-31
&sort=asc
&apikey=YourApiKeyToken
Query Parameters
the starting date in yyyy-MM-dd format, eg. 2021-07-01
the ending date in yyyy-MM-dd format, eg. 2021-07-28
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2021-07-01",
"unixTimeStamp":"1625097600",
"transactionCount":8228730
},
{
"UTCDate":"2021-07-02",
"unixTimeStamp":"1625184000",
"transactionCount":5954493
},
{
"UTCDate":"2021-07-03",
"unixTimeStamp":"1625270400",
"transactionCount":6247611
}
]
}
