SnowScan
HomeKnowledge Base
SnowScan
SnowScan
  • Introduction
  • ✨Getting Started
    • Creating an Account
    • Getting an API key
    • Endpoint URLs
  • 🎯API Endpoints
    • Accounts
    • Contracts
    • Transactions
    • Blocks
    • Logs
    • Geth Proxy
    • Tokens
    • Stats
  • 🎯API PRO
    • API PRO
    • API PRO Endpoints
  • 📖Tutorials
    • Verifying Contracts Programmatically
  • 🔧Misc Tools & Utilities
    • Libraries
    • Plugins
  • 🤝Support
    • FAQ
    • Rate Limits
    • Common Error Messages
    • Getting Help
  • Visit SnowScan
Powered by GitBook
On this page
  • Get Historical AVAX Balance for a Single Address by BlockNo
  • Get Daily Average Block Size
  • Get Daily Block Count and Rewards
  • Get Daily Block Rewards
  • Get Daily Average Time for A Block to be Included in the Optimism Chain
  • Get Historical ERC-20 Token TotalSupply by ContractAddress & BlockNo
  • Get Historical ERC-20 Token Account Balance by ContractAddress & BlockNo
  • Get Address ERC-20 Token Holdings
  • Get Address ERC-721 Token Holding
  • Get Address ERC721 Token Inventory By Contract Address
  • Get Token Holder List by Contract Address
  • Get Token Info by ContractAddress
  • Get Daily Average Gas Limit
  • Get Avalanche Daily Total Gas Used
  • Get Daily Average Gas Price
  • Get AVAX Historical Price
  • Get Daily Network Transaction Fee
  • Get Daily New Address Count
  • Get Daily Network Utilization
  • Get Daily Transaction Count
  1. API PRO

API PRO Endpoints

PreviousAPI PRONextVerifying Contracts Programmatically

Last updated 1 year ago

The following is a complete list of additional API endpoints available under the API PRO subscription.

To upgrade your API plan, kindly visit

Get Historical AVAX Balance for a Single Address by BlockNo

Returns the historical AVAX 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.snowscan.xyz/api
   ?module=account
   &action=balancehistory
   &address=0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7
   &blockno=18798641
   &apikey=YourApiKeyToken

Try this endpoint in your

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":"9221710077641756857614664"
}

Tip: The result is returned in

Convert AVAX units using our

Get Daily Average Block Size

Returns the daily average block size within a date range.

https://api.snowscan.xyz/api
   ?module=stats
   &action=dailyavgblocksize
   &startdate=2021-08-01
   &enddate=2021-08-31
   &sort=asc
   &apikey=YourApiKeyToken

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":"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.snowscan.xyz/api
   ?module=stats
   &action=dailyblkcount
   &startdate=2021-08-01
   &enddate=2021-08-31
   &sort=asc
   &apikey=YourApiKeyToken

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":"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.snowscan.xyz/api
   ?module=stats
   &action=dailyblockrewards
   &startdate=2021-08-01
   &enddate=2021-08-31
   &sort=asc
   &apikey=YourApiKeyToken

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":"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.snowscan.xyz/api
   ?module=stats
   &action=dailyavgblocktime
   &startdate=2021-08-01
   &enddate=2021-08-31
   &sort=asc
   &apikey=YourApiKeyToken

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":"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.snowscan.xyz/api
   ?module=stats
   &action=tokensupplyhistory
   &contractaddress=0x831753dd7087cac61ab5644b308642cc1c33dc13
   &blockno=20071631
   &apikey=YourApiKeyToken

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":"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.snowscan.xyz/api
   ?module=account
   &action=tokenbalancehistory
   &contractaddress=0x831753dd7087cac61ab5644b308642cc1c33dc13
   &address=0x019ba0325f1988213d448b3472fa1cf8d07618d7
   &blockno=20169066
   &apikey=YourApiKeyToken

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":"21475814538620954598134"
}

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

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

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

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

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

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

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 

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

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.

https://api.snowscan.xyz/api
   ?module=token
   &action=tokeninfo
   &contractaddress=0xfb98b335551a418cd0737375a2ea0ded62ea213b
   &apikey=YourApiKeyToken

Query Parameters

Parameter
Description

contractaddress

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

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "contractAddress": "0xfb98b335551a418cd0737375a2ea0ded62ea213b",
      "tokenName": "Pendle",
      "symbol": "PENDLE",
      "divisor": "18",
      "tokenType": "ERC20",
      "totalSupply": "2371820393161818307917154",
      "blueCheckmark": "true",
      "description": "Pendle is essentially a protocol for tokenizing yield and an AMM for trading tokenized yield and other time-decaying assets.",
      "website": "https://pendle.finance/",
      "email": "tn@pendle.finance",
      "blog": "https://medium.com/pendle",
      "reddit": "",
      "slack": "",
      "facebook": "",
      "twitter": "https://twitter.com/pendle_fi",
      "bitcointalk": "",
      "github": "",
      "telegram": "https://t.me/pendlefinance",
      "wechat": "",
      "linkedin": "",
      "discord": "https://discord.com/invite/EAujvncY2R",
      "whitepaper": "https://docs.pendle.finance/resources/lite-paper",
      "tokenPriceUSD": "3.0963533513"
    }
  ]
}

