Get Ether Balance for a Single Address
Returns the Ether balance of a given address.
https://api-sepolia-era.zksync.network/api
?module=account
&action=balance
&address=0x834Dbf5A03e29c25bc55459cCe9c021EeBE676Ad
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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
{
"status":"1",
"message":"OK",
"result":"488999586584640000000"
}
Get Ether Balance for Multiple Addresses in a Single Call
Returns the balance of the accounts from a list of addresses.
https://api-sepolia-era.zksync.network/api
?module=account
&action=balancemulti
&address=0x4eAF936c172b5e5511959167e8Ab4f7031113Ca3,0x834Dbf5A03e29c25bc55459cCe9c021EeBE676Ad,0xc2F695613de0885dA3bdd18E8c317B9fAf7d4eba
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the strings representing the addresses to check for balance, separated by , commas
up to 20 addresses per call |
| the integer pre-defined block parameter, either earliest , pending or latest |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"account": "0x4eAF936c172b5e5511959167e8Ab4f7031113Ca3",
"balance": "534907224695830030954"
},
{
"account": "0x834Dbf5A03e29c25bc55459cCe9c021EeBE676Ad",
"balance": "488999586584640000000"
},
{
"account": "0xc2F695613de0885dA3bdd18E8c317B9fAf7d4eba",
"balance": "473101193863076021625"
}
]
}
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.
https://api-sepolia-era.zksync.network/api
?module=account
&action=txlist
&address=0x834Dbf5A03e29c25bc55459cCe9c021EeBE676Ad
&startblock=0
&endblock=lateset
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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
{
"status": "1",
"message": "OK-Missing/Invalid API Key, rate limit of 1/3sec applied",
"result": [
{
"blockNumber": "5196",
"timeStamp": "1702152867",
"hash": "0xa3d165ec36c003b92bbae91253069730da0d8e3297974844284a8bdaa28bc15c",
"nonce": "1",
"blockHash": "0xd2fd572c1e5b9a32abe4796581fe0ad5e4861797b0cccfd979b9ca1e8d59f792",
"transactionIndex": "0",
"from": "0xd65ddbf9c8099bc9bf611139326b044fc83e18cc",
"to": "0x834dbf5a03e29c25bc55459cce9c021eebe676ad",
"value": "999000000000000000000",
"gas": "481023",
"gasPrice": "250000000",
"isError": "0",
"txreceipt_status": "1",
"input": "0x",
"contractAddress": "",
"cumulativeGasUsed": "0",
"gasUsed": "141662",
"confirmations": "250710",
"methodId": "0x",
"functionName": ""
},
{
"blockNumber": "6949",
"timeStamp": "1702349513",
"hash": "0x9e7df5d96f831592ae093d51864a48933bf5b49b3d102acb90155e3a50e7eacb",
"nonce": "0",
"blockHash": "0x7ec1acbe9476ac89019b9c82d85159498f6df3408b51f9fc095ee64013a59934",
"transactionIndex": "0",
"from": "0x834dbf5a03e29c25bc55459cce9c021eebe676ad",
"to": "0xf92c7d42399eee88fbcf6e7c005aeba4d6d58b7d",
"value": "10000000000000000000",
"gas": "2698552",
"gasPrice": "230000000",
"isError": "0",
"txreceipt_status": "1",
"input": "0x",
"contractAddress": "",
"cumulativeGasUsed": "0",
"gasUsed": "1407699",
"confirmations": "248957",
"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.
https://api-sepolia-era.zksync.network/api
?module=account
&action=txlistinternal
&address=0x4eaf936c172b5e5511959167e8ab4f7031113ca3
&startblock=0
&endblock=latest
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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
{
"status": "1",
"message": "OK-Missing/Invalid API Key, rate limit of 1/3sec applied",
"result": [
{
"blockNumber": "12943",
"timeStamp": "1702889146",
"hash": "0x9d310aaf92ab0ad72c189cc8182784a48429ccf242776050d6cd458d6bf81d64",
"from": "0x1ed29c10e661e5721dfe162845f72548f090d8e7",
"to": "0x4eaf936c172b5e5511959167e8ab4f7031113ca3",
"value": "99992559677624598395",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "2170476",
"gasUsed": "114",
"traceId": "0_1_1_1_1",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "12952",
"timeStamp": "1702889749",
"hash": "0xb3ba779d59c144650975cf89b8dd57982f28b1c322db27701ee4ec0fadb4f7ba",
"from": "0x4eaf936c172b5e5511959167e8ab4f7031113ca3",
"to": "0x0000000000000000000000000000000000008001",
"value": "5424272160000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "2062809",
"gasUsed": "23",
"traceId": "0_1_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.
https://api-sepolia-era.zksync.network/api
?module=account
&action=txlistinternal
&txhash=0xb62d691159ab89062bec184745dc1bb754dd1f3e83dc9236f89016459506bdd3
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
Parameter | Description |
---|
| the string representing the transaction hash to check for internal transactions |
Sample Response
{
"status": "1",
"message": "OK-Missing/Invalid API Key, rate limit of 1/3sec applied",
"result": [
{
"blockNumber": "253907",
"timeStamp": "1706561274",
"from": "0x4eaf936c172b5e5511959167e8ab4f7031113ca3",
"to": "0x0000000000000000000000000000000000008001",
"value": "48514600000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "355068",
"gasUsed": "23",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "253907",
"timeStamp": "1706561274",
"from": "0x4eaf936c172b5e5511959167e8ab4f7031113ca3",
"to": "0x707c85d353f5b17669b99dd996a304c33540b2f3",
"value": "950000000000000010",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "277263",
"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.
https://api-sepolia-era.zksync.network/api
?module=account
&action=txlistinternal
&startblock=0
&endblock=765371
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
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
{
"status": "1",
"message": "OK-Missing/Invalid API Key, rate limit of 1/3sec applied",
"result": [
{
"blockNumber": "253907",
"timeStamp": "1706561274",
"from": "0x4eaf936c172b5e5511959167e8ab4f7031113ca3",
"to": "0x0000000000000000000000000000000000008001",
"value": "48514600000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "355068",
"gasUsed": "23",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "253907",
"timeStamp": "1706561274",
"from": "0x4eaf936c172b5e5511959167e8ab4f7031113ca3",
"to": "0x707c85d353f5b17669b99dd996a304c33540b2f3",
"value": "950000000000000010",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "277263",
"gasUsed": "114",
"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-sepolia-era.zksync.network/api
?module=account
&action=tokentx
&contractaddress=0x000000000000000000000000000000000000800A
&address=0x56DDd604011c5F8629bd7C2472E3504Bd32c269b
&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 🔗
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
{
"status": "1",
"message": "OK-Missing/Invalid API Key, rate limit of 1/3sec applied",
"result": [
{
"blockNumber": "253907",
"timeStamp": "1706561274",
"from": "0x4eaf936c172b5e5511959167e8ab4f7031113ca3",
"to": "0x0000000000000000000000000000000000008001",
"value": "48514600000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "355068",
"gasUsed": "23",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "253907",
"timeStamp": "1706561274",
"from": "0x4eaf936c172b5e5511959167e8ab4f7031113ca3",
"to": "0x707c85d353f5b17669b99dd996a304c33540b2f3",
"value": "950000000000000010",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "277263",
"gasUsed": "114",
"isError": "0",
"errCode": ""
}
]
}
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-sepolia-era.zksync.network/api
?module=account
&action=tokennfttx
&contractaddress=0x05E9eaa6d32cad15E2922e54e750B59a6009F94a
&address=0x0e15cA210b4bad8093d44D9b99B2308a267396c0
&page=1
&offset=2
&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
and contract address
parameters.
Try this endpoint in your browser 🔗
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
{
"status": "1",
"message": "OK-Missing/Invalid API Key, rate limit of 1/3sec applied",
"result": [
{
"blockNumber": "229498",
"timeStamp": "1706320111",
"hash": "0xd00142c0490265220b64e474af36793e38e75904f8aad3f85fa43092a564c997",
"nonce": "1",
"blockHash": "0x164570ed90534867f0ed5148f305b425e257cad0812f3af8c6dc3a1d75332e58",
"from": "0x0000000000000000000000000000000000000000",
"contractAddress": "0x05e9eaa6d32cad15e2922e54e750b59a6009f94a",
"to": "0x0e15ca210b4bad8093d44d9b99b2308a267396c0",
"tokenID": "195",
"tokenName": "AI & Web3 Fund NFT",
"tokenSymbol": "AIWF",
"tokenDecimal": "0",
"transactionIndex": "0",
"gas": "1785354",
"gasPrice": "100000000",
"gasUsed": "610698",
"cumulativeGasUsed": "0",
"input": "deprecated",
"confirmations": "26462"
},
{
"blockNumber": "229601",
"timeStamp": "1706320999",
"hash": "0x7cd7cab1bf548ddded9dc1369ec284f3a01eaee3b7422943b789108b8d2b2857",
"nonce": "9",
"blockHash": "0x469a66e78c055c16a6b9da52b54f7e58fefcf2f17086ea575faa5e78936f15ef",
"from": "0x0000000000000000000000000000000000000000",
"contractAddress": "0x05e9eaa6d32cad15e2922e54e750b59a6009f94a",
"to": "0x0e15ca210b4bad8093d44d9b99b2308a267396c0",
"tokenID": "196",
"tokenName": "AI & Web3 Fund NFT",
"tokenSymbol": "AIWF",
"tokenDecimal": "0",
"transactionIndex": "0",
"gas": "1549252",
"gasPrice": "100000000",
"gasUsed": "553180",
"cumulativeGasUsed": "0",
"input": "deprecated",
"confirmations": "26359"
}
]
}
Last updated