Accounts
Get FTM Balance for a Single Address
Returns the FTM balance of a given address.
https://api-testnet.ftmscan.com/api
?module=account
&action=balance
&address=0x5A534988535cf27a70e74dFfe299D06486f185B7
&apikey=YourApiKeyToken
Query Parameters
Sample response
{
"status":"1",
"message":"OK",
"result":"70761607576819156175695000"
}
Convert FTM units using our Unit Converter.
Get FTM Balance for Multiple Addresses in a Single Call
Returns the balance of the accounts from a list of addresses.
https://api-testnet.ftmscan.com/api
?module=account
&action=balancemulti
&address=0x9b2bb6290fb910a960ec344cdf2ae60ba89647f6,0xb417bcf81994ebd64b3474531ca5bcd8c5bd9c0c,0xFC336AA34c058A38f4BB7d17f4a79FAc4589F2Fc
&tag=latest
&apikey=YourApiKeyToken
Query Parameters
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"account":"0x9b2bb6290fb910a960ec344cdf2ae60ba89647f6",
"balance":"70761477522216043975695000"
},
{
"account":"0xb417bcf81994ebd64b3474531ca5bcd8c5bd9c0c",
"balance":"80000000000000000000"
},
{
"account":"0xFC336AA34c058A38f4BB7d17f4a79FAc4589F2Fc",
"balance":"0"
}
]
}
Convert FTM units using our Unit Converter.
Get a list of 'Normal' Transactions By Address
Returns the list of transactions performed by an address, with optional pagination.
https://api-testnet.ftmscan.com/api
?module=account
&action=txlist
&address=0x9b2bb6290fb910a960ec344cdf2ae60ba89647f6
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Query Parameters
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"314927",
"timeStamp":"1611695501",
"hash":"0xe663c0c73936ccddb6466ce554b1bdac66bb47c7d5dcb3d96c4fbb03db7ae257",
"nonce":"381",
"blockHash":"0x0000082d00000043009d1fb077c07e2059ce8cd6df4782ed25bf0bb78a0b6ca4",
"transactionIndex":"0",
"from":"0xbd5bbfa114d3142b777db479efa08a0e584fb134",
"to":"0x9b2bb6290fb910a960ec344cdf2ae60ba89647f6",
"value":"1000000000000000000000",
"gas":"21000",
"gasPrice":"69000000000",
"isError":"0",
"txreceipt_status":"1",
"input":"0x",
"contractAddress":"",
"cumulativeGasUsed":"21000",
"gasUsed":"21000",
"confirmations":"6647661"
},
{
"blockNumber":"315601",
"timeStamp":"1611715120",
"hash":"0x445af30fb053f89e750932f0fd585e08aff1406940038bab0efb08eee0ef0a45",
"nonce":"75",
"blockHash":"0x0000082e00000380e39d5c360b35707b6be8de4d7f2a39f94dbabb91a4cc018d",
"transactionIndex":"0",
"from":"0xe003e080e8d61207a0a9890c3663b4cd7fb766b8",
"to":"0x9b2bb6290fb910a960ec344cdf2ae60ba89647f6",
"value":"4000000000000000000000000",
"gas":"21000",
"gasPrice":"1000000000",
"isError":"0",
"txreceipt_status":"1",
"input":"0x",
"contractAddress":"",
"cumulativeGasUsed":"21000",
"gasUsed":"21000",
"confirmations":"6646987"
}
]
}
Get a list of 'Internal' Transactions by Address
Returns the list of internal transactions performed by an address, with optional pagination.
https://api-testnet.ftmscan.com/api
?module=account
&action=txlistinternal
&address=0xf491e7b69e4244ad4002bc14e878a34207e38c29
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Query Parameters
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"4557976",
"timeStamp":"1635358111",
"hash":"0xb57a7ab89acc46fdee0e91982ad0536c8526d1a88736020f9279ee3030a5373d",
"from":"0x9b2bb6290fb910a960ec344cdf2ae60ba89647f6",
"to":"0xf491e7b69e4244ad4002bc14e878a34207e38c29",
"value":"10000000000000000000",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"21000",
"gasUsed":"21000",
"traceId":"",
"isError":"0",
"errCode":""
},
{
"blockNumber":"5461395",
"timeStamp":"1638255280",
"hash":"0x65f7b6162023a8091e6937ddc6d89af63c6eca607ed296f3bb967c59a4ed6c3b",
"from":"0x9b2bb6290fb910a960ec344cdf2ae60ba89647f6",
"to":"0xf491e7b69e4244ad4002bc14e878a34207e38c29",
"value":"10000000000000000000",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"21000",
"gasUsed":"21000",
"traceId":"",
"isError":"0",
"errCode":""
}
]
}
Get 'Internal Transactions' by Transaction Hash
Returns the list of internal transactions performed within a transaction.
https://api-testnet.ftmscan.com/api
?module=account
&action=txlistinternal
&txhash=0x946bcaf668a92d52cdae750e8261f44b2b2742e4265e7fcadfef8e6e0aabe841
&apikey=YourApiKeyToken
Query Parameters
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"6971969",
"timeStamp":"1643305227",
"from":"0x9b2bb6290fb910a960ec344cdf2ae60ba89647f6",
"to":"0xe9272e6fadd3e99b9b88b2261177a0df876a90df",
"value":"10000000000000000000",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"21000",
"gasUsed":"21000",
"isError":"0",
"errCode":""
}
]
}
The isError
field returns 0
for successful transactions and 1
for rejected/cancelled transactions.
Get 'Internal Transactions' by Block Range
Returns the list of internal transactions performed within a block range, with optional pagination.
https://api-testnet.ftmscan.com/api
?module=account
&action=txlistinternal
&startblock=6971869
&endblock=6971969
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Query Parameters
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"6971869",
"timeStamp":"1643304937",
"hash":"0x1643753e527623b4151083c5590a15a0dfa85e754517c1b4eb2ddabdf47ebe46",
"from":"0x9b2bb6290fb910a960ec344cdf2ae60ba89647f6",
"to":"0x7fa0e28d67b185fef26c8c6fb5634fa97d8ea793",
"value":"10000000000000000000",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"21000",
"gasUsed":"21000",
"traceId":"",
"isError":"0",
"errCode":""
},
{
"blockNumber":"6971870",
"timeStamp":"1643304940",
"hash":"0xdbd7ee8b42589c2f05e16e55a55e64b48c40fa1e93fa09967b69eb767c23da50",
"from":"0x9b2bb6290fb910a960ec344cdf2ae60ba89647f6",
"to":"0x7233298f630b0ed9cdb07b0137f1252c2df04bf2",
"value":"10000000000000000000",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"21000",
"gasUsed":"21000",
"traceId":"",
"isError":"0",
"errCode":""
}
]
}
The isError
field returns 0
for successful transactions and 1
for rejected/cancelled transactions.
Get a list of 'ERC-20 Token Transfer Events' by Address
Returns the list of ERC-20 tokens transferred by an address, with optional filtering by token contract.
https://api-testnet.ftmscan.com/api
?module=account
&action=tokentx
&contractaddress=0x15c34d8b356f21112c07ca1811d84101f480a3f1
&address=0xd57be84a2f9deded7df66634c259237e58db3d26
&startblock=0
&endblock=99999999
&page=1
&offset=5
&sort=asc
&apikey=YourApiKeyToken
Usage:
ERC-20 transfers from an address, specify the
address
parameterERC-20 transfers from a contract address, specify the
contract address
parameterERC-20 transfers from an address filtered by a token contract, specify both
address
andcontract address
parameters.
Query Parameters
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"6557623",
"timeStamp":"1642176996",
"hash":"0x6a3a920044851f5c5ec89e3c2043d4fd57b5c9f59a8765af82000f6da9a70e6f",
"nonce":"2746",
"blockHash":"0x000016f700003c06880673646e1997159feaf87783527b0c2c740bc9a1388b3a",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0x15c34d8b356f21112c07ca1811d84101f480a3f1",
"to":"0xd57be84a2f9deded7df66634c259237e58db3d26",
"value":"1000000000000000000",
"tokenName":"Wrapped Fantom",
"tokenSymbol":"WFTM",
"tokenDecimal":"18",
"transactionIndex":"0",
"gas":"65029",
"gasPrice":"200058200000",
"gasUsed":"65029",
"cumulativeGasUsed":"65029",
"input":"deprecated",
"confirmations":"414405"
},
{
"blockNumber":"6558114",
"timeStamp":"1642178514",
"hash":"0x2dc605db4cfaa551b31b7ea8e2be01f717ea8336989c48704effea471ce766ee",
"nonce":"2750",
"blockHash":"0x000016f700004de74739cb8452dd2a705abf7649855b40160815d86665e5148d",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0x15c34d8b356f21112c07ca1811d84101f480a3f1",
"to":"0xd57be84a2f9deded7df66634c259237e58db3d26",
"value":"100000000000000000",
"tokenName":"Wrapped Fantom",
"tokenSymbol":"WFTM",
"tokenDecimal":"18",
"transactionIndex":"0",
"gas":"300000",
"gasPrice":"200014400000",
"gasUsed":"73136",
"cumulativeGasUsed":"73136",
"input":"deprecated",
"confirmations":"413914"
}
]
}
Get a list of 'ERC-721 Token Transfer Events' by Address
Returns the list of ERC-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract.
https://api-testnet.ftmscan.com/api
?module=account
&action=tokennfttx
&contractaddress=0x72cf319f1f4b243c51d66f384322ec543e98b26b
&address=0x81d49d431adb6d073f8373bf200c294394a90e5b
&startblock=0
&endblock=99999999
&page=1
&offset=100
&sort=asc
&apikey=YourApiKeyToken
Usage:
ERC-721 transfers from an address, specify the
address
parameterERC-721 transfers from a contract address, specify the
contract address
parameterERC-721 transfers from an address filtered by a token contract, specify both
address
andcontract address
parameters.
Query Parameters
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"5746699",
"timeStamp":"1638880696",
"hash":"0x4d893d8536d75499e2ee7e31cec14d5172a4db3a93db98ec3f651086b040c743",
"nonce":"89",
"blockHash":"0x000015f9000015d96865a6d8d8672e3af8cf346803119530b044860517be3404",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0x72cf319f1f4b243c51d66f384322ec543e98b26b",
"to":"0x81d49d431adb6d073f8373bf200c294394a90e5b",
"tokenID":"25",
"tokenName":"Avatar",
"tokenSymbol":"AVTR",
"tokenDecimal":"0",
"transactionIndex":"0",
"gas":"291692",
"gasPrice":"1500085500",
"gasUsed":"291692",
"cumulativeGasUsed":"291692",
"input":"deprecated",
"confirmations":"1225355"
},
{
"blockNumber":"5746702",
"timeStamp":"1638880703",
"hash":"0xd1b11a7d170e021ced42257677362ef26e93702cfff5d49dc134bb9f0c00dd3f",
"nonce":"90",
"blockHash":"0x000015f9000015f24ab599ab897dba13853954772904cd29dc2620b3f3664ce5",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0x72cf319f1f4b243c51d66f384322ec543e98b26b",
"to":"0x81d49d431adb6d073f8373bf200c294394a90e5b",
"tokenID":"26",
"tokenName":"Avatar",
"tokenSymbol":"AVTR",
"tokenDecimal":"0",
"transactionIndex":"0",
"gas":"294492",
"gasPrice":"1500085500",
"gasUsed":"294492",
"cumulativeGasUsed":"294492",
"input":"deprecated",
"confirmations":"1225352"
}
]
}
Get list of Blocks Validated by Address
Returns the list of blocks validated by an address.
https://api-testnet.ftmscan.com/api
?module=account
&action=getminedblocks
&address=0x0000000000000000000000000000000000000000
&blocktype=blocks
&page=1
&offset=10
&apikey=YourApiKeyToken
Query Parameters
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"6972063",
"timeStamp":"1643305494",
"blockReward":"362757900000000000"
},
{
"blockNumber":"6972062",
"timeStamp":"1643305493",
"blockReward":"4200239400000000"
},
{
"blockNumber":"6972061",
"timeStamp":"1643305492",
"blockReward":"4200239400000000"
},
{
"blockNumber":"6972060",
"timeStamp":"1643305490",
"blockReward":"4200239400000000"
},
{
"blockNumber":"6972059",
"timeStamp":"1643305485",
"blockReward":"4200239400000000"
}
]
}
Last updated