Get ETH Balance for a Single Address
Returns the ETH balance of a given address.
https://api-zkevm.polygonscan.com/api
?module=account
&action=balance
&address=0xE4eDb277e41dc89aB076a1F049f4a3EfA700bCE8
&apikey=YourApiKeyToken
Sample response
{
"status":"1",
"message":"OK",
"result":"9996128487000000000"
}
Get ETH Balance for Multiple Addresses in a Single Call
Returns the balance of the accounts from a list of addresses.
https://api-zkevm.polygonscan.com/api
?module=account
&action=balancemulti
&address=0x5A534988535cf27a70e74dFfe299D06486f185B7,0x54bA15efe1b6D886bA4Cd5C5837240675BD0D43a,0x39842a0Fe638cc956b76A49E918c30d818708BA0
&tag=latest
&apikey=YourApiKeyToken
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"account":"0x5A534988535cf27a70e74dFfe299D06486f185B7",
"balance":"9996128487000000000"
},
{
"account":"0x54bA15efe1b6D886bA4Cd5C5837240675BD0D43a",
"balance":"119463385027459645"
},
{
"account":"0x39842a0Fe638cc956b76A49E918c30d818708BA0",
"balance":"100761697447268339"
}
]
}
Get a list of 'Normal' Transactions By Address
Returns the list of transactions performed by an address, with optional pagination.
https://api-zkevm.polygonscan.com/api
?module=account
&action=txlist
&address=0xE4eDb277e41dc89aB076a1F049f4a3EfA700bCE8
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "8300",
"blockHash": "0x9c24cca6d177c21dc185cdbc08db980fe52a866e90a0b8957538cf6ca83cf449",
"timeStamp": "1679988122",
"hash": "0x03185c94f200ef6864b9bf215f7b1c1bba63b3037ca018e8f7b3d24ce5de8c66",
"nonce": "2",
"transactionIndex": "0",
"from": "0x151409521fc4af3dbace6d97fd4148a44bf07300",
"to": "0xe4edb277e41dc89ab076a1f049f4a3efa700bce8",
"value": "59000000000000000000",
"gas": "21000",
"gasPrice": "3540001235",
"input": "0x",
"methodId": "0x",
"functionName": "",
"contractAddress": "",
"cumulativeGasUsed": "21000",
"txreceipt_status": "1",
"gasUsed": "21000",
"confirmations": "353827",
"isError": "0"
},
{
"blockNumber": "9804",
"blockHash": "0x2ef9b780faeefc106d17c5364be9bc467e6f473072efd79abda88690b233db6a",
"timeStamp": "1679998590",
"hash": "0xed7306be4961d46755dbd5896e3de15582f4cae7126256f0f0ea8ec2b1a07c57",
"nonce": "0",
"transactionIndex": "0",
"from": "0xe4edb277e41dc89ab076a1f049f4a3efa700bce8",
"to": "0xfd38ea22ebc3be1de4ca39f460da500db85edcc6",
"value": "5000000000000089",
"gas": "100000",
"gasPrice": "3640000000",
"input": "0x",
"methodId": "0x",
"functionName": "",
"contractAddress": "",
"cumulativeGasUsed": "21000",
"txreceipt_status": "1",
"gasUsed": "21000",
"confirmations": "352323",
"isError": "0"
}
]
}
Get a list of 'Internal' Transactions by Address
Returns the list of internal transactions performed by an address, with optional pagination.
https://api-zkevm.polygonscan.com/api
?module=account
&action=txlistinternal
&address=0x90cc6C10C7211844c66640b4d01486cb45E0F3E8
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "306744",
"timeStamp": "1684511175",
"hash": "0x408f3c8e4e1f0824ac19fb64ecb96c5f88c21dd321d828923c7d2f9463287e5d",
"from": "0x0000000000ffe8b47b3e2130213b802212439497",
"to": "",
"value": "0",
"contractAddress": "0x90cc6c10c7211844c66640b4d01486cb45e0f3e8",
"input": "",
"type": "create2",
"gas": "586434",
"gasUsed": "3",
"traceId": "0_1",
"isError": "0",
"errCode": ""
}
]
}
Get 'Internal Transactions' by Transaction Hash
Returns the list of internal transactions performed within a transaction.
https://api-zkevm.polygonscan.com/api
?module=account
&action=txlistinternal
&txhash=0x408f3c8e4e1f0824ac19fb64ecb96c5f88c21dd321d828923c7d2f9463287e5d
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "306744",
"timeStamp": "1684511175",
"from": "0x0000000000ffe8b47b3e2130213b802212439497",
"to": "",
"value": "0",
"contractAddress": "0x90cc6c10c7211844c66640b4d01486cb45e0f3e8",
"input": "",
"type": "create2",
"gas": "586434",
"gasUsed": "3",
"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.
https://api-zkevm.polygonscan.com/api
?module=account
&action=txlistinternal
&startblock=306743
&endblock=306744
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "306744",
"timeStamp": "1684511175",
"hash": "0x408f3c8e4e1f0824ac19fb64ecb96c5f88c21dd321d828923c7d2f9463287e5d",
"from": "0x0000000000ffe8b47b3e2130213b802212439497",
"to": "",
"value": "0",
"contractAddress": "0x90cc6c10c7211844c66640b4d01486cb45e0f3e8",
"input": "",
"type": "create2",
"gas": "586434",
"gasUsed": "3",
"traceId": "0_1",
"isError": "0",
"errCode": ""
}
]
}
The isError
field returns 0
for successful transactions and 1
for rejected/cancelled transactions.
Get a list of 'ERC-20 Token Transfer Events' by Address
Returns the list of ERC-20 tokens transferred by an address, with optional filtering by token contract.
https://api-zkevm.polygonscan.com/api
?module=account
&action=tokentx
&contractaddress=0x90cc6C10C7211844c66640b4d01486cb45E0F3E8
&address=0x808081269906e0e01285ed9c3525c67e09811860
&startblock=0
&endblock=99999999
&page=1
&offset=5
&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.
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "306744",
"timeStamp": "1684511175",
"hash": "0x408f3c8e4e1f0824ac19fb64ecb96c5f88c21dd321d828923c7d2f9463287e5d",
"nonce": "0",
"blockHash": "0xd9bd4ca7862c8c415666ec089ab5107b8ce03a742ad20c379cf5e5219cf14368",
"from": "0x0000000000000000000000000000000000000000",
"contractAddress": "0x90cc6c10c7211844c66640b4d01486cb45e0f3e8",
"to": "0x808081269906e0e01285ed9c3525c67e09811860",
"value": "21000000000000000000000000",
"tokenName": "Fastest Shipper",
"tokenSymbol": "SHIP",
"tokenDecimal": "18",
"transactionIndex": "0",
"gas": "670044",
"gasPrice": "6380000000",
"gasUsed": "666289",
"cumulativeGasUsed": "666289",
"input": "deprecated",
"confirmations": "55439"
}
]
}
Get a list of 'ERC-721 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-zkevm.polygonscan.com/api
?module=account
&action=tokennfttx
&contractaddress=0x91553861aA69B17F2d0302811B4CeC0626602174
&address=0xfece8860904bcf6d27084dd0b62f098224aea250
&startblock=0
&endblock=99999999
&page=1
&offset=100
&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.
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "105568",
"timeStamp": "1681095318",
"hash": "0xaddd79d22794c6c51c0588c8d080c2d9bc40a672c219daa3e1bf58822c785c39",
"nonce": "1545",
"blockHash": "0x9543776a01a0fedcafabb1c466b6c759fca713d69b1e7377501f0506e6ce0ff6",
"from": "0x0000000000000000000000000000000000000000",
"contractAddress": "0x91553861aa69b17f2d0302811b4cec0626602174",
"to": "0xfece8860904bcf6d27084dd0b62f098224aea250",
"tokenID": "170493",
"tokenName": "To Ethereum, with Love",
"tokenSymbol": "ZKEVM",
"tokenDecimal": "0",
"transactionIndex": "0",
"gas": "2698629",
"gasPrice": "2930000000",
"gasUsed": "2655236",
"cumulativeGasUsed": "2655236",
"input": "deprecated",
"confirmations": "256702"
},
{
"blockNumber": "105568",
"timeStamp": "1681095318",
"hash": "0xaddd79d22794c6c51c0588c8d080c2d9bc40a672c219daa3e1bf58822c785c39",
"nonce": "1545",
"blockHash": "0x9543776a01a0fedcafabb1c466b6c759fca713d69b1e7377501f0506e6ce0ff6",
"from": "0x0000000000000000000000000000000000000000",
"contractAddress": "0x91553861aa69b17f2d0302811b4cec0626602174",
"to": "0xfece8860904bcf6d27084dd0b62f098224aea250",
"tokenID": "170494",
"tokenName": "To Ethereum, with Love",
"tokenSymbol": "ZKEVM",
"tokenDecimal": "0",
"transactionIndex": "0",
"gas": "2698629",
"gasPrice": "2930000000",
"gasUsed": "2655236",
"cumulativeGasUsed": "2655236",
"input": "deprecated",
"confirmations": "256702"
}
]
}
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-zkevm.polygonscan.com/api
?module=account
&action=token1155tx
&contractaddress=0xb0E834FB82f890bF6f458C9aAa4e6d9e8411BB20
&address=0x1c87869225399b62206cfced6fe883d0ac725c11
&page=1
&offset=100
&startblock=0
&endblock=99999999
&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.
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "120400",
"timeStamp": "1681403637",
"hash": "0xe60618e221ea3f865473b4eb6a9237d43a808ae92ee454d0ed74875f84bee5de",
"nonce": "5",
"blockHash": "0x08db8ac68d72b3d576ef0cc2644b32e3af84a97dd329ab8b3fadc4e9bd326466",
"transactionIndex": "0",
"gas": "131273",
"gasPrice": "4860000000",
"gasUsed": "127627",
"cumulativeGasUsed": "127627",
"input": "deprecated",
"contractAddress": "0xb0e834fb82f890bf6f458c9aaa4e6d9e8411bb20",
"from": "0x0000000000000000000000000000000000000000",
"to": "0x1c87869225399b62206cfced6fe883d0ac725c11",
"tokenID": "0",
"tokenValue": "1",
"tokenName": "zkEVM – Unconstrained Scalability",
"tokenSymbol": "ZKVITB",
"confirmations": "241918"
}
]
}
Get list of Blocks Validated by Address
Returns the list of blocks validated by an address.
https://api-zkevm.polygonscan.com/api
?module=account
&action=getminedblocks
&address=0xb79fad4ca981472442f53d16365fdf0305ffd8e9
&blocktype=blocks
&page=1
&offset=10
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "362331",
"timeStamp": "1684823412",
"blockReward": "157875690000000"
},
{
"blockNumber": "362330",
"timeStamp": "1684823412",
"blockReward": "800646980000000"
},
{
"blockNumber": "362329",
"timeStamp": "1684823412",
"blockReward": "1816699640000000"
},
{
"blockNumber": "362328",
"timeStamp": "1684823412",
"blockReward": "155319400000000"
},
{
"blockNumber": "362327",
"timeStamp": "1684823412",
"blockReward": "96908800000000"
},
{
"blockNumber": "362326",
"timeStamp": "1684823412",
"blockReward": "90216000000000"
},
{
"blockNumber": "362325",
"timeStamp": "1684823412",
"blockReward": "90216000000000"
},
{
"blockNumber": "362324",
"timeStamp": "1684823412",
"blockReward": "137744540000000"
},
{
"blockNumber": "362323",
"timeStamp": "1684823412",
"blockReward": "137780300000000"
},
{
"blockNumber": "362322",
"timeStamp": "1684823412",
"blockReward": "70350000000000"
}
]
}