Accounts

Get Ether Balance for a Single Address

Returns the Ether balance of a given address.

https://api-goerli-optimism.etherscan.io/api
   ?module=account
   &action=balance
   &address=0x1fcc0de164a21362a7f169dfe356186a3c538abb
   &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-goerli-optimism.etherscan.io/api
   ?module=account
   &action=balancemulti
   &address=0xbb7a8f0da161b577e60611c687b5e9c8eb4cfd3a,0x87aa776a7686dfc124c1e7db4fd4fccfa368c18c,0x1fcc0de164a21362a7f169dfe356186a3c538abb
   &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-goerli-optimism.etherscan.io/api
   ?module=account
   &action=txlist
   &address=0x87aa776a7686dfc124c1e7db4fd4fccfa368c18c
   &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-goerli-optimism.etherscan.io/api
   ?module=account
   &action=txlistinternal
   &address=0x8fabb5c876ca8413be90e4003de33dcf9c4e3424
   &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.

Note : This API endpoint returns a maximum of 10000 records only.

https://api-goerli-optimism.etherscan.io/api
   ?module=account
   &action=txlistinternal
   &txhash=0xfcb103ed569191f8f41fdce678aaa432e443b6c8a65ac98ba8f14584defcf15d
   &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-goerli-optimism.etherscan.io/api
   ?module=account
   &action=txlistinternal
   &startblock=1203424
   &endblock=1204424
   &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-goerli-optimism.etherscan.io/api
   ?module=account
   &action=tokentx
   &contractaddress=0xa0564af79ffffe539482a309c07310cfbc3d6da2
   &address=0x189367a0b4458445da6a69ee5b7f32673a968b3f
   &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-goerli-optimism.etherscan.io/api
   ?module=account
   &action=tokennfttx
   &contractaddress=0x70e24b976d21feea835fa445d9c837e5356faf83
   &address=0x474bafa6db6c7c452422ff30c60538fece385332
   &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

Last updated