API PRO Endpoints
The following is a complete list of additional API endpoints available under the API PRO subscription.
Returns the historical AVAX balance of an address at a certain block height.
https://api.snowtrace.io/api
?module=account
&action=balancehistory
&address=0x9Ae47E4a02f1F9a6dc8950522aC20eA62009804E
&blockno=9319008
&apikey=YourApiKeyToken
Request
Response
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 |
Sample Response
{
"status": "1",
"message": "OK",
"result": "9154289378804537987"
}
Returns the daily average block size within a date range.
https://api.snowtrace.io/api
?module=stats
&action=dailyavgblocksize
&startdate=2023-4-04
&enddate=2023-4-05
&sort=asc
&apikey=YourApiKeyToken
Request
Response
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 |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2023-04-04",
"unixTimeStamp": "1680566400",
"blockSize_bytes": 3166
},
{
"UTCDate": "2023-04-05",
"unixTimeStamp": "1680652800",
"blockSize_bytes": 3878
}
]
}
Returns the number of blocks validated daily and the amount of block rewards.
https://api.snowtrace.io/api
?module=stats
&action=dailyblkcount
&startdate=2023-4-04
&enddate=2023-4-05
&sort=asc
&apikey=YourApiKeyToken
Request
Response
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 |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2023-04-04",
"unixTimeStamp": "1680566400",
"blockCount": 42718,
"blockRewards_Eth": "0"
},
{
"UTCDate": "2023-04-05",
"unixTimeStamp": "1680652800",
"blockCount": 42827,
"blockRewards_Eth": "0"
}
]
}
Returns the amount of block rewards distributed to validators daily.
https://api.snowtrace.io/api
?module=stats
&action=dailyblockrewards
&startdate=2023-4-04
&enddate=2023-4-05
&sort=asc
&apikey=YourApiKeyToken
Request
Response
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 |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2023-04-04",
"unixTimeStamp": "1680566400",
"blockRewards_Eth": "0"
},
{
"UTCDate": "2023-04-05",
"unixTimeStamp": "1680652800",
"blockRewards_Eth": "0"
}
]
}
Returns the daily average of time needed for a block to be successfully validated.
https://api.snowtrace.io/api
?module=stats
&action=dailyavgblocktime
&startdate=2023-4-04
&enddate=2023-4-05
&sort=asc
&apikey=YourApiKeyToken
Request
Response
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 |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2023-04-04",
"unixTimeStamp": "1680566400",
"blockTime_sec": "2.02"
}
]
}
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.snowtrace.io/api
?module=stats
&action=tokensupplyhistory
&contractaddress=0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7
&blockno=8000000
&apikey=YourApiKeyToken
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. 4000000 |
Sample Response
{
"status": "1",
"message": "OK",
"result": "18372238808200833528079695"
}
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 215241526476136819398Returns 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.snowtrace.io/api
?module=account
&action=tokenbalancehistory
&contractaddress=0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7
&address=0xc05e61d0e7a63d27546389b7ad62fdff5a91aace
&blockno=32197490
&apikey=YourApiKeyToken
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. 400000 |
Sample Response
{
"status": "1",
"message": "OK",
"result": "82535158747503432052330"
}
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 215241526476136819398Returns project information and social media links of a ERC-20 token.
https://api.snowtrace.io/api
?module=token
&action=tokeninfo
&contractaddress=0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
contractaddress | the contract address of the ERC-20 token to retrieve token info |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"contractAddress": "0xb31f66aa3c1e785363f0875a1b74e27b85fd66c7",
"tokenName": "Wrapped AVAX",
"symbol": "WAVAX",
"divisor": "18",
"tokenType": "ERC20",
"totalSupply": "5912236477734349382684942",
"blueCheckmark": "true",
"description": "Avalanche is the fastest smart contracts platform in the blockchain industry, as measured by time-to-finality, and has the most validators securing its activity of any proof-of-stake protocol.",
"website": "https://www.avax.network/",
"email": "",
"blog": "https://medium.com/avalancheavax",
"reddit": "https://www.reddit.com/r/avax",
"slack": "",
"facebook": "https://www.facebook.com/avalabsofficial/",
"twitter": "https://twitter.com/avalancheavax",
"bitcointalk": "",
"github": "https://github.com/ava-labs",
"telegram": "https://t.me/avalancheavax",
"wechat": "",
"linkedin": "https://www.linkedin.com/company/avalabsofficial/",
"discord": "https://chat.avax.network/",
"whitepaper": "https://www.avalabs.org/whitepapers",
"tokenPriceUSD": "13.1190725661"
}
]
}
Returns the historical daily average gas limit of the Avalanche C-Chain network.
https://api.snowtrace.io/api
?module=stats
&action=dailyavggaslimit
&startdate=2021-08-01
&enddate=2021-08-28
&sort=asc
&apikey=YourApiKeyToken
Request
Response
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 |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"UTCDate":"2021-08-01",
"unixTimeStamp":"1627776000",
"gasLimit":"77995057"
},
{
"UTCDate":"2021-08-02",
"unixTimeStamp":"1627862400",
"gasLimit":"77477220"
},
{
"UTCDate":"2021-08-03",
"unixTimeStamp":"1627948800",
"gasLimit":"77163193"
}
]
}
Returns the total amount of gas used daily for transctions on the AVAX Smart Chainnetwork.
https://api.snowtrace.io/api
?module=stats
&action=dailygasused
&startdate=2023-07-04
&enddate=2023-07-05
&sort=asc
&apikey=YourApiKeyToken
Request
Response
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 |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2023-07-04",
"unixTimeStamp": "1688428800",
"gasLimit": "15000000"
}
]
}
Returns the daily average gas price used on the Avalanche C-Chain network.
https://api.snowtrace.io/api
?module=stats
&action=dailyavggasprice
&startdate=2021-02-01
&enddate=2021-02-28
&sort=asc
&apikey=YourApiKeyToken
Request
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 |
Returns the historical price of 1 AVAX.
https://api.snowtrace.io/api
?module=stats
&action=ethdailyprice
&startdate=2023-4-04
&enddate=2023-4-05
&sort=asc
&apikey=YourApiKeyToken
Request
Response
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 |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2023-04-04",
"unixTimeStamp": "1680566400",
"value": "17.65"
},
{
"UTCDate": "2023-04-05",
"unixTimeStamp": "1680652800",
"value": "18.01"
}
]
}
Tip : The
💰
value is represented in US Dollars ( USD ).Returns the historical amount of transaction fees paid to validators per day.
https://api.snowtrace.io/api?
module=stats
&action=dailytxnfee
&startdate=2023-4-04
&enddate=2023-4-05
&apikey=YourApiKeyToken
&sort=asc
Request
Response
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 |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2023-04-04",
"unixTimeStamp": "1680566400",
"transactionFee_Eth": "0"
},
{
"UTCDate": "2023-04-05",
"unixTimeStamp": "1680652800",
"transactionFee_Eth": "0"
}
]
}
Returns the historical number of new Avalanche C-Chain addresses created per day.
https://api.snowtrace.io/api
?module=stats
&action=dailynewaddress
&startdate=2023-4-04
&enddate=2023-4-05
&sort=asc
&apikey=YourApiKeyToken
Request
Response
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 |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2023-04-04",
"unixTimeStamp": "1680566400",
"newAddressCount": 63935
},
{
"UTCDate": "2023-04-05",
"unixTimeStamp": "1680652800",
"newAddressCount": 49390
}
]
}
Returns the daily average gas used over gas limit percentage.
https://api.snowtrace.io/api
?module=stats
&action=dailynetutilization
&startdate=2023-4-04
&enddate=2023-4-05
&sort=asc
&apikey=YourApiKeyToken
Request
Response
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 |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2023-04-04",
"unixTimeStamp": "1680566400",
"networkUtilization": "0.1416"
},
{
"UTCDate": "2023-04-05",
"unixTimeStamp": "1680652800",
"networkUtilization": "0.1618"
}
]
}
Returns the number of transactions performed on the Avalanche C-Chain per day.
https://api.snowtrace.io/api
?module=stats
&action=dailytx
&startdate=2023-4-04
&enddate=2023-4-05
&sort=asc
&apikey=YourApiKeyToken
Request
Response
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 |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"UTCDate": "2023-04-04",
"unixTimeStamp": "1680566400",
"transactionCount": 199183
},
{
"UTCDate": "2023-04-05",
"unixTimeStamp": "1680652800",
"transactionCount": 248041
}
]
}