Get Ether Balance for a Single Address
Returns the Ether balance of a given address.
https://api-sepolia.etherscan.io/api
?module=account
&action=balance
&address=0x382b4ca2c4a7cd28c1c400c69d81ec2b2637f7dd
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the address to check for balance |
| the string pre-defined block parameter, either earliest , pending or latest |
Sample Response
{
"status":"1",
"message":"OK",
"result":"206796937658929992503000"
}
Get Ether Balance for Multiple Addresses in a Single Call
Returns the balance of the accounts from a list of addresses.
https://api-sepolia.etherscan.io/api
?module=account
&action=balancemulti
&address=https://api-sepolia.etherscan.io/api?module=account&action=balance&address=0x382b4ca2c4a7cd28c1c400c69d81ec2b2637f7dd,0x382b4ca2c4a7cd28c1c400c69d81ec2b2637f7dd,0x8a5847fd0e592b058c026c5fdc322aee834b87f5&tag=latest&apikey=YourApiKeyToken,0x63a9dbCe75413036B2B778E670aaBd4493aAF9F3,0xd82b6aB1f20A21484fA5E28221B95425dddC5E8E
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the strings representing the addresses to check for balance, separated by , commas
up to 20 addresses per call |
| the integer pre-defined block parameter, either earliest , pending or latest |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"account":"0x382b4ca2c4a7cd28c1c400c69d81ec2b2637f7dd",
"balance":"206796937658929992503000"
},
{
"account":"0x382b4ca2c4a7cd28c1c400c69d81ec2b2637f7dd",
"balance":"206796937658929992503000"
},
{
"account":"0x8a5847fd0e592b058c026c5fdc322aee834b87f5",
"balance":"16288712393992050891"
}
]
}
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-sepolia.etherscan.io/api
?module=account
&action=txlist
&address=0x382b4ca2c4a7cd28c1c400c69d81ec2b2637f7dd
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the addresses to check for balance |
| the integer block number to start searching for transactions |
| the integer block number to stop searching for transactions |
| the integer page number, if pagination is enabled |
| the number of transactions displayed per page |
| 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-Missing/Invalid API Key, rate limit of 1/5sec applied",
"result":[
{
"blockNumber":"1037571",
"timeStamp":"1651759857",
"hash":"0x710e53707c79dd438a8bc3db2a45a123af6dba0d4a653a134035306d11f415fd",
"nonce":"5",
"blockHash":"0x64201f8940cee65186f64adb68a99fe3da0450bc9490617aeedd08f80cb8e29b",
"transactionIndex":"0",
"from":"0x10f5d45854e038071485ac9e402308cf80d2d2fe",
"to":"0x382b4ca2c4a7cd28c1c400c69d81ec2b2637f7dd",
"value":"50000000000000000000000",
"gas":"21000",
"gasPrice":"1500000007",
"isError":"0",
"txreceipt_status":"1",
"input":"0x",
"contractAddress":"",
"cumulativeGasUsed":"21000",
"gasUsed":"21000",
"confirmations":"48476"
},
{
"blockNumber":"1061942",
"timeStamp":"1652077697",
"hash":"0x7734cae034c8a7198a5988c5ae927adf30cf77d2cbb25ed996278e402c0e0032",
"nonce":"0",
"blockHash":"0xedc7119adb34edf5480fe52f090dedbef647948ffc91806afe7d8b0182781b40",
"transactionIndex":"0",
"from":"0x382b4ca2c4a7cd28c1c400c69d81ec2b2637f7dd",
"to":"0x93e973436cd7757f21b1c947599f67082624a721",
"value":"1000000000000000",
"gas":"21000",
"gasPrice":"2000000007",
"isError":"0",
"txreceipt_status":"1",
"input":"0x",
"contractAddress":"",
"cumulativeGasUsed":"21000",
"gasUsed":"21000",
"confirmations":"24105"
}
]
}
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-sepolia.etherscan.io/api
?module=account
&action=txlistinternal
&address=0xa4fadaa5e8577fee5799e2bd9615014013b45c5d
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the addresses to check for balance |
| the integer block number to start searching for transactions |
| the integer block number to stop searching for transactions |
| the integer page number, if pagination is enabled |
| the number of transactions displayed per page |
| 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":"765371",
"timeStamp":"1648218619",
"hash":"0xcb6609b6f9133fc1bfd189fb52ed616968a5f7c56af8da3bd6724f7655fe5f78",
"from":"0x02f11eabf51d28bb0bae795e256ce52161d65c2b",
"to":"0xa4fadaa5e8577fee5799e2bd9615014013b45c5d",
"value":"10000000000000000",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"2300",
"gasUsed":"0",
"traceId":"0_1",
"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-sepolia.etherscan.io/api
?module=account
&action=txlistinternal
&txhash=0xb730ee4dc8d0274be31d1e31ed7fe9749d7a67c0e35b297f3c2d10b06c1f6f1e
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the transaction hash to check for internal transactions |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"312070",
"timeStamp":"1639592011",
"from":"0xa234eead085ac80a4f7cc5220789e048373f0f1e",
"to":"",
"value":"0",
"contractAddress":"0x63a19c2868e469ffc2c8346c93f81ff6e140ffaf",
"input":"",
"type":"create",
"gas":"8504616",
"gasUsed":"134349",
"isError":"0",
"errCode":""
},
{
"blockNumber":"312070",
"timeStamp":"1639592011",
"from":"0xa234eead085ac80a4f7cc5220789e048373f0f1e",
"to":"",
"value":"0",
"contractAddress":"0xe05ba0186f4a5a5d0eb8a5394d8413411ffd321c",
"input":"",
"type":"create",
"gas":"1119086",
"gasUsed":"134349",
"isError":"0",
"errCode":""
},
{
"blockNumber":"312070",
"timeStamp":"1639592011",
"from":"0xa234eead085ac80a4f7cc5220789e048373f0f1e",
"to":"",
"value":"0",
"contractAddress":"0x7b99f4f6260c3cd12984e8d2b83eaf51d44e2254",
"input":"",
"type":"create",
"gas":"134349",
"gasUsed":"134349",
"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-sepolia.etherscan.io/api
?module=account
&action=txlistinternal
&startblock=484887
&endblock=765371
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the integer block number to start searching for transactions |
| the integer block number to stop searching for transactions |
| the integer page number, if pagination is enabled |
| the number of transactions displayed per page |
| the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"484887",
"timeStamp":"1644613109",
"hash":"0xc3ff81084b157b7d695f3df8636eebcacb6ca938c62c3102492978dbe8f5879b",
"from":"0x9bcdb32c4d0f0992bfb926a28ee2cb7b9d9750cc",
"to":"0x105083929bf9bb22c26cb1777ec92661170d4285",
"value":"3906875000000000000000",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"2300",
"gasUsed":"0",
"traceId":"0_1",
"isError":"0",
"errCode":""
},
{
"blockNumber":"498080",
"timeStamp":"1644787132",
"hash":"0x1ab55087625084f2e1462a49f13a36d0996bff67da3cb4e7250e110e922274bd",
"from":"0x9bcdb32c4d0f0992bfb926a28ee2cb7b9d9750cc",
"to":"0x84e9304fa9aafc5e70090eadda9ac2c76d93ad51",
"value":"1491314746532500000000",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"2300",
"gasUsed":"0",
"traceId":"0_1",
"isError":"0",
"errCode":""
},
{
"blockNumber":"518080",
"timeStamp":"1645046610",
"hash":"0x1b08041082471d96bbf5362db688f447ce8c775d242998a3b190211560911d86",
"from":"0x9bcdb32c4d0f0992bfb926a28ee2cb7b9d9750cc",
"to":"0x105083929bf9bb22c26cb1777ec92661170d4285",
"value":"4250625000000000000000",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"2300",
"gasUsed":"0",
"traceId":"0_1",
"isError":"0",
"errCode":""
}
]
}
The isError
field returns 0
for successful transactions and 1
for rejected/cancelled transactions.
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-sepolia.etherscan.io/api
?module=account
&action=tokentx
&contractaddress=0xa808b14492AC6E33419ac16112154D40D0A4AEBA
&address=0x105083929bf9bb22c26cb1777ec92661170d4285
&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.
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the address to check for balance |
| the string representing the token contract address to check for balance |
| the integer page number, if pagination is enabled |
| the number of transactions displayed per page |
| the integer block number to start searching for transactions |
| the integer block number to stop searching for transactions |
| the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"496492",
"timeStamp":"1644767322",
"hash":"0x433994d50986d0c021098adadac4f4a89249c51fb4ea372e553af6ee6fc0965c",
"nonce":"20",
"blockHash":"0x29394a72a707d77a167a1eec53d33940b5a366a2c01cd10094c18a15517ff44b",
"from":"0x84e9304fa9aafc5e70090eadda9ac2c76d93ad51",
"contractAddress":"0xa808b14492ac6e33419ac16112154d40d0a4aeba",
"to":"0x105083929bf9bb22c26cb1777ec92661170d4285",
"value":"100000000000000000000000",
"tokenName":"Vitcoin",
"tokenSymbol":"VTC",
"tokenDecimal":"18",
"transactionIndex":"0",
"gas":"53517",
"gasPrice":"1000000007",
"gasUsed":"35678",
"cumulativeGasUsed":"35678",
"input":"deprecated",
"confirmations":"589603"
},
{
"blockNumber":"886779",
"timeStamp":"1649789803",
"hash":"0x1071238546873837a9b03736a8ca26ce379e66999f6e74748dd919890232e34a",
"nonce":"28",
"blockHash":"0xd1a3ad751eba89ac664e691844a5a44361d8c801ce6bbfe31c03f1d7970e28f7",
"from":"0x84e9304fa9aafc5e70090eadda9ac2c76d93ad51",
"contractAddress":"0xa808b14492ac6e33419ac16112154d40d0a4aeba",
"to":"0x105083929bf9bb22c26cb1777ec92661170d4285",
"value":"999900000000000000000000000",
"tokenName":"Vitcoin",
"tokenSymbol":"VTC",
"tokenDecimal":"18",
"transactionIndex":"0",
"gas":"53553",
"gasPrice":"1500000007",
"gasUsed":"30902",
"cumulativeGasUsed":"30902",
"input":"deprecated",
"confirmations":"199316"
}
]
}
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-sepolia.etherscan.io/api
?module=account
&action=tokennfttx
&contractaddress=0x31225ffF34ebB599D018A22d2430c2e4fdE32eCa
&address=0x8a5847fd0e592b058c026c5fdc322aee834b87f5
&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.
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the address to check for balance |
| the string representing the token contract address to check for balance |
| the integer page number, if pagination is enabled |
| the number of transactions displayed per page |
| the integer block number to start searching for transactions |
| the integer block number to stop searching for transactions |
| the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"922742",
"timeStamp":"1650258658",
"hash":"0xe2e18e8831556beff9e08a9f04e0fd38fe290c9b62a49021cfa6b23cbd8900a3",
"nonce":"2",
"blockHash":"0xd3e6974bd02372a60e60399fe71f9f3972b5cb1d409e7751abfcadb302655e19",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0x31225fff34ebb599d018a22d2430c2e4fde32eca",
"to":"0x8a5847fd0e592b058c026c5fdc322aee834b87f5",
"tokenID":"1",
"tokenName":"Calcium",
"tokenSymbol":"CALC",
"tokenDecimal":"0",
"transactionIndex":"0",
"gas":"90805",
"gasPrice":"2000000007",
"gasUsed":"90805",
"cumulativeGasUsed":"90805",
"input":"deprecated",
"confirmations":"193136"
}
]
}
Get list of Blocks Mined by Address
Returns the list of blocks mined by an address.
https://api-sepolia.etherscan.io/api
?module=account
&action=getminedblocks
&address=0x3d080421c9DD5fB387d6e3124f7E1C241ADE9568
&blocktype=blocks
&page=1
&offset=10
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the address to check for balance |
| the string pre-defined block type, either blocks for canonical blocks or uncles for uncle blocks only |
| the integer page number, if pagination is enabled |
| the number of transactions displayed per page |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"1088398",
"timeStamp":"1652415312",
"blockReward":"2000000000000000000"
},
{
"blockNumber":"1088395",
"timeStamp":"1652415289",
"blockReward":"2000000000000000000"
},
{
"blockNumber":"1088361",
"timeStamp":"1652414946",
"blockReward":"2000000000000000000"
}
]
}