Links

Tokens

Get ERC-20 Token TotalSupply by ContractAddress

Returns the total supply of a ERC-20 token.
https://api.ftmscan.com/api
?module=stats
&action=tokensupply
&contractaddress=0x841fad6eae12c286d1fd18d1d525dffa75c7effe
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
Query Parameters
Parameter
Description
contractaddress
the contract address of the ERC-20 token
Sample Response
{
"status":"1",
"message":"OK",
"result":"8394545019028224261891720"
}
📈
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 ERC-20 Token Account Balance by ContractAddress

Returns the current balance of a ERC-20 token of an address.
https://api.ftmscan.com/api
?module=account
&action=tokenbalance
&contractaddress=8394545019028224261891720
&address=0x5a411f084faa3259924a4764ff9b090c5780a159
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
Query Parameters
Parameter
Description
contractaddress
the contract address of the ERC-20 token
address
the string representing the address to check for token balance
Sample Response
{
"status":"1",
"message":"OK",
"result":"5073087897505327949"
}

Get Historical ERC-20 Token TotalSupply by ContractAddress & BlockNo

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.ftmscan.com/api
?module=stats
&action=tokensupplyhistory
&contractaddress=0x9879aBDea01a879644185341F7aF7d8343556B7a
&blockno=29492602
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
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":"52092615701495792911710408"
}
📈
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 ERC-20 Token Account Balance by ContractAddress & BlockNo

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.ftmscan.com/api
?module=account
&action=tokenbalancehistory
&contractaddress=0x8d11ec38a3eb5e956b052f67da8bdc9bef8abf3e
&address=0x1Ae31D4F3A86AD57d7F7133c56684a1210e2F87c
&blockno=42235183
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Second Tab
Query Parameters
contractaddress
the contract address of the ERC-20 token
address
the string representing the address to check for balance
blockno
the integer block number for eg. 400000
Sample Response
{
"status":"1",
"message":"OK",
"result":"511864733572594979071"
}
📈
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 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.ftmscan.com/api
?module=token
&action=tokeninfo
&contractaddress=0xe1146b9ac456fcbb60644c36fd3f868a9072fc6e
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
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":"0xe1146b9ac456fcbb60644c36fd3f868a9072fc6e",
"tokenName":"fBTC",
"symbol":"FBTC",
"divisor":"18",
"tokenType":"ERC20",
"totalSupply":"2.508457000000000000",
"blueCheckmark":"true",
"description":"",
"website":"https://fantom.foundation/defi/",
"email":"[email protected]",
"blog":"https://medium.com/fantomfoundation",
"reddit":"https://www.reddit.com/r/FantomFoundation/",
"slack":"",
"facebook":"",
"twitter":"https://twitter.com/FantomFDN",
"bitcointalk":"",
"github":"https://github.com/Fantom-Foundation",
"telegram":"https://t.me/Fantom_English",
"wechat":"",
"linkedin":"",
"discord":"http://chat.fantom.network/",
"whitepaper":"",
"tokenPriceUSD":"20938.0000000000"
}
]
}