Returns the historical daily average gas limit of the Avalanche C-Chain network.

 https://api.snowscan.xyz/api
    ?module=stats
    &action=dailyavggaslimit
    &startdate=2021-02-01
    &enddate=2021-02-28
    &sort=asc
    &apikey=YourApiKeyToken 

Query Parameters

Parameter
Description

startdate

the starting date in yyyy-MM-dd format, eg. 2019-01-31

enddate

the ending date in yyyy-MM-dd format, eg. 2019-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":"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 Avalanche C-Chain network.

 https://api.snowscan.xyz/api
    ?module=stats
    &action=dailygasused
    &startdate=2021-02-01
    &enddate=2021-02-28
    &sort=asc
    &apikey=YourApiKeyToken 

Query Parameters

Parameter
Description

startdate

the starting date in yyyy-MM-dd format, eg. 2019-01-31

enddate

the ending date in yyyy-MM-dd format, eg. 2019-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":"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 Avalanche C-Chain network.

 https://api.snowscan.xyz/api
    ?module=stats
    &action=dailyavggasprice
    &startdate=2021-02-01
    &enddate=2021-02-28
    &sort=asc
    &apikey=YourApiKeyToken 

Query Parameters

Parameter
Description

startdate

the starting date in yyyy-MM-dd format, eg. 2019-01-31

enddate

the ending date in yyyy-MM-dd format, eg. 2019-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":"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 AVAX.

https://api.snowscan.xyz/api
   ?module=stats
   &action=ethdailyprice
   &startdate=2021-08-01
   &enddate=2021-08-31
   &sort=asc
   &apikey=YourApiKeyToken

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",
          "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.snowscan.xyz/api?
   module=stats
   &action=dailytxnfee
   &startdate=2020-10-01
   &enddate=2020-10-31
   &sort=asc
   &apikey=YourApiKeyToken 

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":"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 Avalanche C-Chain addresses created per day.

https://api.snowscan.xyz/api
   ?module=stats
   &action=dailynewaddress
   &startdate=2020-10-01
   &enddate=2020-10-31
   &sort=asc
   &apikey=YourApiKeyToken

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":"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.snowscan.xyz/api
   ?module=stats
   &action=dailynetutilization
   &startdate=2021-07-01
   &enddate=2021-07-31
   &sort=asc
   &apikey=YourApiKeyToken

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":"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 Avalanche C- Chain per day.

https://api.snowscan.xyz/api
   ?module=stats
   &action=dailytx
   &startdate=2021-07-01
   &enddate=2021-07-31
   &sort=asc
   &apikey=YourApiKeyToken

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":"2021-07-01",
          "unixTimeStamp":"1625097600",
          "transactionCount":8228730
       },
       {
          "UTCDate":"2021-07-02",
          "unixTimeStamp":"1625184000",
          "transactionCount":5954493
       },
       {
          "UTCDate":"2021-07-03",
          "unixTimeStamp":"1625270400",
          "transactionCount":6247611
       }
    ]
 }

Try this endpoint in your

Get Daily Block Count and Rewards

Try this endpoint in your

Get Daily Block Rewards

Try this endpoint in your

Get Daily Average Time for A Block to be Included in the Optimism Chain

Try this endpoint in your

Get Historical ERC-20 Token TotalSupply by ContractAddress & BlockNo

Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.

Try this endpoint in your

Tip : The result is returned in the token's smallest decimal representation.

Get Historical ERC-20 Token Account Balance by ContractAddress & BlockNo

Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.

Try this endpoint in your

Tip : The result is returned in the token's smallest decimal representation.

Get Address ERC-20 Token Holdings

Try this endpoint in your

Get Address ERC-721 Token Holding

Try this endpoint in your

Get Address ERC721 Token Inventory By Contract Address

Try this endpoint in your

Get Token Holder List by Contract Address

Try this endpoint in your

Get Token Info by ContractAddress

Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.

Try this endpoint in your

Get Daily Average Gas Limit

Try this endpoint in your

Get Avalanche Daily Total Gas Used

Try this endpoint in your

Get Daily Average Gas Price

Try this endpoint in your

Get AVAX Historical Price

Try this endpoint in your

Tip : The value is represented in US Dollars ( USD ).

Get Daily Network Transaction Fee

Try this endpoint in your

Get Daily New Address Count

Try this endpoint in your

Get Daily Network Utilization

Try this endpoint in your

Get Daily Transaction Count

Try this endpoint in your

🎯
📝
📈
📝
📈
📝
💰
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
📝
🔗
📖
SnowScan APIs.
browser
wei.
Unit Converter.