Accounts
Get Ether Balance for a Single Address
Returns the Ether balance of a given address.
1
https://api-kovan.etherscan.io/api
2
?module=account
3
&action=balance
4
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
5
&tag=latest
6
&apikey=YourApiKeyToken
Copied!
Request
Response
Query Parameters
Parameter
Description
address
the
string representing the address to check for balancetag
the
string pre-defined block parameter, either earliest, pending or latestSample Response
1
{
2
"status":"1",
3
"message":"OK",
4
"result":"582297302626500759"
5
}
Copied!
Get Ether Balance for Multiple Addresses in a Single Call
Returns the balance of the accounts from a list of addresses.
1
https://api-kovan.etherscan.io/api
2
?module=account
3
&action=balancemulti
4
&address=0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a,0x63a9975ba31b0b9626b34300f7f627147df1f526,0x198ef1ec325a96cc354c7266a038be8b5c558f67
5
&tag=latest
6
&apikey=YourApiKeyToken
Copied!
Request
Response
Query Parameters
Parameter
Description
address
the
strings representing the addresses to check for balance, separated by , commas
up to 20 addresses per calltag
the
integer pre-defined block parameter, either earliest, pending or latestSample Response
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"account":"0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a",
7
"balance":"22625000000000000"
8
},
9
{
10
"account":"0x63a9975ba31b0b9626b34300f7f627147df1f526",
11
"balance":"3932002889971096"
12
},
13
{
14
"account":"0x198ef1ec325a96cc354c7266a038be8b5c558f67",
15
"balance":"0"
16
}
17
]
18
}
Copied!
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.
📝
1
https://api-kovan.etherscan.io/api
2
?module=account
3
&action=txlist
4
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
5
&startblock=0
6
&endblock=99999999
7
&page=1
8
&offset=10
9
&sort=asc
10
&apikey=YourApiKeyToken
Copied!
Request
Response
Query Parameters
Parameter
Description
address
the
string representing the addresses to check for balancestartblock
the
integer block number to start searching for transactionsendblock
the
integer block number to stop searching for transactionspage
the
integer page number, if pagination is enabledoffset
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.Sample Response
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"blockNumber":"22655707",
7
"timeStamp":"1608319320",
8
"hash":"0x3af0e2edfe6740e7459fd9cca50729178a4f6d6030e3b8c4a76de67b6b825ac5",
9
"nonce":"1415",
10
"blockHash":"0xf401a0868056aca4fc79e0cc471dd39eada8e94241f70b2bba08f291b883dbae",
11
"transactionIndex":"1",
12
"from":"0x085ee67132ec4297b85ed5d1b4c65424d36fda7d",
13
"to":"0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
14
"value":"18848330000000000",
15
"gas":"34860",
16
"gasPrice":"22000000000",
17
"isError":"0",
18
"txreceipt_status":"1",
19
"input":"0x",
20
"contractAddress":"",
21
"cumulativeGasUsed":"52697",
22
"gasUsed":"21000",
23
"confirmations":"5005630"
24
},
25
{
26
"blockNumber":"22655927",
27
"timeStamp":"1608320552",
28
"hash":"0x2f90edbe29c3703f0d8ad2a8f4d0c802596a6fef314cd2bb016cb5e321e28cb5",
29
"nonce":"1416",
30
"blockHash":"0xc5f98dbea8585310732c682a783c458e2143f62c3f354875983547c36e08296c",
31
"transactionIndex":"1",
32
"from":"0x085ee67132ec4297b85ed5d1b4c65424d36fda7d",
33
"to":"0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
34
"value":"19016160000000000",
35
"gas":"34860",
36
"gasPrice":"22000000000",
37
"isError":"0",
38
"txreceipt_status":"1",
39
"input":"0x",
40
"contractAddress":"",
41
"cumulativeGasUsed":"52697",
42
"gasUsed":"21000",
43
"confirmations":"5005410"
44
}
45
]
46
}
Copied!
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.
📝
1
https://api-kovan.etherscan.io/api
2
?module=account
3
&action=txlistinternal
4
&address=0x5aa0492f89a134c6b779d34d9152d61664563917
5
&startblock=0
6
&endblock=99999999
7
&page=1
8
&offset=10
9
&sort=asc
10
&apikey=YourApiKeyToken
Copied!
Request
Response
Query Parameters
Parameter
Description
address
the
string representing the addresses to check for balancestartblock
the
integer block number to start searching for transactionsendblock
the
integer block number to stop searching for transactionspage
the
integer page number, if pagination is enabledoffset
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 resultsSample Response
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"blockNumber":"2535368",
7
"timeStamp":"1477837690",
8
"hash":"0x8a1a9989bda84f80143181a68bc137ecefa64d0d4ebde45dd94fc0cf49e70cb6",
9
"from":"0x20d42f2e99a421147acf198d775395cac2e8b03d",
10
"to":"",
11
"value":"0",
12
"contractAddress":"0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3",
13
"input":"",
14
"type":"create",
15
"gas":"254791",
16
"gasUsed":"46750",
17
"traceId":"0",
18
"isError":"0",
19
"errCode":""
20
},
21
{
22
"blockNumber":"2535479",
23
"timeStamp":"1477839134",
24
"hash":"0x1a50f1dc0bc912745f7d09b988669f71d199719e2fb7592c2074ede9578032d0",
25
"from":"0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3",
26
"to":"0x20d42f2e99a421147acf198d775395cac2e8b03d",
27
"value":"100000000000000000",
28
"contractAddress":"",
29
"input":"",
30
"type":"call",
31
"gas":"235231",
32
"gasUsed":"0",
33
"traceId":"0",
34
"isError":"0",
35
"errCode":""
36
}
37
]
38
}
Copied!
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.
1
https://api-kovan.etherscan.io/api
2
?module=account
3
&action=txlistinternal
4
&txhash=0x29d99e52f3299e49bda3c138290471a10c8686fb74904a850faacc62dd718251
5
&apikey=YourApiKeyToken
Copied!
Request
Response
Query Parameters
Parameter
Description
txhash
the
string representing the transaction hash to check for internal transactionsSample Response
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"blockNumber":"26866198",
7
"timeStamp":"1629505648",
8
"from":"0x789b9a77492935b9943e0fd2f04a77aefd992e9d",
9
"to":"",
10
"value":"0",
11
"contractAddress":"0xce0f03403dfc3986c61267c4c665d055c8289baf",
12
"input":"",
13
"type":"create",
14
"gas":"1018648",
15
"gasUsed":"9031",
16
"isError":"0",
17
"errCode":""
18
},
19
{
20
"blockNumber":"26866198",
21
"timeStamp":"1629505648",
22
"from":"0x789b9a77492935b9943e0fd2f04a77aefd992e9d",
23
"to":"",
24
"value":"0",
25
"contractAddress":"0x92e72dcda2051a710e25cb31aa24482729f3fcae",
26
"input":"",
27
"type":"create",
28
"gas":"978085",
29
"gasUsed":"9031",
30
"isError":"0",
31
"errCode":""
32
}
33
]
34
}
Copied!
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.
📝
1
https://api-kovan.etherscan.io/api
2
?module=account
3
&action=txlistinternal
4
&startblock=0
5
&endblock=99999999
6
&page=1
7
&offset=10
8
&sort=asc
9
&apikey=YourApiKeyToken
Copied!
Request
Response
Query Parameters
Parameter
Description
startblock
the
integer block number to start searching for transactionsendblock
the
integer block number to stop searching for transactionspage
the
integer page number, if pagination is enabledoffset
the number of transactions displayed per page
sort
the sorting preference, use
asc to sort by ascending and desc to sort by descendingSample Response
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"blockNumber":"11041",
7
"timeStamp":"1488555303",
8
"hash":"0x1ca094d8a3f667c97f47bf21dd5398e860664e31c8d5a51daa443d99e76725a6",
9
"from":"0xa22b7a981938013c152c758c08d5abdc42bf9f59",
10
"to":"0x00ee02bb49271953e00b37a457c47cf79fd2c454",
11
"value":"250000000000000000",
12
"contractAddress":"",
13
"input":"",
14
"type":"call",
15
"gas":"19156",
16
"gasUsed":"0",
17
"traceId":"0",
18
"isError":"0",
19
"errCode":""
20
},
21
{
22
"blockNumber":"11679",
23
"timeStamp":"1488557927",
24
"hash":"0x47ccd6957faafe8dd762d228143adc08b54deb0539a0ecba38cc359e20e8cb0d",
25
"from":"0x93694d308444be794ee52e1571ca792a8f3fff7c",
26
"to":"0x00ee02bb49271953e00b37a457c47cf79fd2c454",
27
"value":"200000000000000000",
28
"contractAddress":"",
29
"input":"",
30
"type":"call",
31
"gas":"10281",
32
"gasUsed":"0",
33
"traceId":"0",
34
"isError":"0",
35
"errCode":""
36
}
37
]
38
}
Copied!
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.
1
https://api-kovan.etherscan.io/api
2
?module=account
3
&action=tokentx
4
&contractaddress=0xdcf0af9e59c002fa3aa091a46196b37530fd48a8
5
&address=0x464c71f6c2f760dda6093dcb91c24c39e5d6e18c
6
&page=1
7
&offset=100
8
&startblock=0
9
&endblock=99999999
10
&sort=asc
11
&apikey=YourApiKeyToken
Copied!
Usage:
- ERC-20 transfers from an address, specify the
addressparameter - ERC-20 transfers from a contract address, specify the
contract addressparameter - ERC-20 transfers from an address filtered by a token contract, specify both
addressandcontract addressparameters.
Request
Response
Query Parameters
Parameter
Description
address
the
string representing the address to check for balancecontractaddress
the
string representing the token contract address to check for balancepage
the
integer page number, if pagination is enabledoffset
the number of transactions displayed per page
startblock
the
integer block number to start searching for transactionsendblock
the
integer block number to stop searching for transactionssort
the sorting preference, use
asc to sort by ascending and desc to sort by descendingSample Response
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"blockNumber":"22357534",
7
"timeStamp":"1606746480",
8
"hash":"0x95f357d1ad861906acc6b44db52830bb6354ddd6a16c917762da5aebd7edfe3e",
9
"nonce":"218",
10
"blockHash":"0x8f1b298a88a6da3312310a11607105ba054edb3d9d883f5fb0bb684d446192e8",
11
"from":"0x0000000000000000000000000000000000000000",
12
"contractAddress":"0xdcf0af9e59c002fa3aa091a46196b37530fd48a8",
13
"to":"0x464c71f6c2f760dda6093dcb91c24c39e5d6e18c",
14
"value":"2409944194",
15
"tokenName":"Aave interest bearing DAI",
16
"tokenSymbol":"aDAI",
17
"tokenDecimal":"18",
18
"transactionIndex":"0",
19
"gas":"243262",
20
"gasPrice":"30000000000",
21
"gasUsed":"218110",
22
"cumulativeGasUsed":"218110",
23
"input":"deprecated",
24
"confirmations":"5304123"
25
},
26
{
27
"blockNumber":"22361676",
28
"timeStamp":"1606767904",
29
"hash":"0x3550e34e0a980f95b027e0e5fad002257c8b1051941ddb04d60d40441ab6ae28",
30
"nonce":"85",
31
"blockHash":"0x74567f24a3d9c49e2385fc163b6f3f546184e7a12e94a9e6e376a0256b17f530",
32
"from":"0x0000000000000000000000000000000000000000",
33
"contractAddress":"0xdcf0af9e59c002fa3aa091a46196b37530fd48a8",
34
"to":"0x464c71f6c2f760dda6093dcb91c24c39e5d6e18c",
35
"value":"7413016075418007",
36
"tokenName":"Aave interest bearing DAI",
37
"tokenSymbol":"aDAI",
38
"tokenDecimal":"18",
39
"transactionIndex":"1",
40
"gas":"400000",
41
"gasPrice":"30000000000",
42
"gasUsed":"214908",
43
"cumulativeGasUsed":"235908",
44
"input":"deprecated",
45
"confirmations":"5299981"
46
}
47
]
48
}
Copied!
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.
1
https://api-kovan.etherscan.io/api
2
?module=account
3
&action=tokennfttx
4
&contractaddress=0x7ae06dfee00fc92020264023e9041751dbe2144a
5
&address=0x59efaaaabae11403f3aa21dc78e5941c6db340f7
6
&page=1
7
&offset=100
8
&startblock=0
9
&endblock=99999999
10
&sort=asc
11
&apikey=YourApiKeyToken
Copied!
Usage:
- ERC-721 transfers from an address, specify the
addressparameter - ERC-721 transfers from a contract address, specify the
contract addressparameter - ERC-721 transfers from an address filtered by a token contract, specify both
addressandcontract addressparameters.
Request
Response
Query Parameters
Parameter
Description
address
the
string representing the address to check for balancecontractaddress
the
string representing the token contract address to check for balancepage
the
integer page number, if pagination is enabledoffset
the number of transactions displayed per page
startblock
the
integer block number to start searching for transactionsendblock
the
integer block number to stop searching for transactionssort
the sorting preference, use
asc to sort by ascending and desc to sort by descendingSample Response
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"blockNumber":"27646129",
7
"timeStamp":"1633973956",
8
"hash":"0x10d4b880d58a2e15a2dfebc98f19f910c058ca61665107192612de1cfc9916a1",
9
"nonce":"28",
10
"blockHash":"0x5bd8fafc72da9b6635c927aaa1b0fd95f711231c73e1068535b15553e1dad487",
11
"from":"0x0000000000000000000000000000000000000000",
12
"contractAddress":"0x7ae06dfee00fc92020264023e9041751dbe2144a",
13
"to":"0x59efaaaabae11403f3aa21dc78e5941c6db340f7",
14
"tokenID":"9290",
15
"tokenName":"GyroNFT",
16
"tokenSymbol":"GYN",
17
"tokenDecimal":"0",
18
"transactionIndex":"7",
19
"gas":"300662",
20
"gasPrice":"3000000008",
21
"gasUsed":"297354",
22
"cumulativeGasUsed":"2400296",
23
"input":"deprecated",
24
"confirmations":"15566"
25
}
26
]
27
}
Copied!
Get list of Blocks Mined by Address
Returns the list of blocks mined by an address.
1
https://api-kovan.etherscan.io/api
2
?module=account
3
&action=getminedblocks
4
&address=0x03801EfB0EFe2a25ede5Dd3a003Ae880C0292e4d
5
&blocktype=blocks
6
&page=1
7
&offset=10
8
&apikey=YourApiKeyToken
Copied!
Request
Response
Query Parameters
Parameter
Description
address
the
string representing the address to check for balanceblocktype
the
string pre-defined block type, either blocks for canonical blocks or uncles for uncle blocks onlypage
the
integer page number, if pagination is enabledoffset
the number of transactions displayed per page
Sample Response
1
{
2
"status":"1",
3
"message":"OK",
4
"result":[
5
{
6
"blockNumber":"27661730",
7
"timeStamp":"1634036980",
8
"blockReward":"5000445062750111281"
9
},
10
{
11
"blockNumber":"27661728",
12
"timeStamp":"1634036972",
13
"blockReward":"5001647860990400711"
14
}
15
]
16
}
Copied!
Last modified 5mo ago
Copy link
Contents
Get Ether Balance for a Single Address
Get Ether Balance for Multiple Addresses in a Single Call
Get a list of 'Normal' Transactions By Address
Get a list of 'Internal' Transactions by Address
Get 'Internal Transactions' by Transaction Hash
Get "Internal Transactions" by Block Range
Get a list of 'ERC20 - Token Transfer Events' by Address
Get a list of 'ERC721 - Token Transfer Events' by Address
Get list of Blocks Mined by Address