Accounts

Get Ether Balance for a Single Address

Returns the Ether balance of a given address.

https://api-optimistic.etherscan.io/api
   ?module=account
   &action=balance
   &address=0x11799622F4D98A24514011E8527B969f7488eF47
   &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-optimistic.etherscan.io/api
   ?module=account
   &action=balancemulti
   &address=0x7462da033c5cceB21691D2447af34f3E333E0b85,0xb2e2b1f036f31a9a97d3fc377a47581c813123aa,0x6ca4166eefd64b5f607f12fb0c3fbae233897757
   &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-optimistic.etherscan.io/api
   ?module=account
   &action=txlist
   &address=0x2479B47559f85B79894553f776529847E5bB389A
   &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-optimistic.etherscan.io/api
   ?module=account
   &action=txlistinternal
   &address=0xE592427A0AEce92De3Edee1F18E0157C05861564
   &startblock=0
   &endblock=99999999
   &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-optimistic.etherscan.io/api
   ?module=account
   &action=txlistinternal
   &txhash=0x143a026d2a4719c0008f294d0f94ac007e7460435e5d5b14fbd7e6ad1a85a416
   &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-optimistic.etherscan.io/api
   ?module=account
   &action=txlistinternal
   &startblock=23434077
   &endblock=23435077
   &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-optimistic.etherscan.io/api
   ?module=account
   &action=tokentx
   &contractaddress=0x7f5c764cbc14f9669b88837ca1490cca17c31607
   &address=0x5da062f3d4504510bfea6a610ccde9a6c502da29
   &page=1
   &offset=100
   &startblock=0
   &endblock=99999999
   &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-optimistic.etherscan.io/api
   ?module=account
   &action=tokennfttx
   &contractaddress=0x63d29f9c28ce781dacb284a99b1239a25e3e2159
   &address=0xa20e8a921b969e690c1f7ef8dcc1ea88821cd4a1
   &page=1
   &offset=100
   &startblock=0
   &endblock=99999999
   &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-optimistic.etherscan.io/api
   ?module=account
   &action=token1155tx
   &contractaddress=0x0D380362762B0cf375227037f2217f59A4eC4b9E
   &address=0x9d25756c550630a156d8c498ac42bd64925dab2d
   &page=1
   &offset=100
   &startblock=0
   &endblock=latest
   &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

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

https://api-optimistic.etherscan.io/api
   ?module=account
   &action=balancehistory
   &address=0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1
   &blockno=116110804
   &apikey=YourApiKeyToken

Query Parameters

Last updated