Accounts

Get Ether Balance for a Single Address

Returns the Ether balance of a given address.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=account
   &action=balance
   &address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
   &tag=latest
   &apikey=YourApiKeyToken

Query Parameters

Get Ether Balance for Multiple Addresses in a Single Call

Returns the balance of the accounts from a list of addresses.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=account
   &action=balancemulti
   &address=0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a,0x63a9975ba31b0b9626b34300f7f627147df1f526,0x198ef1ec325a96cc354c7266a038be8b5c558f67
   &tag=latest
   &apikey=YourApiKeyToken

Query Parameters

Get a list of 'Normal' Transactions By Address

Returns the list of transactions performed by an address, with optional pagination.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=account
   &action=txlist
   &address=0xc5102fE9359FD9a28f877a67E36B0F050d81a3CC
   &startblock=0
   &endblock=99999999
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken

Query Parameters

Get a list of 'Internal' Transactions by Address

Returns the list of internal transactions performed by an address, with optional pagination.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=account
   &action=txlistinternal
   &address=0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3
   &startblock=0
   &endblock=2702578
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken

Query Parameters

Get 'Internal Transactions' by Transaction Hash

Returns the list of internal transactions performed within a transaction.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=account
   &action=txlistinternal
   &txhash=0x40eb908387324f2b575b4879cd9d7188f69c8fc9d87c901b9e2daaea4b442170
   &apikey=YourApiKeyToken

Query Parameters

Get "Internal Transactions" by Block Range

Returns the list of internal transactions performed within a block range, with optional pagination.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=account
   &action=txlistinternal
   &startblock=13481773
   &endblock=13491773
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken

Query Parameters

Get a list of 'ERC20 - Token Transfer Events' by Address

Returns the list of ERC-20 tokens transferred by an address, with optional filtering by token contract.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=account
   &action=tokentx
   &contractaddress=0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2
   &address=0x4e83362442b8d1bec281594cea3050c8eb01311c
   &page=1
   &offset=100
   &startblock=0
   &endblock=27025780
   &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.

Query Parameters

Get a list of 'ERC721 - 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.etherscan.io/v2/api
   ?chainid=1
   &module=account
   &action=tokennfttx
   &contractaddress=0x06012c8cf97bead5deae237070f9587f8e7a266d
   &address=0x6975be450864c02b4613023c2152ee0743572325
   &page=1
   &offset=100
   &startblock=0
   &endblock=27025780
   &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.

Query Parameters

Get a list of 'ERC1155 - Token Transfer Events' by Address

Returns the list of ERC-1155 ( Multi Token Standard ) tokens transferred by an address, with optional filtering by token contract.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=account
   &action=token1155tx
   &contractaddress=0x76be3b62873462d2142405439777e971754e8e77
   &address=0x83f564d180b58ad9a02a449105568189ee7de8cb
   &page=1
   &offset=100
   &startblock=0
   &endblock=99999999
   &sort=asc
   &apikey=YourApiKeyToken

Usage:

  • ERC-1155 transfers from an address, specify the address parameter

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

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

Query Parameters

Get list of Blocks Validated by Address

Returns the list of blocks validated by an address.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=account
   &action=getminedblocks
   &address=0x9dd134d14d1e65f84b706d6f205cd5b1cd03a46b
   &blocktype=blocks
   &page=1
   &offset=10
   &apikey=YourApiKeyToken

Query Parameters

Get Beacon Chain Withdrawals by Address and Block Range

Returns the beacon chain withdrawals made to an address.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=account
   &action=txsBeaconWithdrawal
   &address=0xB9D7934878B5FB9610B3fE8A5e441e8fad7E293f
   &startblock=0
   &endblock=99999999
   &page=1
   &offset=100
   &sort=asc
   &apikey=YourApiKeyToken
   

Query Parameters

Returns the balance of an address at a certain block height.

https://api.etherscan.io/v2/api
   ?chainid=1
   &module=account
   &action=balancehistory
   &address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
   &blockno=8000000
   &apikey=YourApiKeyToken

Query Parameters

Last updated