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.basescan.org/api
?module=account
&action=balancehistory
&address=0xf977814e90da44bfa03b6295a0616a897441acec
&blockno=10000000
&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":"24095801991560885658761"
}
Get Daily Average Block Size
Returns the daily average block size within a date range.
https://api.basescan.org/api
?module=stats
&action=dailyavgblocksize
&startdate=2023-08-01
&enddate=2023-08-02
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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": "2023-08-01",
"unixTimeStamp": "1690848000",
"blockSize_bytes": 0
},
{
"UTCDate": "2023-08-02",
"unixTimeStamp": "1690934400",
"blockSize_bytes": 0
}
]
}
Returns the number of blocks validated daily and the amount of block rewards.
https://api.basescan.org/api
?module=stats
&action=dailyblkcount
&startdate=2023-08-01
&enddate=2023-08-02
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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": "2023-08-01",
"unixTimeStamp": "1690848000",
"blockSize_bytes": 0
},
{
"UTCDate": "2023-08-02",
"unixTimeStamp": "1690934400",
"blockSize_bytes": 0
}
]
}
Returns the amount of block rewards distributed to validators daily.
https://api.basescan.org/api
?module=stats
&action=dailyblockrewards
&startdate=2023-08-01
&enddate=2023-08-02
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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": "2023-08-01",
"unixTimeStamp": "1690848000",
"blockRewards_Eth": "29.342876545277035327"
},
{
"UTCDate": "2023-08-02",
"unixTimeStamp": "1690934400",
"blockRewards_Eth": "26.520254682077361269"
}
]
}
Returns the daily average of time needed for a block to be successfully validated.
https://api.basescan.org/api
?module=stats
&action=dailyavgblocktime
&startdate=2023-08-01
&enddate=2023-08-02
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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": "2023-08-01",
"unixTimeStamp": "1690848000",
"blockTime_sec": "0.00"
},
{
"UTCDate": "2023-08-02",
"unixTimeStamp": "1690934400",
"blockTime_sec": "0.00"
}
]
}
Returns the historical amount of a 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.basescan.org/api
?module=stats
&action=tokensupplyhistory
&contractaddress=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
&blockno=10000000
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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":"205971585207240"
}
📈 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
Returns the balance of a 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.basescan.org/api
?module=account
&action=tokenbalancehistory
&contractaddress=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
&address=0x1d147c866182f072c821eb1fa9817e87b9547861
&blockno=11801569
&apikey=YourApiKeyToken
the contract address of the ERC-20 token
the integer block number to check total supply for eg. 4000000
Return the current ERC20 token holders and number of tokens held.
https://api.basescan.org/api
?module=account
&action=addresstokenbalance
&address=0xFd92F4e91d54B9EF91cc3f97C011a6aF0C2a7eDa
&page=1
&offset=2
&apikey=YourApikeyToken
Try this endpoint in your browser 🔗
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": "0xc088797eaee27e0b1b80cd0ccc02b5792182ba6d",
"TokenName": "BASELOL",
"TokenSymbol": "BASELOL",
"TokenQuantity": "4000000000000000000000",
"TokenDivisor": "18"
},
{
"TokenAddress": "0x599005e69d937c2e30603d3571347f1f705ebf3a",
"TokenName": "Ether Pulse",
"TokenSymbol": "ETPS",
"TokenQuantity": "66870216684000000000",
"TokenDivisor": "12"
}
]
}
Return the current ERC20 token holders and number of tokens held.
https://api.basescan.org/api
?module=account
&action=addresstokennftbalance
&address=0x64baeb02876aa58078aa25c1c43b7a5492873559
&page=1
&offset=2
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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": "0x85e7df5708902be39891d59abef8e21ede91e8bf",
"TokenName": "Degen Haberdashers",
"TokenSymbol": "DGNHTS",
"TokenQuantity": "8"
},
{
"TokenAddress": "0x10e65619e75214cc6e8c2522a83acf8636ce9dfd",
"TokenName": "Degens",
"TokenSymbol": "DEGEN",
"TokenQuantity": "100"
}
]
}
https://api.basescan.org/api
?module=account
&action=addresstokennftinventory
&address=0x64baeb02876aa58078aa25c1c43b7a5492873559
&contractaddress=0x85e7df5708902be39891d59abef8e21ede91e8bf
&page=1
&offset=20
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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": "0x85e7df5708902be39891d59abef8e21ede91e8bf",
"TokenId": "454"
},
{
"TokenAddress": "0x85e7df5708902be39891d59abef8e21ede91e8bf",
"TokenId": "355"
},
{
"TokenAddress": "0x85e7df5708902be39891d59abef8e21ede91e8bf",
"TokenId": "486"
},
{
"TokenAddress": "0x85e7df5708902be39891d59abef8e21ede91e8bf",
"TokenId": "588"
},
{
"TokenAddress": "0x85e7df5708902be39891d59abef8e21ede91e8bf",
"TokenId": "338"
},
{
"TokenAddress": "0x85e7df5708902be39891d59abef8e21ede91e8bf",
"TokenId": "103"
},
{
"TokenAddress": "0x85e7df5708902be39891d59abef8e21ede91e8bf",
"TokenId": "405"
},
{
"TokenAddress": "0x85e7df5708902be39891d59abef8e21ede91e8bf",
"TokenId": "683"
}
]
}
Return the current ERC20 token holders and number of tokens held.
https://api.basescan.org/api
?module=token
&action=tokenholderlist
&contractaddress=0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb&
&page=1
&offset=10
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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": "0xba12222222228d8ba445958a75a0704d566bf2c8",
"TokenHolderQuantity": "4573970636171019544227"
},
{
"TokenHolderAddress": "0x1ded454abc7e02119adf09860954144847c9f619",
"TokenHolderQuantity": "10000000000000000"
}
]
}
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.basescan.org/api
?module=token
&action=tokeninfo
&contractaddress=0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the contract address of the ERC-20/ERC-721 token to retrieve token info
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"contractAddress": "0x50c5725949a6f0c72e6c4a641f24049a917db0cb",
"tokenName": "Dai Stablecoin",
"symbol": "DAI",
"divisor": "18",
"tokenType": "ERC20",
"totalSupply": "2921565106401030186792291",
"blueCheckmark": "true",
"description": "",
"website": "https://makerdao.com/",
"email": "integrations@makerdao.com",
"blog": "https://blog.makerdao.com/",
"reddit": "https://www.reddit.com/r/MakerDAO/",
"slack": "https://chat.makerdao.com/",
"facebook": "",
"twitter": "https://twitter.com/MakerDAO",
"bitcointalk": "",
"github": "",
"telegram": "https://t.me/makerdaoOfficial",
"wechat": "",
"linkedin": "",
"discord": "https://discord.com/invite/RBRumCpEDH",
"whitepaper": "http://docs.makerdao.com/",
"tokenPriceUSD": "0.9999334003"
}
]
}
Returns the historical daily average gas limit of the Base network.
https://api.basescan.org/api
?module=stats
&action=dailyavggaslimit
&startdate=2023-08-01
&enddate=2023-08-02
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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": "2023-08-01",
"unixTimeStamp": "1690848000",
"gasLimit": "30000000"
},
{
"UTCDate": "2023-08-02",
"unixTimeStamp": "1690934400",
"gasLimit": "30000000"
}
]
}
Returns the total amount of gas used daily for transactions on the Base network.
https://api.basescan.org/api
?module=stats
&action=dailygasused
&startdate=2023-08-01
&enddate=2023-08-02
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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": "2023-08-01",
"unixTimeStamp": "1690848000",
"gasUsed": "38608792398"
},
{
"UTCDate": "2023-08-02",
"unixTimeStamp": "1690934400",
"gasUsed": "47317486287"
}
]
}
Returns the daily average gas price used on the Base network.
https://api.basescan.org/api
?module=stats
&action=dailyavggasprice
&startdate=2023-08-01
&enddate=2023-08-02
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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": "2023-08-01",
"unixTimeStamp": "1690848000",
"maxGasPrice_Wei": "2000000000051",
"minGasPrice_Wei": "100",
"avgGasPrice_Wei": "1192177546"
},
{
"UTCDate": "2023-08-02",
"unixTimeStamp": "1690934400",
"maxGasPrice_Wei": "3451000000054",
"minGasPrice_Wei": "100",
"avgGasPrice_Wei": "1246498225"
}
]
}
Returns the historical price of 1 ETH.
https://api.basescan.org/api
?module=stats
&action=ethdailyprice
&startdate=2023-08-01
&enddate=2023-08-02
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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": "2023-08-01",
"unixTimeStamp": "1690848000",
"value": "1872.94"
},
{
"UTCDate": "2023-08-02",
"unixTimeStamp": "1690934400",
"value": "1839.06"
}
]
}
💰 Tip : The value is represented in US Dollars ( USD ).
Returns the historical amount of transaction fees paid to validators per day.
https://api.basescan.org/api?
module=stats
&action=dailytxnfee
&startdate=2023-08-01
&enddate=2023-08-02
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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": "2023-08-01",
"unixTimeStamp": "1690848000",
"transactionFee_Eth": "0"
},
{
"UTCDate": "2023-08-02",
"unixTimeStamp": "1690934400",
"transactionFee_Eth": "0"
}
]
}
Returns the historical number of new Base Chain addresses created per day.
https://api.basescan.org/api
?module=stats
&action=dailynewaddress
&startdate=2023-08-01
&enddate=2023-08-02
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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": "2023-08-01",
"unixTimeStamp": "1690848000",
"newAddressCount": 12772
},
{
"UTCDate": "2023-08-02",
"unixTimeStamp": "1690934400",
"newAddressCount": 12692
}
]
}
Returns the daily average gas used over gas limit percentage.
https://api.basescan.org/api
?module=stats
&action=dailynetutilization
&startdate=2023-08-01
&enddate=2023-08-02
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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": "2023-08-01",
"unixTimeStamp": "1690848000",
"networkUtilization": "0.0315"
},
{
"UTCDate": "2023-08-02",
"unixTimeStamp": "1690934400",
"networkUtilization": "0.0383"
}
]
}
Returns the number of transactions performed on the Base Chain per day.
https://api.basescan.org/api
?module=stats
&action=dailytx
&startdate=2023-08-01
&enddate=2023-08-02
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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": "2023-08-01",
"unixTimeStamp": "1690848000",
"transactionCount": 206671
},
{
"UTCDate": "2023-08-02",
"unixTimeStamp": "1690934400",
"transactionCount": 193053
}
]
}
