Tokens

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 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20 token

Response

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 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20 token
address	the string representing the address to check for token balance

Response

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

Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo

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 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20 token
blockno	the integer block number to check total supply for eg. 12697906

Response

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

Get Historical ERC20-Token Account Balance for TokenContractAddress by BlockNo

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 🔗

Request

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. 12697906

Response

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

Get Address ERC-20 Token Holdings

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 🔗

Request

Query Parameters

Parameter	Description
address	the string representing the address to check for Token Holdings
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

Response

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"
    }
  ]
}

Get Address ERC-721 Token Holding

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 🔗

Request

Query Parameters

Parameter	Description
address	the string representing the address to check for Token Holdings
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

Response

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "TokenAddress": "0x4245a1bd84eb5f3ebc115c2edf57e50667f98b0b",
      "TokenName": "Hopper",
      "TokenSymbol": "HOP",
      "TokenQuantity": "3"
    },
    {
      "TokenAddress": "0x0e1ce5cd26d67fd416dc6a22eb97d60131d0901b",
      "TokenName": "Tadpole",
      "TokenSymbol": "TADP",
      "TokenQuantity": "2"
    }
  ]
}

Get Address ERC721 Token Inventory By Contract Address

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 🔗

Request

Query Parameters

Parameter	Description
address	the string representing the address to check for inventory
contractaddress	the contract address of the ERC-721 token
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

Response

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "TokenAddress": "0x5fc6259e19b93d407c51fe83d6ed147e712cd6ff",
      "TokenId": "1018"
    },
    {
      "TokenAddress": "0x5fc6259e19b93d407c51fe83d6ed147e712cd6ff",
      "TokenId": "1119"
    }
  ]
}

Get Token Holder List by Contract Address

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 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20 token
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

Response

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "TokenHolderAddress": "0x0071049cdbe8a04d12a261e0fe0dd0cfb532ee0b",
      "TokenHolderQuantity": "2284595272998005019497603"
    },
    {
      "TokenHolderAddress": "0x0106434dd1fb2272925b751d88ba70912f647a3a",
      "TokenHolderQuantity": "1593281605987185960392244"
    }
  ]
}

Get Token Info by ContractAddress

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 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20/ERC-721 token to retrieve token info

Response

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"
        }
    ]
}