Get Ether Balance for a Single Address
Returns the Ether balance of a given address.
Copy https://api-era.zksync.network/api
?module=account
&action=balance
&address=0x65E3A21f956784f8ca157B640417ecB5FfB4E1fa
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Request Response
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
Copy {
"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.
Copy https://api-era.zksync.network/api
?module=account
&action=balancemulti
&address=0x05411bCC63167a82057Be42bC1b7022C12c99Aa4,0x0D0707963952f2fBA59dD06f2b425ace40b492Fe,0x0D0707963952f2fBA59dD06f2b425ace40b492Fe
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Request Response
Query Parameters
Parameter Description the strings
representing the addresses to check for balance, separated by ,
up to 20 addresses per call
the integer
pre-defined block parameter, either earliest
, pending
or latest
Sample Response
Copy {
"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.
📝 Note : This API endpoint returns a maximum of 10000 records only.
Copy https://api-era.zksync.network/api
?module=account
&action=txlist
&address=0x05411bCC63167a82057Be42bC1b7022C12c99Aa4
&startblock=0
&endblock=99999999
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Request Response
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 descendin Tip: Specify a smaller startblock
and endblock
range for faster search results.
Sample Response
Copy {
"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.
📝 Note : This API endpoint returns a maximum of 10000 records only.
Copy https://api-era.zksync.network/api
?module=account
&action=txlistinternal
&address=0x05411bCC63167a82057Be42bC1b7022C12c99Aa4
&startblock=0
&endblock=latest
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Request Response
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
Copy {
"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.
📝 Note : This API endpoint returns a maximum of 10000 records only.
Copy https://api-era.zksync.network/api
?module=account
&action=txlistinternal
&txhash=0x7d4cbab1061fe8c75e9af2379ac8d97d58d09da33b774fd75b3be6e38567aa1c
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Request Response
Query Parameters
Parameter Description the string
representing the transaction hash to check for internal transactions
Sample Response
Copy {
"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.
📝 Note : This API endpoint returns a maximum of 10000 records only.
Copy https://api-era.zksync.network/api
?module=account
&action=txlistinternal
&startblock=13481773
&endblock=13491773
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Request Response
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
Copy {
"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.
Copy 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.
Try this endpoint in your browser 🔗
Request Response
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
Copy {
"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.
Copy 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.
Try this endpoint in your browser 🔗
Request Response
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
Copy {
"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.
Copy 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.
Try this endpoint in your browser 🔗
Request Response
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
Copy {
"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"
}
]
}
Last updated 8 months ago