Get Ether Balance for a Single Address
Returns the Ether balance of a given address.
https://api-era.zksync.network/api
?module=account
&action=balance
&address=0x65E3A21f956784f8ca157B640417ecB5FfB4E1fa
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser
Sample response
{
"status":"1",
"message":"OK",
"result":"40891626854930000000000"
}
Get Ether Balance for Multiple Addresses in a Single Call
Returns the balance of the accounts from a list of addresses.
https://api-era.zksync.network/api
?module=account
&action=balancemulti
&address=0x05411bCC63167a82057Be42bC1b7022C12c99Aa4,0x0D0707963952f2fBA59dD06f2b425ace40b492Fe,0x0D0707963952f2fBA59dD06f2b425ace40b492Fe
&tag=latest
&apikey=YourApiKeyToken
Sample Response
{
"status": "0",
"message": "OK",
"result": [
{
"account": "0x05411bCC63167a82057Be42bC1b7022C12c99Aa4",
"balance": ""
},
{
"account": "0x0D0707963952f2fBA59dD06f2b425ace40b492Fe",
"balance": ""
},
{
"account": "0x0D0707963952f2fBA59dD06f2b425ace40b492Fe",
"balance": ""
}
]
}
Get a list of 'Normal' Transactions By Address
Returns the list of transactions performed by an address, with optional pagination.
https://api-era.zksync.network/api
?module=account
&action=txlist
&address=0x05411bCC63167a82057Be42bC1b7022C12c99Aa4
&startblock=0
&endblock=99999999
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK-Missing/Invalid API Key, rate limit of 1/3sec applied",
"result": [
{
"blockNumber": "2902873",
"timeStamp": "1683359398",
"hash": "0x85d46775a091e951b354f9bdcb27b80a248708c3e320658c0e3961653611f138",
"nonce": "0",
"blockHash": "0xd88ad6c146755b15949eb728b738ab77420b9fd5cdee344743b68c385432a116",
"transactionIndex": "0",
"from": "0xc4342957bf61414150ca00a19f89827bcf15ba86",
"to": "0x05411bcc63167a82057be42bc1b7022c12c99aa4",
"value": "209250000000000000",
"gas": "2500000",
"gasPrice": "250000000",
"isError": "0",
"txreceipt_status": "0",
"input": "0x",
"contractAddress": "",
"cumulativeGasUsed": "0",
"gasUsed": "2021064",
"confirmations": "20106082",
"methodId": "0x",
"functionName": ""
},
{
"blockNumber": "2907968",
"timeStamp": "1683365990",
"hash": "0x2747a16507c1a5687f23431997bbdd2bb2be0cfa6e3c3d02fe121ffa0ad2bede",
"nonce": "0",
"blockHash": "0x1b89f5d7cc75027db24c81952b5387b6615f530df2a72aa4d0a80f0e1898979e",
"transactionIndex": "0",
"from": "0xb7b4b06b70beffd354e21d690b4b67522d385e50",
"to": "0x05411bcc63167a82057be42bc1b7022c12c99aa4",
"value": "129370910000000000",
"gas": "6000000",
"gasPrice": "250000000",
"isError": "0",
"txreceipt_status": "1",
"input": "0x",
"contractAddress": "",
"cumulativeGasUsed": "0",
"gasUsed": "3809355",
"confirmations": "20100987",
"methodId": "0x",
"functionName": ""
}
]
}
Get a list of 'Internal' Transactions by Address
Returns the list of internal transactions performed by an address, with optional pagination.
https://api-era.zksync.network/api
?module=account
&action=txlistinternal
&address=0x05411bCC63167a82057Be42bC1b7022C12c99Aa4
&startblock=0
&endblock=latest
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK-Missing/Invalid API Key, rate limit of 1/3sec applied",
"result": [
{
"blockNumber": "2907968",
"timeStamp": "1683365990",
"hash": "0x2747a16507c1a5687f23431997bbdd2bb2be0cfa6e3c3d02fe121ffa0ad2bede",
"from": "0xb7b4b06b70beffd354e21d690b4b67522d385e50",
"to": "0x05411bcc63167a82057be42bc1b7022c12c99aa4",
"value": "129370910000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "2073582",
"gasUsed": "222",
"traceId": "0_1_1_1",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "3001547",
"timeStamp": "1683522769",
"hash": "0x5820794e2ea7644227fb3c4adf966b503f0f7c3abba5b8879665ad56056fd851",
"from": "0x0b6bdbcdc34a87f9dbba49d6c91470fad6001a5e",
"to": "0x05411bcc63167a82057be42bc1b7022c12c99aa4",
"value": "129311000000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "3003840",
"gasUsed": "222",
"traceId": "0_1_1_1",
"isError": "0",
"errCode": ""
}
]
}
Get 'Internal Transactions' by Transaction Hash
Returns the list of internal transactions performed within a transaction.
https://api-era.zksync.network/api
?module=account
&action=txlistinternal
&txhash=0x7d4cbab1061fe8c75e9af2379ac8d97d58d09da33b774fd75b3be6e38567aa1c
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK-Missing/Invalid API Key, rate limit of 1/3sec applied",
"result": [
{
"blockNumber": "23008944",
"timeStamp": "1704170301",
"from": "0x05411bcc63167a82057be42bc1b7022c12c99aa4",
"to": "0x0000000000000000000000000000000000008001",
"value": "240000000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "453789",
"gasUsed": "23",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "23008944",
"timeStamp": "1704170301",
"from": "0x05411bcc63167a82057be42bc1b7022c12c99aa4",
"to": "0x05a04cc23438e6946467af32a7be8982b5800960",
"value": "8177590000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "388332",
"gasUsed": "114",
"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-era.zksync.network/api
?module=account
&action=txlistinternal
&startblock=13481773
&endblock=13491773
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK-Missing/Invalid API Key, rate limit of 1/3sec applied",
"result": [
{
"blockNumber": "13481773",
"timeStamp": "1694335703",
"hash": "0xd6a6311ea3dc0bbe63f019e33124b8325b43afa04a355f20bcf11607879e4983",
"from": "0xaea43a02b42ca0660caa4e27bd13c1beff0f17cf",
"to": "0x0000000000000000000000000000000000008001",
"value": "94747000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "231966",
"gasUsed": "23",
"traceId": "0_1_1_1",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "13481773",
"timeStamp": "1694335703",
"hash": "0xfbb10475c8aa6aa34087ec1ca1cd994a5897aab0ec854829ffacdffc1230671d",
"from": "0xf66519bf5653644ee4936b68ea711b95efbafc36",
"to": "0x0000000000000000000000000000000000008001",
"value": "115376500000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "310653",
"gasUsed": "23",
"traceId": "0_1_1_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-era.zksync.network/api
?module=account
&action=tokentx
&contractaddress=0x3355df6D4c9C3035724Fd0e3914dE96A5a83aaf4
&address=0x6b6314f4f07c974600d872182dcDE092C480e57b
&page=1
&offset=2
&startblock=0
&endblock=latest
&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-Missing/Invalid API Key, rate limit of 1/3sec applied",
"result": [
{
"blockNumber": "8259106",
"timeStamp": "1689015114",
"hash": "0x3bead06faf1d8b44d36b9f9ad639841f9dc9f8f9beff804fb2f52528ea2a4910",
"nonce": "85331",
"blockHash": "0x9803b887f687e62de2428be59827c870a0306d696fe64ba42090f8e15af1dc7c",
"from": "0xe19105463d6fe2f2bd86c69ad478f4b76ce49c53",
"contractAddress": "0x3355df6d4c9c3035724fd0e3914de96a5a83aaf4",
"to": "0x6b6314f4f07c974600d872182dcde092c480e57b",
"value": "10737166679771",
"tokenName": "USD Coin",
"tokenSymbol": "USDC",
"tokenDecimal": "6",
"transactionIndex": "1",
"gas": "1000000",
"gasPrice": "250000000",
"gasUsed": "474279",
"cumulativeGasUsed": "0",
"input": "deprecated",
"confirmations": "14750836"
}
]
}
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-era.zksync.network/api
?module=account
&action=tokennfttx
&contractaddress=0xAAC3bf152cA2fF806697780c2403F5E0D0321aE0
&address=0x3179C539619b8878d1fe07Cf7893A28f405B0cd0
&page=1
&offset=2
&startblock=0
&endblock=latest
&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-Missing/Invalid API Key, rate limit of 1/3sec applied",
"result": [
{
"blockNumber": "15223520",
"timeStamp": "1696119701",
"hash": "0xa2829e78cb38694e0b7175fef02982c5ffd6f7a5d6aae42dff3d8653d99657d0",
"nonce": "1",
"blockHash": "0xf1e340e1f76998adf3bf2bdc7ecb3eb57c7a4168273a8a0a8c3c3a82718349cc",
"from": "0x0000000000000000000000000000000000000000",
"contractAddress": "0xaac3bf152ca2ff806697780c2403f5e0d0321ae0",
"to": "0x3179c539619b8878d1fe07cf7893a28f405b0cd0",
"tokenID": "517",
"tokenName": "True LayerZero Lover",
"tokenSymbol": "LZL",
"tokenDecimal": "0",
"transactionIndex": "0",
"gas": "3240007",
"gasPrice": "250000000",
"gasUsed": "1372357",
"cumulativeGasUsed": "0",
"input": "deprecated",
"confirmations": "7786702"
},
{
"blockNumber": "15223520",
"timeStamp": "1696119701",
"hash": "0xa2829e78cb38694e0b7175fef02982c5ffd6f7a5d6aae42dff3d8653d99657d0",
"nonce": "1",
"blockHash": "0xf1e340e1f76998adf3bf2bdc7ecb3eb57c7a4168273a8a0a8c3c3a82718349cc",
"from": "0x0000000000000000000000000000000000000000",
"contractAddress": "0xaac3bf152ca2ff806697780c2403f5e0d0321ae0",
"to": "0x3179c539619b8878d1fe07cf7893a28f405b0cd0",
"tokenID": "518",
"tokenName": "True LayerZero Lover",
"tokenSymbol": "LZL",
"tokenDecimal": "0",
"transactionIndex": "0",
"gas": "3240007",
"gasPrice": "250000000",
"gasUsed": "1372357",
"cumulativeGasUsed": "0",
"input": "deprecated",
"confirmations": "7786702"
}
]
}
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-era.zksync.network/api
?module=account
&action=token1155tx
&contractaddress=0xFcFDd186534Bf7d4Aef35d5b3bdE9E59E0C388c0
&address=0xa9324371Ef328De0e22A157A652Bd41E2a17d03f
&page=1
&offset=2
&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": "22787568",
"timeStamp": "1703939871",
"hash": "0xf67caf10875094aff2ebb8bf290249578d30afc9a666d4155995ceaf5d370c43",
"nonce": "61500",
"blockHash": "0x571d6bd7d64a66efab833f336e26263c35f1faeefc16218c3f4e7a9519444176",
"transactionIndex": "20",
"gas": "10000000",
"gasPrice": "150000000",
"gasUsed": "1156015",
"cumulativeGasUsed": "0",
"input": "deprecated",
"contractAddress": "0xfcfdd186534bf7d4aef35d5b3bde9e59e0c388c0",
"from": "0x0000000000000000000000000000000000000000",
"to": "0xa9324371ef328de0e22a157a652bd41e2a17d03f",
"tokenID": "52",
"tokenValue": "1",
"tokenName": "Forever Pudgy Penguin Traits",
"tokenSymbol": "TRAITS",
"confirmations": "222828"
},
{
"blockNumber": "22787568",
"timeStamp": "1703939871",
"hash": "0xf67caf10875094aff2ebb8bf290249578d30afc9a666d4155995ceaf5d370c43",
"nonce": "61500",
"blockHash": "0x571d6bd7d64a66efab833f336e26263c35f1faeefc16218c3f4e7a9519444176",
"transactionIndex": "20",
"gas": "10000000",
"gasPrice": "150000000",
"gasUsed": "1156015",
"cumulativeGasUsed": "0",
"input": "deprecated",
"contractAddress": "0xfcfdd186534bf7d4aef35d5b3bde9e59e0c388c0",
"from": "0x0000000000000000000000000000000000000000",
"to": "0xa9324371ef328de0e22a157a652bd41e2a17d03f",
"tokenID": "64",
"tokenValue": "1",
"tokenName": "Forever Pudgy Penguin Traits",
"tokenSymbol": "TRAITS",
"confirmations": "222828"
}
]
}