Accounts

Get FTM Balance for a Single Address

Returns the FTM balance of a given address.

https://api.ftmscan.com/api
   ?module=account
   &action=balance
   &address=0x5A534988535cf27a70e74dFfe299D06486f185B7
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

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

Response

Sample response

{
   "status":"1",
   "message":"OK",
   "result":"15000250000000000000"
}

📖 Tip: The result is returned in wei.

Convert FTM units using our Unit Converter.

Get ETH Balance

get

Returns the balance of a single Ethereum-compatible address for a given chain and block tag.

Query parameters

chainidstringRequired

Chain ID to query (e.g., 1 for Ethereum Mainnet, 250 for Fantom).

Default: 250Example: 250

modulestring · enumRequired

Specifies the module to use.

Default: accountExample: accountPossible values:

actionstring · enumRequired

Specifies the action to perform.

Default: balanceExample: balancePossible values:

addressstringRequired

The Ethereum-compatible address whose balance is to be checked.

Example: 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae

tagstringOptional

The block tag to check the balance at (e.g., latest, or a specific block number in hex).

Default: latestExample: latest

apikeystringRequired

Your Etherscan API key.

Example: YourApiKeyToken

Responses

200

Successful response with balance information

application/json

400

Invalid request parameters

403

Invalid or missing API key

500

Server error

get

HTTPcURLJavaScriptPython

GET /v2/api HTTP/1.1
Host: api.etherscan.io
Accept: */*

{
  "status": "1",
  "message": "OK",
  "result": "125000000000000000000000"
}

Get FTM Balance for Multiple Addresses in a Single Call

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

Try this endpoint in your browser 🔗

Request

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

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "account":"0x1B5248B881762576d630246feeA92E5c6FceD2e1",
         "balance":"65901239848809677896"
      },
      {
         "account":"0x48Eb0e2b01c9B35521c6ff877D525D5dcB582671",
         "balance":"5185124093830200000"
      },
      {
         "account":"0xFC336AA34c058A38f4BB7d17f4a79FAc4589F2Fc",
         "balance":"8718673330168300000"
      }
   ]
}

📖 Tip: The result is returned in wei.

Convert FTM units using our Unit Converter.

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 a list of 'Normal' Transactions By Address

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

Try this endpoint in your browser 🔗

Request

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.

Response

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

Get a list of 'Internal' Transactions by Address

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

Try this endpoint in your browser 🔗

Request

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

Response

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

Get 'Internal Transactions' by Transaction Hash

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

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
txhash	the string representing the transaction hash to check for internal transactions

Response

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.

Get 'Internal Transactions' by Block Range

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

Try this endpoint in your browser 🔗

Request

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

Response

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.

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.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 address parameter

• ERC-20 transfers from a contract address, specify the contract address parameter

• ERC-20 transfers from an address filtered by a token contract, specify both address and contract address parameters.

Try this endpoint in your browser 🔗

Request

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

Response

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

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.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 address parameter

• ERC-721 transfers from a contract address, specify the contract address parameter

• ERC-721 transfers from an address filtered by a token contract, specify both address and contract address parameters.

Try this endpoint in your browser 🔗

Request

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

Response

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

Get list of Blocks Validated by Address

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

Try this endpoint in your browser 🔗

Request

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

Response

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

⏳ Note : The timeStamp is represented in Unix timestamp.

Query account data (balance or token transfers)

get

Handles account queries for balance and token transfers using module/action parameters.

Query parameters

chainidintegerRequired

Chain ID (e.g. 1 for Ethereum Mainnet)

Example: 1

modulestring · enumRequired

Module to query (currently supports only account)

Possible values:

actionstring · enumRequired

Action to perform (e.g. balance or tokentx)

Possible values:

addressstringRequired

Ethereum address to query

Example: 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae

tagstring · enumOptional

Only used with action=balance. Specifies block tag like latest.

Possible values:

contractaddressstringOptional

Only used with action=tokentx. Specifies the ERC-20 contract address.

Example: 0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2

pageintegerOptional

Page number for token transfer pagination

Example: 1

offsetintegerOptional

Number of records per page

Example: 100

startblockintegerOptional

Start block number

Example: 0

endblockintegerOptional

End block number

Example: 27025780

sortstring · enumOptional

Sort order of token transactions

Example: ascPossible values:

apikeystringRequired

Your Etherscan API key

Example: YourApiKeyToken

Responses

200

Successful response with balance or token transfer data

application/json

Responseone of

or

400

Invalid request parameters

401

Missing or invalid API key

500

Server error

get

HTTPcURLJavaScriptPython

GET /v2/api HTTP/1.1
Host: api.etherscan.io
Accept: */*

{
  "result": "40807266900000000000000000"
}