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

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

Response

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

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

Response

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

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

Response

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

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

Response

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

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

Response

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

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

Second Tab

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

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":"0xe1146b9ac456fcbb60644c36fd3f868a9072fc6e",
         "tokenName":"fBTC",
         "symbol":"FBTC",
         "divisor":"18",
         "tokenType":"ERC20",
         "totalSupply":"2.508457000000000000",
         "blueCheckmark":"true",
         "description":"",
         "website":"https://fantom.foundation/defi/",
         "email":"[e-mail]",
         "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

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

Response

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

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

Response

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

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

Response

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

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

Response

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

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

Response

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

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

Response

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

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

Response

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