Links

Blocks

Get Block Rewards by BlockNo

Returns the block reward awarded for validating a certain block.
https://api.ftmscan.com/api
?module=block
&action=getblockreward
&blockno=28830390
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
Query Parameters
Parameter
Description
blockno
the integer block number to check block rewards for eg. 12697906
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"blockNumber":"28830390",
"timeStamp":"1642952101",
"blockMiner":"0x0000000000000000000000000000000000000000",
"blockReward":"1107280315376846237",
"uncles":[
],
"uncleInclusionReward":"0"
}
}
​​
Tip : The timestamp field is denoted in Unix timestamp.

Get Estimated Block Countdown Time by BlockNo

Returns the estimated time remaining, in seconds, until a certain block is validated.
https://api.ftmscan.com/api
?module=block
&action=getblockcountdown
&blockno=48830390
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
Query Parameters
Parameter
Description
blockno
the integer block number to estimate time remaining to be validated eg. 12697906
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"CurrentBlock":"28830869",
"CountdownBlock":"48830390",
"RemainingBlock":"19999521",
"EstimateTimeInSec":"17999583.9"
}
}

Get Block Number by Timestamp

Returns the block number that was validated at a certain timestamp.
https://api.ftmscan.com/api
?module=block
&action=getblocknobytime
&timestamp=1601510400
&closest=before
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
Query Parameters
Parameter
Description
timestamp
the integer representing the Unix timestamp in seconds.
closest
the closest available block to the provided timestamp, either before or after
Tip : Convert a regular date-time to a Unix timestamp.
Sample Response
{
"status":"1",
"message":"OK",
"result":"826295"
}

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