Accounts
Returns the FTM balance of a given address.
https://api.ftmscan.com/api
?module=account
&action=balance
&address=0x5A534988535cf27a70e74dFfe299D06486f185B7
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the address to check for balance |
tag | the string pre-defined block parameter, either earliest, pending or latest |
Sample response
{
"status":"1",
"message":"OK",
"result":"15000250000000000000"
}
Returns the balance of the accounts from a list of addresses.
https://api.ftmscan.com/api
?module=account
&action=balancemulti
&address=0x1B5248B881762576d630246feeA92E5c6FceD2e1,0x48Eb0e2b01c9B35521c6ff877D525D5dcB582671,0xFC336AA34c058A38f4BB7d17f4a79FAc4589F2Fc
&tag=latest
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the strings representing the addresses to check for balance, separated by , commas |
tag | the string pre-defined block parameter, either earliest, pending or latest |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"account":"0x1B5248B881762576d630246feeA92E5c6FceD2e1",
"balance":"65901239848809677896"
},
{
"account":"0x48Eb0e2b01c9B35521c6ff877D525D5dcB582671",
"balance":"5185124093830200000"
},
{
"account":"0xFC336AA34c058A38f4BB7d17f4a79FAc4589F2Fc",
"balance":"8718673330168300000"
}
]
}
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
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"
}
Returns the list of transactions performed by an address, with optional pagination.
Note : This API endpoint returns a maximum of 10000 records only.
📝
https://api.ftmscan.com/api
?module=account
&action=txlist
&address=0xb91dd8225Db88dE4E3CD7B7eC538677A2c1Be8Cb
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the addresses to check for balance |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Tip: Specify a smaller
💡
startblock and endblock range for faster search results.Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"28316553",
"timeStamp":"1642486923",
"hash":"0x4e2c901428bcf4bd93102b9f6daee2a35a52735e0c0d404fa60589c436fe8550",
"nonce":"47",
"blockHash":"0x000119e900000105dff576783bd15765b7abaf3b8350fea617e035b4caf33162",
"transactionIndex":"7",
"from":"0x3dea6c125df6701947ba4ad1e1dd2e57674e7633",
"to":"",
"value":"0",
"gas":"1497514",
"gasPrice":"446144000000",
"isError":"0",
"txreceipt_status":"1",
"input":"0x6080604052600060045567033662be39409000600755620151806008553480156200002957600080fd5b506040516200192b3803806200192b8339810160408190526200004c91620000d4565b804210620000775760405162461bcd60e51b81526004016200006e906200010e565b60405180910390fd5b6001600160a01b03821615620000a357600180546001600160a01b0319166001600160a01b0384161790555b6005819055600854620000b790826200012c565b6006555050600080546001600160a01b0319163317905562000151565b60008060408385031215620000e7578182fd5b82516001600160a01b0381168114620000fe578283fd5b6020939093015192949293505050565b6020808252600490820152636c61746560e01b604082015260600190565b600082198211156200014c57634e487b7160e01b81526011600452602481fd5b500190565b6117ca80620001616000396000f3fe608060405234801561001057600080fd5b50600436106101375760003560e01c8063570ca735116100b8578063943f013d1161007c578063943f013d1461025b57806394dfcb3a1461026357806396805e541461026b578063b3ab15fb1461027e578063b3ff985a14610291578063e2bbb1581461029957610137565b8063570ca7351461020d5780635f96dc1114610222578063630b5ba11461022a5780636e271dd51461023257806393f1a40b1461023a57610137565b8063346d562b116100ff578063346d562b146101ae578063441a3e70146101c157806351eb05a6146101d45780635312ea8e146101e757806354575af4146101fa57610137565b806309cf60911461013c5780631526fe271461015a57806317caf6f11461017e5780631ab06ee514610186578063231f0c6a1461019b575b600080fd5b6101446102ac565b604051610151919061168f565b60405180910390f35b61016d610168366004611330565b6102ba565b604051610151959493929190611464565b610144610308565b6101996101943660046113d6565b61030e565b005b6101446101a93660046113d6565b6103ba565b6101446101bc366004611360565b61047f565b6101996101cf3660046113d6565b610608565b6101996101e2366004611330565b6107aa565b6101996101f5366004611330565b610926565b6101996102083660046112ef565b6109e1565b610215610aee565b6040516101519190611413565b610144610afd565b610199610b03565b610144610b2e565b61024d610248366004611360565b610b34565b604051610151929190611698565b610144610b58565b610215610b5e565b61019961027936600461138f565b610b6d565b61019961028c3660046112b7565b610d4b565b610144610d97565b6101996102a73660046113d6565b610d9d565b69043c33c193756480000081565b600281815481106102ca57600080fd5b6000918252602090912060059091020180546001820154600283015460038401546004909401546001600160a01b0390931694509092909160ff1685565b60045481565b6000546001600160a01b031633146103415760405162461bcd60e51b8152600401610338906114c7565b60405180910390fd5b610349610b03565b60006002838154811061036c57634e487b7160e01b600052603260045260246000fd5b60009182526020909120600590910201600481015490915060ff16156103b3576103af826103a98360010154600454610f2890919063ffffffff16565b90610f3b565b6004555b6001015550565b60008183106103cb57506000610479565b60065482106104335760065483106103e557506000610479565b60055483116104185761041160075461040b600554600654610f2890919063ffffffff16565b90610f47565b9050610479565b61041160075461040b85600654610f2890919063ffffffff16565b600554821161044457506000610479565b60055483116104685761041160075461040b60055485610f2890919063ffffffff16565b6007546104119061040b8486610f28565b92915050565b600080600284815481106104a357634e487b7160e01b600052603260045260246000fd5b60009182526020808320878452600380835260408086206001600160a01b03808b1688529452808620600590950290920190810154815492516370a0823160e01b815291965093949291909116906370a0823190610505903090600401611413565b60206040518083038186803b15801561051d57600080fd5b505afa158015610531573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105559190611348565b905083600201544211801561056957508015155b156105cc57600061057e8560020154426103ba565b905060006105a560045461059f886001015485610f4790919063ffffffff16565b90610f53565b90506105c76105c08461059f84670de0b6b3a7640000610f47565b8590610f3b565b935050505b6105fd83600101546105f7670de0b6b3a764000061059f868860000154610f4790919063ffffffff16565b90610f28565b979650505050505050565b600033905060006002848154811061063057634e487b7160e01b600052603260045260246000fd5b600091825260208083208784526003825260408085206001600160a01b038816865290925292208054600590920290920192508411156106825760405162461bcd60e51b8152600401610338906115b6565b61068b856107aa565b60006106bc82600101546105f7670de0b6b3a764000061059f87600301548760000154610f4790919063ffffffff16565b90508015610710576106ce8482610f5f565b836001600160a01b03167fe2403640ba68fed3a2f88b7557551d1993f84b99bb10ff833f0cf8db0c5e048682604051610707919061168f565b60405180910390a25b841561073a5781546107229086610f28565b8255825461073a906001600160a01b0316858761101f565b6003830154825461075891670de0b6b3a76400009161059f91610f47565b826001018190555085846001600160a01b03167ff279e6a1f5e320cca91135676d9cb6e44ca8a08c0b88342bcdb1144f6511b5688760405161079a919061168f565b60405180910390a3505050505050565b6000600282815481106107cd57634e487b7160e01b600052603260045260246000fd5b90600052602060002090600502019050806002015442116107ee5750610923565b80546040516370a0823160e01b81526000916001600160a01b0316906370a082319061081e903090600401611413565b60206040518083038186803b15801561083657600080fd5b505afa15801561084a573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061086e9190611348565b905080610882575042600290910155610923565b600482015460ff166108b3576004808301805460ff1916600190811790915583015490546108af91610f3b565b6004555b6004541561091a5760006108cb8360020154426103ba565b905060006108ec60045461059f866001015485610f4790919063ffffffff16565b90506109126109078461059f84670de0b6b3a7640000610f47565b600386015490610f3b565b600385015550505b50426002909101555b50565b60006002828154811061094957634e487b7160e01b600052603260045260246000fd5b600091825260208083208584526003825260408085203380875293528420805485825560018201959095556005909302018054909450919291610999916001600160a01b0391909116908361101f565b83336001600160a01b03167fbb757047c2b5f3974fe26b7c10f732e7bce710b0952a71082702781e62ae0595836040516109d3919061168f565b60405180910390a350505050565b6000546001600160a01b03163314610a0b5760405162461bcd60e51b8152600401610338906114c7565b600654610a1b906276a7006116a6565b421015610ad5576001546001600160a01b0384811691161415610a505760405162461bcd60e51b81526004016103389061162c565b60025460005b81811015610ad257600060028281548110610a8157634e487b7160e01b600052603260045260246000fd5b6000918252602090912060059091020180549091506001600160a01b0387811691161415610ac15760405162461bcd60e51b81526004016103389061155b565b50610acb81611740565b9050610a56565b50505b610ae96001600160a01b038416828461101f565b505050565b6000546001600160a01b031681565b60055481565b60025460005b81811015610b2a57610b1a816107aa565b610b2381611740565b9050610b09565b5050565b60065481565b60036020908152600092835260408084209091529082529020805460019091015482565b60085481565b6001546001600160a01b031681565b6000546001600160a01b03163314610b975760405162461bcd60e51b8152600401610338906114c7565b610ba083611075565b8115610bae57610bae610b03565b600554421015610bda5780610bc65750600554610bd5565b600554811015610bd557506005545b610bee565b801580610be657504281105b15610bee5750425b600060055482111580610c015750428211155b6040805160a0810182526001600160a01b03878116825260208201898152928201868152600060608401818152861580156080870190815260028054600181018255945295517f405787fa12a823e0f2b7631cc41b3ba8828b3321ca811111fa75cd3aa3bb5ace600590940293840180546001600160a01b031916919096161790945594517f405787fa12a823e0f2b7631cc41b3ba8828b3321ca811111fa75cd3aa3bb5acf82015590517f405787fa12a823e0f2b7631cc41b3ba8828b3321ca811111fa75cd3aa3bb5ad082015592517f405787fa12a823e0f2b7631cc41b3ba8828b3321ca811111fa75cd3aa3bb5ad184015590517f405787fa12a823e0f2b7631cc41b3ba8828b3321ca811111fa75cd3aa3bb5ad2909201805460ff191692151592909217909155909150610d4457600454610d409086610f3b565b6004555b5050505050565b6000546001600160a01b03163314610d755760405162461bcd60e51b8152600401610338906114c7565b600080546001600160a01b0319166001600160a01b0392909216919091179055565b60075481565b6000339050600060028481548110610dc557634e487b7160e01b600052603260045260246000fd5b600091825260208083208784526003825260408085206001600160a01b0388168652909252922060059091029091019150610dff856107aa565b805415610e8d576000610e3782600101546105f7670de0b6b3a764000061059f87600301548760000154610f4790919063ffffffff16565b90508015610e8b57610e498482610f5f565b836001600160a01b03167fe2403640ba68fed3a2f88b7557551d1993f84b99bb10ff833f0cf8db0c5e048682604051610e82919061168f565b60405180910390a25b505b8315610eb9578154610eaa906001600160a01b03168430876110f6565b8054610eb69085610f3b565b81555b60038201548154610ed791670de0b6b3a76400009161059f91610f47565b816001018190555084836001600160a01b03167f90890809c654f11d6e72a28fa60149770a0d11ec6c92319d6ceb2bb0a4ea1a1586604051610f19919061168f565b60405180910390a35050505050565b6000610f3482846116fd565b9392505050565b6000610f3482846116a6565b6000610f3482846116de565b6000610f3482846116be565b6001546040516370a0823160e01b81526000916001600160a01b0316906370a0823190610f90903090600401611413565b60206040518083038186803b158015610fa857600080fd5b505afa158015610fbc573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fe09190611348565b90508015610ae9578082111561100c57600154611007906001600160a01b0316848361101f565b610ae9565b600154610ae9906001600160a01b031684845b610ae98363a9059cbb60e01b848460405160240161103e92919061144b565b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915261111d565b60025460005b81811015610ae957826001600160a01b0316600282815481106110ae57634e487b7160e01b600052603260045260246000fd5b60009182526020909120600590910201546001600160a01b031614156110e65760405162461bcd60e51b81526004016103389061164d565b6110ef81611740565b905061107b565b611117846323b872dd60e01b85858560405160240161103e93929190611427565b50505050565b6000611172826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b03166111ac9092919063ffffffff16565b805190915015610ae9578080602001905181019061119091906112d3565b610ae95760405162461bcd60e51b8152600401610338906115e2565b60606111bb84846000856111c3565b949350505050565b6060824710156111e55760405162461bcd60e51b815260040161033890611515565b6111ee85611278565b61120a5760405162461bcd60e51b81526004016103389061157f565b600080866001600160a01b0316858760405161122691906113f7565b60006040518083038185875af1925050503d8060008114611263576040519150601f19603f3d011682016040523d82523d6000602084013e611268565b606091505b50915091506105fd82828661127e565b3b151590565b6060831561128d575081610f34565b82511561129d5782518084602001fd5b8160405162461bcd60e51b81526004016103389190611494565b6000602082840312156112c8578081fd5b8135610f3481611771565b6000602082840312156112e4578081fd5b8151610f3481611786565b600080600060608486031215611303578182fd5b833561130e81611771565b925060208401359150604084013561132581611771565b809150509250925092565b600060208284031215611341578081fd5b5035919050565b600060208284031215611359578081fd5b5051919050565b60008060408385031215611372578182fd5b82359150602083013561138481611771565b809150509250929050565b600080600080608085870312156113a4578081fd5b8435935060208501356113b681611771565b925060408501356113c681611786565b9396929550929360600135925050565b600080604083850312156113e8578182fd5b50508035926020909101359150565b60008251611409818460208701611714565b9190910192915050565b6001600160a01b0391909116815260200190565b6001600160a01b039384168152919092166020820152604081019190915260600190565b6001600160a01b03929092168252602082015260400190565b6001600160a01b039590951685526020850193909352604084019190915260608301521515608082015260a00190565b60006020825282518060208401526114b3816040850160208701611714565b601f01601f19169190910160400192915050565b6020808252602e908201527f5370656374657247656e65736973506f6f6c3a2063616c6c6572206973206e6f60408201526d3a103a34329037b832b930ba37b960911b606082015260800190565b60208082526026908201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6040820152651c8818d85b1b60d21b606082015260800190565b6020808252600a90820152693837b7b6173a37b5b2b760b11b604082015260600190565b6020808252601d908201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e7472616374000000604082015260600190565b6020808252601290820152711dda5d1a191c985dce881b9bdd0819dbdbd960721b604082015260600190565b6020808252602a908201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6040820152691bdd081cdd58d8d9595960b21b606082015260800190565b60208082526007908201526639b832b1ba32b960c91b604082015260600190565b60208082526022908201527f5370656374657247656e65736973506f6f6c3a206578697374696e6720706f6f6040820152616c3f60f01b606082015260800190565b90815260200190565b918252602082015260400190565b600082198211156116b9576116b961175b565b500190565b6000826116d957634e487b7160e01b81526012600452602481fd5b500490565b60008160001904831182151516156116f8576116f861175b565b500290565b60008282101561170f5761170f61175b565b500390565b60005b8381101561172f578181015183820152602001611717565b838111156111175750506000910152565b60006000198214156117545761175461175b565b5060010190565b634e487b7160e01b600052601160045260246000fd5b6001600160a01b038116811461092357600080fd5b801515811461092357600080fdfea2646970667358221220dd33aa4d6e683651d0dcfeeab9ad70bd05ccd8e76d884dbf4be3fe3bc06b884164736f6c634300080000330000000000000000000000002b7c5841997275d2d548ce9b19d54b655725ebfc0000000000000000000000000000000000000000000000000000000061e851a0",
"contractAddress":"0x7515d76a338bbc3592f3e079041e8bf947841886",
"cumulativeGasUsed":"1980829",
"gasUsed":"1497514",
"confirmations":"146274"
},
{
"blockNumber":"28320355",
"timeStamp":"1642490071",
"hash":"0x0eeee1fd7fb3160c92292c0066ca649212c99490f8746693056b7077db13f2b3",
"nonce":"58",
"blockHash":"0x000119f6000000fad06560f9016811955e247c07adffe88bf063455f0abbd12b",
"transactionIndex":"1",
"from":"0x3dea6c125df6701947ba4ad1e1dd2e57674e7633",
"to":"0x7515d76a338bbc3592f3e079041e8bf947841886",
"value":"0",
"gas":"151999",
"gasPrice":"360124900000",
"isError":"0",
"txreceipt_status":"1",
"input":"0x96805e540000000000000000000000000000000000000000000000000000000000004e2000000000000000000000000021be370d5312f44cb42ce377bc9b8a0cef1a4c8300000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000061e851a0",
"contractAddress":"",
"cumulativeGasUsed":"189349",
"gasUsed":"151999",
"confirmations":"142472"
}
]
}
Returns the list of internal transactions performed by an address, with optional pagination.
Note : This API endpoint returns a maximum of 10000 records only.
📝
https://api.ftmscan.com/api
?module=account
&action=txlistinternal
&address=0xf491e7b69e4244ad4002bc14e878a34207e38c29
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the addresses to check for balance |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Tip: Specify a smaller
💡
startblock and endblock range for faster search resultsSample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"4242185",
"timeStamp":"1619320726",
"hash":"0x8f6be9c28c752f08946b0226324e1ae99818134d66f18b70328a739435d17395",
"from":"0x95478c4f7d22d1048f46100001c2c69d2ba57380",
"to":"",
"value":"0",
"contractAddress":"0xf491e7b69e4244ad4002bc14e878a34207e38c29",
"input":"",
"type":"create",
"gas":"4335475",
"gasUsed":"4335475",
"traceId":"",
"isError":"0",
"errCode":""
},
{
"blockNumber":"4242292",
"timeStamp":"1619320840",
"hash":"0xfa5e28d59ab15306df9048c7dff27399e34a067817a6923ccd247111b444fb00",
"from":"0x21be370d5312f44cb42ce377bc9b8a0cef1a4c83",
"to":"0xf491e7b69e4244ad4002bc14e878a34207e38c29",
"value":"995006062070339838",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"251100",
"gasUsed":"2217",
"traceId":"3_0",
"isError":"0",
"errCode":""
}
]
}
Returns the list of internal transactions performed within a transaction.
Note : This API endpoint returns a maximum of 10000 records only.
📝
https://api.ftmscan.com/api
?module=account
&action=txlistinternal
&txhash=0x91095d8dc009a6d607f901c614cd56b6175bf71be64463c5bc5d3e4e58383b76
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
txhash | the string representing the transaction hash to check for internal transactions |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"28463106",
"timeStamp":"1642614328",
"from":"0xb5ecf5ea43f9978b2f4953789f6e2278cb19c128",
"to":"0xf491e7b69e4244ad4002bc14e878a34207e38c29",
"value":"600549164326899180218",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"123176",
"gasUsed":"123176",
"isError":"0",
"errCode":""
},
{
"blockNumber":"28463106",
"timeStamp":"1642614328",
"from":"0xf491e7b69e4244ad4002bc14e878a34207e38c29",
"to":"0x21be370d5312f44cb42ce377bc9b8a0cef1a4c83",
"value":"600549164326899180218",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"136648",
"gasUsed":"136648",
"isError":"0",
"errCode":""
}
]
}
The
isError field returns 0 for successful transactions and 1 for rejected/cancelled transactions.Returns the list of internal transactions performed within a block range, with optional pagination.
Note : This API endpoint returns a maximum of 10000 records only.
📝
https://api.ftmscan.com/api
?module=account
&action=txlistinternal
&startblock=19568000
&endblock=19569000
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"19568000",
"timeStamp":"1634713158",
"hash":"0x0e3027dc82459e95910fbfbc9ddb0a5e981da10a9ea7b4f2b6eb2fdf206dc4c0",
"from":"0x21be370d5312f44cb42ce377bc9b8a0cef1a4c83",
"to":"0xf491e7b69e4244ad4002bc14e878a34207e38c29",
"value":"526239970004322382437",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"1924526",
"gasUsed":"2217",
"traceId":"3_0",
"isError":"0",
"errCode":""
},
{
"blockNumber":"19568000",
"timeStamp":"1634713158",
"hash":"0x0e3027dc82459e95910fbfbc9ddb0a5e981da10a9ea7b4f2b6eb2fdf206dc4c0",
"from":"0xf491e7b69e4244ad4002bc14e878a34207e38c29",
"to":"0x9d945d909ca91937d19563e30bb4dac12c860189",
"value":"526239970004322382437",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"322143",
"gasUsed":"0",
"traceId":"4",
"isError":"0",
"errCode":""
}
]
}
The
isError field returns 0 for successful transactions and 1 for rejected/cancelled transactions.Returns the list of ERC-20 tokens transferred by an address, with optional filtering by token contract.
https://api.ftmscan.com/api
?module=account
&action=tokentx
&contractaddress=0x69c744d3444202d35a2783929a0f930f2fbb05ad
&address=0x489d55df278224a05f793098d41753d5669d5144
&startblock=0
&endblock=99999999
&page=1
&offset=5
&sort=asc
&apikey=YourApiKeyToken
Usage:
- ERC-20 transfers from an address, specify the
addressparameter - ERC-20 transfers from a contract address, specify the
contract addressparameter - ERC-20 transfers from an address filtered by a token contract, specify both
addressandcontract addressparameters.
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the address to check for balance |
contractaddress | the string representing the token contract address to check for balance |
startblock | the integer block number to start searching for transactionsthe integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"10239120",
"timeStamp":"1624259946",
"hash":"0x0d60c10381cbf4ffce4c8c97f36d921fbd51a677ad56040bf5eb3c6717dfa3aa",
"nonce":"4",
"blockHash":"0x0000446f00000798306cec6ef5b79783107e39fef8a80e6f60bebb0c2328476b",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0x69c744d3444202d35a2783929a0f930f2fbb05ad",
"to":"0x489d55df278224a05f793098d41753d5669d5144",
"value":"484000000000000000000",
"tokenName":"Staked FTM",
"tokenSymbol":"SFTM",
"tokenDecimal":"18",
"transactionIndex":"2",
"gas":"92037",
"gasPrice":"51000000000",
"gasUsed":"88536",
"cumulativeGasUsed":"732045",
"input":"deprecated",
"confirmations":"18225216"
},
{
"blockNumber":"10239166",
"timeStamp":"1624259987",
"hash":"0x5cff6123b6515c16bd151719ddb8e466022ef94e79972759b5231a862d44afd0",
"nonce":"6",
"blockHash":"0x0000446f00000a6f06ce775b47f350458eaf6b8ee4d755f9fe1d2ce8b621e881",
"from":"0x489d55df278224a05f793098d41753d5669d5144",
"contractAddress":"0x69c744d3444202d35a2783929a0f930f2fbb05ad",
"to":"0xbb634cafef389cdd03bb276c82738726079fcf2e",
"value":"484000000000000000000",
"tokenName":"Staked FTM",
"tokenSymbol":"SFTM",
"tokenDecimal":"18",
"transactionIndex":"0",
"gas":"1983810",
"gasPrice":"51000000000",
"gasUsed":"1924516",
"cumulativeGasUsed":"1924516",
"input":"deprecated",
"confirmations":"18225170"
}
]
}
Returns the list of ERC-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract.
https://api.ftmscan.com/api
?module=account
&action=tokennfttx
&contractaddress=0x428b68C856ACD8e7eae3C5CeB5d650AEaa7F48bc
&address=0xc28bb91d5a8d4d4715cd8666d4e1aa0089b7bee5
&startblock=0
&endblock=99999999
&page=1
&offset=100
&sort=asc
&apikey=YourApiKeyToken
Usage:
- ERC-721 transfers from an address, specify the
addressparameter - ERC-721 transfers from a contract address, specify the
contract addressparameter - ERC-721 transfers from an address filtered by a token contract, specify both
addressandcontract addressparameters.
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the address to check for balance |
contractaddress | the string representing the token contract address to check for balance |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"28064057",
"timeStamp":"1642273733",
"hash":"0xcf42b5844dae13b8e2c0b2f9c9235dfff5b1f8715e314e7a9f15eb80eff37c1f",
"nonce":"2",
"blockHash":"0x0001163d00000aff2dabc660e81d78d67e6cde168d00feb8a063621af48953a0",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0x428b68c856acd8e7eae3c5ceb5d650aeaa7f48bc",
"to":"0xc28bb91d5a8d4d4715cd8666d4e1aa0089b7bee5",
"tokenID":"4152",
"tokenName":"Basic Apes Token",
"tokenSymbol":"SCAMMER",
"tokenDecimal":"0",
"transactionIndex":"0",
"gas":"361630",
"gasPrice":"279573100000",
"gasUsed":"306420",
"cumulativeGasUsed":"306420",
"input":"deprecated",
"confirmations":"400460"
},
{
"blockNumber":"28083255",
"timeStamp":"1642290741",
"hash":"0x5318f98f7fdebd7cd0d9369737572afc7767cc061e47796722109eaf831f6016",
"nonce":"5",
"blockHash":"0x0001168b0000058f816549f7ee02310ef83d46a8a9bcd33d44017c663e77ce8e",
"from":"0xc28bb91d5a8d4d4715cd8666d4e1aa0089b7bee5",
"contractAddress":"0x428b68c856acd8e7eae3c5ceb5d650aeaa7f48bc",
"to":"0x3b594e8001e28e676f047c4a4423f6f2cc750f41",
"tokenID":"4152",
"tokenName":"Basic Apes Token",
"tokenSymbol":"SCAMMER",
"tokenDecimal":"0",
"transactionIndex":"6",
"gas":"249005",
"gasPrice":"352789000000",
"gasUsed":"194265",
"cumulativeGasUsed":"1211136",
"input":"deprecated",
"confirmations":"381262"
}
]
}
Returns the list of blocks validated by an address.
https://api.ftmscan.com/api
?module=account
&action=getminedblocks
&address=0x0000000000000000000000000000000000000000
&blocktype=blocks
&page=1
&offset=10
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the address to check for balance |
blocktype | the string pre-defined block type, blocksfor canonical blocks |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"28464634",
"timeStamp":"1642615534",
"blockReward":"271316865284500000"
},
{
"blockNumber":"28464633",
"timeStamp":"1642615533",
"blockReward":"143362832386800000"
},
{
"blockNumber":"28464632",
"timeStamp":"1642615533",
"blockReward":"80059215949400000"
},
{
"blockNumber":"28464631",
"timeStamp":"1642615532",
"blockReward":"301414222354950000"
},
{
"blockNumber":"28464630",
"timeStamp":"1642615532",
"blockReward":"59395647390800000"
}
]
}
Last modified 1yr ago