Links

API PRO Endpoints

The following is a complete list of additional API endpoints available under the API PRO subscription.
To upgrade your API plan, kindly visit FTMScan APIs.

Get Historical FTM Balance for a Single Address by BlockNo

Returns the historical FTM 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.ftmscan.com/api
?module=account
&action=balancehistory
&address=0x30cd55FE125A944250bfEcF898B2Ff1a8594D375
&blockno=41505365
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
Query Parameters
Parameter
Description
address
the string representing the address to check for balance
blockno
the integer block number to check balance for eg. 2000000
Sample Response
{
"status":"1",
"message":"OK",
"result":"1989573740698256104"
}
📖
Tip: The result is returned in wei.
Convert FTM units using our Unit Converter.

Get Daily Average Block Size

Returns the daily average block size within a date range.
https://api.ftmscan.com/api
?module=stats
&action=dailyavgblocksize
&startdate=2021-08-01
&enddate=2021-08-31
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
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":"2021-08-01",
"unixTimeStamp":"1627776000",
"blockSize_bytes":1723
},
{
"UTCDate":"2021-08-02",
"unixTimeStamp":"1627862400",
"blockSize_bytes":1633
},
{
"UTCDate":"2021-08-31",
"unixTimeStamp":"1630368000",
"blockSize_bytes":4313
}
]
}

Get Daily Block Count and Rewards

Returns the number of blocks validated daily and the amount of block rewards.
https://api.ftmscan.com/api
?module=stats
&action=dailyblkcount
&startdate=2021-08-01
&enddate=2021-08-31
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
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":"2021-08-01",
"unixTimeStamp":"1627776000",
"blockCount":85673,
"blockRewards_Eth":"4283.005213742644278518"
},
{
"UTCDate":"2021-08-02",
"unixTimeStamp":"1627862400",
"blockCount":90499,
"blockRewards_Eth":"4682.400417201011993297"
},
{
"UTCDate":"2021-08-31",
"unixTimeStamp":"1630368000",
"blockCount":85760,
"blockRewards_Eth":"27185.856197600407018124"
}
]
}

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

Returns the daily average of time needed for a block to be successfully validated.
https://api.ftmscan.com/api
?module=stats
&action=dailyavgblocktime
&startdate=2021-08-01
&enddate=2021-08-31
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
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":"2021-08-01",
"unixTimeStamp":"1627776000",
"blockTime_sec":"1.01"
},
{
"UTCDate":"2021-08-02",
"unixTimeStamp":"1627862400",
"blockTime_sec":"0.95"
},
{
"UTCDate":"2021-08-31",
"unixTimeStamp":"1630368000",
"blockTime_sec":"1.01"
}
]
}

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

Get Daily Average Gas Limit

Returns the historical daily average gas limit of the Fantom network.
https://api.ftmscan.com/api
?module=stats
&action=dailyavggaslimit
&startdate=2021-02-01
&enddate=2021-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
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":"281474976710655"
},
{
"UTCDate":"2021-02-02",
"unixTimeStamp":"1612224000",
"gasLimit":"281474976710655"
},
{
"UTCDate":"2021-02-28",
"unixTimeStamp":"1614470400",
"gasLimit":"281474976710655"
}
]
}

Get Fantom Daily Total Gas Used

Returns the total amount of gas used daily for transactions on the Fantom network.
https://api.ftmscan.com/api
?module=stats
&action=dailygasused
&startdate=2021-02-01
&enddate=2021-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
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":"4142126569"
},
{
"UTCDate":"2021-02-02",
"unixTimeStamp":"1612224000",
"gasUsed":"3616502837"
},
{
"UTCDate":"2021-02-28",
"unixTimeStamp":"1614470400",
"gasUsed":"4294833437"
}
]
}

Get Daily Average Gas Price

Returns the daily average gas price used on the Fantom network.
https://api.ftmscan.com/api
?module=stats
&action=dailyavggasprice
&startdate=2021-02-01
&enddate=2021-02-28
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
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":"185000000000",
"minGasPrice_Wei":"1000000000",
"avgGasPrice_Wei":"22424109503"
},
{
"UTCDate":"2021-02-02",
"unixTimeStamp":"1612224000",
"maxGasPrice_Wei":"208000000000",
"minGasPrice_Wei":"1000000000",
"avgGasPrice_Wei":"21376281941"
},
{
"UTCDate":"2021-02-28",
"unixTimeStamp":"1614470400",
"maxGasPrice_Wei":"170000000000",
"minGasPrice_Wei":"1000000000",
"avgGasPrice_Wei":"21796443062"
}
]
}

Get FTM Historical Price

Returns the historical price of 1 FTM.
https://api.ftmscan.com/api
?module=stats
&action=ftmdailyprice
&startdate=2021-08-01
&enddate=2021-08-31
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
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",
"value":"0.25"
},
{
"UTCDate":"2021-08-02",
"unixTimeStamp":"1627862400",
"value":"0.25"
},
{
"UTCDate":"2021-08-31",
"unixTimeStamp":"1630368000",
"value":"0.72"
}
]
}
💰
Tip : The value is represented in US Dollars ( USD ).

Get Daily Network Transaction Fee

Returns the historical amount of transaction fees paid to validators per day.
https://api.ftmscan.com/api?
module=stats
&action=dailytxnfee
&startdate=2020-10-01
&enddate=2020-10-31
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
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":"2020-10-01",
"unixTimeStamp":"1601510400",
"transactionFee_Eth":"2.11880145675"
},
{
"UTCDate":"2020-10-02",
"unixTimeStamp":"1601596800",
"transactionFee_Eth":"2.151878422"
},
{
"UTCDate":"2020-10-31",
"unixTimeStamp":"1604102400",
"transactionFee_Eth":"1.372074716"
}
]
}

Get Daily New Address Count

Returns the historical number of new Fantom addresses created per day.
https://api.ftmscan.com/api
?module=stats
&action=dailynewaddress
&startdate=2020-10-01
&enddate=2020-10-31
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
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":"2020-10-01",
"unixTimeStamp":"1601510400",
"newAddressCount":60
},
{
"UTCDate":"2020-10-02",
"unixTimeStamp":"1601596800",
"newAddressCount":43
},
{
"UTCDate":"2020-10-31",
"unixTimeStamp":"1604102400",
"newAddressCount":13
}
]
}

Get Daily Transaction Count

Returns the number of transactions performed on the Fantom Chain per day.
https://api.ftmscan.com/api
?module=stats
&action=dailytx
&startdate=2021-07-01
&enddate=2021-07-31
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
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":"2021-07-01",
"unixTimeStamp":"1625097600",
"transactionCount":340000
},
{
"UTCDate":"2021-07-02",
"unixTimeStamp":"1625184000",
"transactionCount":260595
},
{
"UTCDate":"2021-07-31",
"unixTimeStamp":"1627689600",
"transactionCount":218768
}
]
}