Endpoints with are under the API Pro subscription. To upgrade your API plan, browse through the SnowScan APIs page.
Get ERC20-Token TotalSupply by ContractAddress
Returns the current amount of an ERC-20 token in circulation.
https://api.snowscan.xyz/api
?module=stats
&action=tokensupply
&contractaddress=0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
| Parameter | Description |
|---|
| the contract address of the ERC-20 token |
Sample Response
{
"status": "1",
"message": "OK",
"result": "5913813116639975973318941"
}
📈 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
Get ERC20-Token Account Balance for TokenContractAddress
Returns the current balance of an ERC-20 token of an address.
https://api.snowscan.xyz/api
?module=account
&action=tokenbalance
&contractaddress=0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7
&address=0xc05e61d0e7a63d27546389b7ad62fdff5a91aace
&tag=latest&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
| Parameter | Description |
|---|
| the contract address of the ERC-20 token |
| the string representing the address to check for token balance |
Sample Response
{
"status": "1",
"message": "OK",
"result": "82478949244361932052353"
}
📈 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 amount of an 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.snowscan.xyz/api
?module=stats
&action=tokensupplyhistory
&contractaddress=0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7
&blockno=4000000
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
| Parameter | Description |
|---|
| the contract address of the ERC-20 token |
| |
Sample Response
{
"status": "1",
"message": "OK",
"result": "7835368248615570386946043"
}
📈 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 an 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.snowscan.xyz/api
?module=account
&action=tokenbalancehistory
&contractaddress=0x9702230a8ea53601f5cd2dc00fdbc13d4df4a8c7
&address=0xc6e2a6a0ff870a1e156017ddcec5492ff6eb2b78
&blockno=32209104
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
| Parameter | Description |
|---|
| the contract address of the ERC-20 token |
| the string representing the address to check for balance |
| |
Sample Response
{
"status": "1",
"message": "OK",
"result": "18000472"
}
📈 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
Return the current ERC20 token holders and number of tokens held.
https://api.snowscan.xyz/api
?module=account
&action=addresstokenbalance
&address=0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7
&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": "0xb31f66aa3c1e785363f0875a1b74e27b85fd66c7",
"TokenName": "Wrapped AVAX",
"TokenSymbol": "WAVAX",
"TokenQuantity": "191363172752579215883",
"TokenDivisor": "18"
},
{
"TokenAddress": "0xa0a924dcb97a597351a5c3787234b706845e7510",
"TokenName": "Bonfire",
"TokenSymbol": "🔥",
"TokenQuantity": "102384713977",
"TokenDivisor": "11"
}
]
}
Return the current ERC- 721 token holders and number of tokens held.
https://api.snowscan.xyz/api
?module=account
&action=addresstokennftbalance
&address=0xE447c21dc23867E3752489c9F108eFeDDBF9F9c2
&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": "0x4245a1bd84eb5f3ebc115c2edf57e50667f98b0b",
"TokenName": "Hopper",
"TokenSymbol": "HOP",
"TokenQuantity": "3"
},
{
"TokenAddress": "0x0e1ce5cd26d67fd416dc6a22eb97d60131d0901b",
"TokenName": "Tadpole",
"TokenSymbol": "TADP",
"TokenQuantity": "2"
}
]
}
https://api.snowscan.xyz/api
?module=account
&action=addresstokennftinventory
&address=0x3e1B24a7070A7Af44d93EC681a85b729BC6a0Fa9
&contractaddress=0x5FC6259e19b93d407c51fe83D6ed147e712cd6Ff
&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": "0x5fc6259e19b93d407c51fe83d6ed147e712cd6ff",
"TokenId": "1018"
},
{
"TokenAddress": "0x5fc6259e19b93d407c51fe83d6ed147e712cd6ff",
"TokenId": "1119"
}
]
}
Return the current ERC20 token holders and number of tokens held.
https://api.snowscan.xyz/api
?module=token
&action=tokenholderlist
&contractaddress=0x02d980a0d7af3fb7cf7df8cb35d9edbcf355f665&
&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": "0x0071049cdbe8a04d12a261e0fe0dd0cfb532ee0b",
"TokenHolderQuantity": "2284595272998005019497603"
},
{
"TokenHolderAddress": "0x0106434dd1fb2272925b751d88ba70912f647a3a",
"TokenHolderQuantity": "1593281605987185960392244"
}
]
}
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.snowscan.xyz/api
?module=token
&action=tokeninfo
&contractaddress=0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
| Parameter | Description |
|---|
| the contract address of the ERC-20/ERC-721 token to retrieve token info |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"contractAddress": "0xb31f66aa3c1e785363f0875a1b74e27b85fd66c7",
"tokenName": "Wrapped AVAX",
"symbol": "WAVAX",
"divisor": "18",
"tokenType": "ERC20",
"totalSupply": "5913857118881440294410453",
"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.1112177698"
}
]
}
