Accounts
Returns the Ether balance of a given address.
https://api-kovan.etherscan.io/api
?module=account
&action=balance
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
&tag=latest
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
address | the string representing the address to check for balance |
tag | the string pre-defined block parameter, either earliest , pending or latest |
Sample Response
{
"status":"1",
"message":"OK",
"result":"582297302626500759"
}
Returns the balance of the accounts from a list of addresses.
https://api-kovan.etherscan.io/api
?module=account
&action=balancemulti
&address=0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a,0x63a9975ba31b0b9626b34300f7f627147df1f526,0x198ef1ec325a96cc354c7266a038be8b5c558f67
&tag=latest
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
address | the strings representing the addresses to check for balance, separated by , commas
up to 20 addresses per call |
tag | the integer pre-defined block parameter, either earliest , pending or latest |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"account":"0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a",
"balance":"22625000000000000"
},
{
"account":"0x63a9975ba31b0b9626b34300f7f627147df1f526",
"balance":"3932002889971096"
},
{
"account":"0x198ef1ec325a96cc354c7266a038be8b5c558f67",
"balance":"0"
}
]
}
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-kovan.etherscan.io/api
?module=account
&action=txlist
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
address | the string representing the addresses to check for balance |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
page | the integer page number, if pagination is enabled |
offset | 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
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"22655707",
"timeStamp":"1608319320",
"hash":"0x3af0e2edfe6740e7459fd9cca50729178a4f6d6030e3b8c4a76de67b6b825ac5",
"nonce":"1415",
"blockHash":"0xf401a0868056aca4fc79e0cc471dd39eada8e94241f70b2bba08f291b883dbae",
"transactionIndex":"1",
"from":"0x085ee67132ec4297b85ed5d1b4c65424d36fda7d",
"to":"0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
"value":"18848330000000000",
"gas":"34860",
"gasPrice":"22000000000",
"isError":"0",
"txreceipt_status":"1",
"input":"0x",
"contractAddress":"",
"cumulativeGasUsed":"52697",
"gasUsed":"21000",
"confirmations":"5005630"
},
{
"blockNumber":"22655927",
"timeStamp":"1608320552",
"hash":"0x2f90edbe29c3703f0d8ad2a8f4d0c802596a6fef314cd2bb016cb5e321e28cb5",
"nonce":"1416",
"blockHash":"0xc5f98dbea8585310732c682a783c458e2143f62c3f354875983547c36e08296c",
"transactionIndex":"1",
"from":"0x085ee67132ec4297b85ed5d1b4c65424d36fda7d",
"to":"0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
"value":"19016160000000000",
"gas":"34860",
"gasPrice":"22000000000",
"isError":"0",
"txreceipt_status":"1",
"input":"0x",
"contractAddress":"",
"cumulativeGasUsed":"52697",
"gasUsed":"21000",
"confirmations":"5005410"
}
]
}
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-kovan.etherscan.io/api
?module=account
&action=txlistinternal
&address=0x5aa0492f89a134c6b779d34d9152d61664563917
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
address | the string representing the addresses to check for balance |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
page | the integer page number, if pagination is enabled |
offset | 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
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"2535368",
"timeStamp":"1477837690",
"hash":"0x8a1a9989bda84f80143181a68bc137ecefa64d0d4ebde45dd94fc0cf49e70cb6",
"from":"0x20d42f2e99a421147acf198d775395cac2e8b03d",
"to":"",
"value":"0",
"contractAddress":"0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3",
"input":"",
"type":"create",
"gas":"254791",
"gasUsed":"46750",
"traceId":"0",
"isError":"0",
"errCode":""
},
{
"blockNumber":"2535479",
"timeStamp":"1477839134",
"hash":"0x1a50f1dc0bc912745f7d09b988669f71d199719e2fb7592c2074ede9578032d0",
"from":"0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3",
"to":"0x20d42f2e99a421147acf198d775395cac2e8b03d",
"value":"100000000000000000",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"235231",
"gasUsed":"0",
"traceId":"0",
"isError":"0",
"errCode":""
}
]
}
Returns the list of internal transactions performed within a transaction.
Note : This API endpoint returns a maximum of 10000 records only.
https://api-kovan.etherscan.io/api
?module=account
&action=txlistinternal
&txhash=0x29d99e52f3299e49bda3c138290471a10c8686fb74904a850faacc62dd718251
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
txhash | the string representing the transaction hash to check for internal transactions |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"26866198",
"timeStamp":"1629505648",
"from":"0x789b9a77492935b9943e0fd2f04a77aefd992e9d",
"to":"",
"value":"0",
"contractAddress":"0xce0f03403dfc3986c61267c4c665d055c8289baf",
"input":"",
"type":"create",
"gas":"1018648",
"gasUsed":"9031",
"isError":"0",
"errCode":""
},
{
"blockNumber":"26866198",
"timeStamp":"1629505648",
"from":"0x789b9a77492935b9943e0fd2f04a77aefd992e9d",
"to":"",
"value":"0",
"contractAddress":"0x92e72dcda2051a710e25cb31aa24482729f3fcae",
"input":"",
"type":"create",
"gas":"978085",
"gasUsed":"9031",
"isError":"0",
"errCode":""
}
]
}
The
isError
field returns 0
for successful transactions and 1
for rejected/cancelled transactions. 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-kovan.etherscan.io/api
?module=account
&action=txlistinternal
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"11041",
"timeStamp":"1488555303",
"hash":"0x1ca094d8a3f667c97f47bf21dd5398e860664e31c8d5a51daa443d99e76725a6",
"from":"0xa22b7a981938013c152c758c08d5abdc42bf9f59",
"to":"0x00ee02bb49271953e00b37a457c47cf79fd2c454",
"value":"250000000000000000",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"19156",
"gasUsed":"0",
"traceId":"0",
"isError":"0",
"errCode":""
},
{
"blockNumber":"11679",
"timeStamp":"1488557927",
"hash":"0x47ccd6957faafe8dd762d228143adc08b54deb0539a0ecba38cc359e20e8cb0d",
"from":"0x93694d308444be794ee52e1571ca792a8f3fff7c",
"to":"0x00ee02bb49271953e00b37a457c47cf79fd2c454",
"value":"200000000000000000",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"10281",
"gasUsed":"0",
"traceId":"0",
"isError":"0",
"errCode":""
}
]
}
The
isError
field returns 0
for successful transactions and 1
for rejected/cancelled transactions. Returns the list of ERC-20 tokens transferred by an address, with optional filtering by token contract.
https://api-kovan.etherscan.io/api
?module=account
&action=tokentx
&contractaddress=0xdcf0af9e59c002fa3aa091a46196b37530fd48a8
&address=0x464c71f6c2f760dda6093dcb91c24c39e5d6e18c
&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
andcontract address
parameters.
Request
Response
Query Parameters
Parameter | Description |
---|---|
address | the string representing the address to check for balance |
contractaddress | the string representing the token contract address to check for balance |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"22357534",
"timeStamp":"1606746480",
"hash":"0x95f357d1ad861906acc6b44db52830bb6354ddd6a16c917762da5aebd7edfe3e",
"nonce":"218",
"blockHash":"0x8f1b298a88a6da3312310a11607105ba054edb3d9d883f5fb0bb684d446192e8",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0xdcf0af9e59c002fa3aa091a46196b37530fd48a8",
"to":"0x464c71f6c2f760dda6093dcb91c24c39e5d6e18c",
"value":"2409944194",
"tokenName":"Aave interest bearing DAI",
"tokenSymbol":"aDAI",
"tokenDecimal":"18",
"transactionIndex":"0",
"gas":"243262",
"gasPrice":"30000000000",
"gasUsed":"218110",
"cumulativeGasUsed":"218110",
"input":"deprecated",
"confirmations":"5304123"
},
{
"blockNumber":"22361676",
"timeStamp":"1606767904",
"hash":"0x3550e34e0a980f95b027e0e5fad002257c8b1051941ddb04d60d40441ab6ae28",
"nonce":"85",
"blockHash":"0x74567f24a3d9c49e2385fc163b6f3f546184e7a12e94a9e6e376a0256b17f530",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0xdcf0af9e59c002fa3aa091a46196b37530fd48a8",
"to":"0x464c71f6c2f760dda6093dcb91c24c39e5d6e18c",
"value":"7413016075418007",
"tokenName":"Aave interest bearing DAI",
"tokenSymbol":"aDAI",
"tokenDecimal":"18",
"transactionIndex":"1",
"gas":"400000",
"gasPrice":"30000000000",
"gasUsed":"214908",
"cumulativeGasUsed":"235908",
"input":"deprecated",
"confirmations":"5299981"
}
]
}
Returns the list of ERC-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract.
https://api-kovan.etherscan.io/api
?module=account
&action=tokennfttx
&contractaddress=0x7ae06dfee00fc92020264023e9041751dbe2144a
&address=0x59efaaaabae11403f3aa21dc78e5941c6db340f7
&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
andcontract address
parameters.
Request
Response
Query Parameters
Parameter | Description |
---|---|
address | the string representing the address to check for balance |
contractaddress | the string representing the token contract address to check for balance |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"27646129",
"timeStamp":"1633973956",
"hash":"0x10d4b880d58a2e15a2dfebc98f19f910c058ca61665107192612de1cfc9916a1",
"nonce":"28",
"blockHash":"0x5bd8fafc72da9b6635c927aaa1b0fd95f711231c73e1068535b15553e1dad487",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0x7ae06dfee00fc92020264023e9041751dbe2144a",
"to":"0x59efaaaabae11403f3aa21dc78e5941c6db340f7",
"tokenID":"9290",
"tokenName":"GyroNFT",
"tokenSymbol":"GYN",
"tokenDecimal":"0",
"transactionIndex":"7",
"gas":"300662",
"gasPrice":"3000000008",
"gasUsed":"297354",
"cumulativeGasUsed":"2400296",
"input":"deprecated",
"confirmations":"15566"
}
]
}
Returns the list of blocks mined by an address.
https://api-kovan.etherscan.io/api
?module=account
&action=getminedblocks
&address=0x03801EfB0EFe2a25ede5Dd3a003Ae880C0292e4d
&blocktype=blocks
&page=1
&offset=10
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
address | the string representing the address to check for balance |
blocktype | the string pre-defined block type, either blocks for canonical blocks or uncles for uncle blocks only |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"27661730",
"timeStamp":"1634036980",
"blockReward":"5000445062750111281"
},
{
"blockNumber":"27661728",
"timeStamp":"1634036972",
"blockReward":"5001647860990400711"
}
]
}
Last modified 1yr ago