Get ETH Balance for a Single Address
Returns the ETH balance of a given address.
https://api-cardona-zkevm.polygonscan.com/api
?module=account
&action=balance
&address=0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582
&apikey=YourApiKeyToken
Try this endpoint in your browser
Sample response
{
"status":"1",
"message":"OK",
"result":"199999869533099999999999998"
}
Get ETH Balance for Multiple Addresses in a Single Call
Returns the balance of the accounts from a list of addresses.
https://api-cardona-zkevm.polygonscan.com/api
?module=account
&action=balancemulti
&address=0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582,0xff6250d0E86A2465B0C1bF8e36409503d6a26963,0x54d03EC0C462e9a01F77579C090cdE0FC2617817
&tag=latest
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"account": "0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582",
"balance": "199999869533099999999999998"
},
{
"account": "0xff6250d0E86A2465B0C1bF8e36409503d6a26963",
"balance": "99963481320560338585964"
},
{
"account": "0x54d03EC0C462e9a01F77579C090cdE0FC2617817",
"balance": "128461806250000000000"
}
]
}
Get a list of 'Normal' Transactions By Address
Returns the list of transactions performed by an address, with optional pagination.
https://api-cardona-zkevm.polygonscan.com/api
?module=account
&action=txlist
&address=0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "0",
"timeStamp": "1636333200",
"hash": "GENESIS_528e26b25a34a4A5d0dbDa1d57D318153d2ED582",
"nonce": "",
"blockHash": "",
"transactionIndex": "0",
"from": "GENESIS",
"to": "",
"value": "200000000000000000000000000",
"gas": "0",
"gasPrice": "0",
"isError": "0",
"txreceipt_status": "1",
"input": "0x60806040526004361061005e5760003560e01c80635c60da1b116100435780635c60da1b146100a85780638f283970146100e6578063f851a440146101065761006d565b80633659cfe6146100755780634f1ef286146100955761006d565b3661006d5761006b61011b565b005b61006b61011b565b34801561008157600080fd5b5061006b61009036600461088b565b610135565b61006b6100a33660046108a6565b61017f565b3480156100b457600080fd5b506100bd6101f3565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b3480156100f257600080fd5b5061006b61010136600461088b565b610231565b34801561011257600080fd5b506100bd61025e565b6101236102d4565b61013361012e6103ab565b6103b5565b565b61013d6103d9565b73ffffffffffffffffffffffffffffffffffffffff1633036101775761017481604051806020016040528060008152506000610419565b50565b61017461011b565b6101876103d9565b73ffffffffffffffffffffffffffffffffffffffff1633036101eb576101e68383838080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525060019250610419915050565b505050565b6101e661011b565b60006101fd6103d9565b73ffffffffffffffffffffffffffffffffffffffff163303610226576102216103ab565b905090565b61022e61011b565b90565b6102396103d9565b73ffffffffffffffffffffffffffffffffffffffff1633036101775761017481610444565b60006102686103d9565b73ffffffffffffffffffffffffffffffffffffffff163303610226576102216103d9565b60606102b183836040518060600160405280602781526020016109bb602791396104a5565b9392505050565b73ffffffffffffffffffffffffffffffffffffffff163b151590565b6102dc6103d9565b73ffffffffffffffffffffffffffffffffffffffff163303610133576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f7879207461726760648201527f6574000000000000000000000000000000000000000000000000000000000000608482015260a4015b60405180910390fd5b600061022161052a565b3660008037600080366000845af43d6000803e8080156103d4573d6000f35b3d6000fd5b60007fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b5473ffffffffffffffffffffffffffffffffffffffff16919050565b61042283610552565b60008251118061042f5750805b156101e65761043e838361028c565b50505050565b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f61046d6103d9565b6040805173ffffffffffffffffffffffffffffffffffffffff928316815291841660208301520160405180910390a16101748161059f565b60606000808573ffffffffffffffffffffffffffffffffffffffff16856040516104cf919061094d565b600060405180830381855af49150503d806000811461050a576040519150601f19603f3d011682016040523d82523d6000602084013e61050f565b606091505b5091509150610520868383876106ab565b9695505050505050565b60007f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc6103fd565b61055b81610753565b60405173ffffffffffffffffffffffffffffffffffffffff8216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b73ffffffffffffffffffffffffffffffffffffffff8116610642576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f455243313936373a206e65772061646d696e20697320746865207a65726f206160448201527f646472657373000000000000000000000000000000000000000000000000000060648201526084016103a2565b807fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b80547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff9290921691909117905550565b6060831561074157825160000361073a5773ffffffffffffffffffffffffffffffffffffffff85163b61073a576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e747261637400000060448201526064016103a2565b508161074b565b61074b838361081e565b949350505050565b73ffffffffffffffffffffffffffffffffffffffff81163b6107f7576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201527f6f74206120636f6e74726163740000000000000000000000000000000000000060648201526084016103a2565b807f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc610665565b81511561082e5781518083602001fd5b806040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016103a29190610969565b803573ffffffffffffffffffffffffffffffffffffffff8116811461088657600080fd5b919050565b60006020828403121561089d57600080fd5b6102b182610862565b6000806000604084860312156108bb57600080fd5b6108c484610862565b9250602084013567ffffffffffffffff808211156108e157600080fd5b818601915086601f8301126108f557600080fd5b81358181111561090457600080fd5b87602082850101111561091657600080fd5b6020830194508093505050509250925092565b60005b8381101561094457818101518382015260200161092c565b50506000910152565b6000825161095f818460208701610929565b9190910192915050565b6020815260008251806020840152610988816040850160208701610929565b601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a2646970667358221220a1af0d6cb4f1e31496a4c5c1448913bce4bd6ad3a39e47c6f7190c114d6f9bf464736f6c63430008110033",
"contractAddress": "0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582",
"cumulativeGasUsed": "0",
"gasUsed": "0",
"confirmations": "39021",
"methodId": "0x60806040",
"functionName": ""
},
{
"blockNumber": "2556",
"timeStamp": "1702504784",
"hash": "0x862b1e21233da4b15823739accdda442f2d55ee27a24ff02ec5794e7d5f6987f",
"nonce": "0",
"blockHash": "0x73152fc845c75e18cd863555a2ecaea5ba1a3fae3b74aabd9d3cc784cb60b822",
"transactionIndex": "0",
"from": "0xeabcc441d0d3f6e8e76a4078f07f3581390d1b55",
"to": "0x528e26b25a34a4a5d0dbda1d57d318153d2ed582",
"value": "0",
"gas": "138251",
"gasPrice": "60300000000",
"isError": "0",
"txreceipt_status": "1",
"input": "0x2cffd02e0000000000000000000000000000000000000000000000000000000000000000ad3228b676f7d3cd4284a5443f17f1962b36e491b30a40b2405849e597ba5fb5b4c11951957c6f8f642c4af61cd6b24640fec6dc7fc607ee8206a99e92410d3021ddb9a356815c3fac1026b6dec5df3124afbadb485c9ba5a3e3398a04b7ba85e58769b32a1beaf1ea27375a44095a0d1fb664ce2dd358e7fcbfb78c26a193440eb01ebfc9ed27500cd4dfc979272d1f0913cc9f66540d7e8005811109e1cf2d887c22bd8750d34016ac3c66b5ff102dacdd73f6b014e710b51e8022af9a1968ffd70157e48063fc33c97a050f7f640233bf646cc98d9524c6b92bcf3ab56f839867cc5f7f196b93bae1e27e6320742445d290f2263827498b54fec539f756afcefad4e508c098b9a7e1d8feb19955fb02ba9675585078710969d3440f5054e0f9dc3e7fe016e050eff260334f18a5d4fe391d82092319f5964f2e2eb7c1c3a5f8b13a49e282f609c317a833fb8d976d11517c571d1221a265d25af778ecf8923490c6ceeb450aecdc82e28293031d10c7d73bf85e57bf041a97360aa2c5d99cc1df82d9c4b87413eae2ef048f94b4d3554cea73d92b0f7af96e0271c691e2bb5c67add7c6caf302256adedf7ab114da0acfe870d449a3a489f781d659e8beccda7bce9f4e8618b6bd2f4132ce798cdc7a60e7e1460a7299e3c6342a579626d22733e50f526ec2fa19a22b31e8ed50f23cd1fdf94c9154ed3a7609a2f1ff981fe1d3b5c807b281e4683cc6d6315cf95b9ade8641defcb32372f1c126e398ef7a5a2dce0a8a7f68bb74560f8f71837c2c2ebbcbf7fffb42ae1896f13f7c7479a0b46a28b6f55540f89444f63de0378e3d121be09e06cc9ded1c20e65876d36aa0c65e9645644786b620e2dd2ad648ddfcbf4a7e5b1a3a4ecfe7f64667a3f0b7e2f4418588ed35a2458cffeb39b93d26f18d2ab13bdce6aee58e7b99359ec2dfd95a9c16dc00d6ef18b7933a6f8dc65ccb55667138776f7dea101070dc8796e3774df84f40ae0c8229d0d6069e5c8f39a7c299677a09d367fc7b05e3bc380ee652cdc72595f74c7b1043d0e1ffbab734648c838dfb0527d971b602bc216c9619ef0abf5ac974a1ed57f4050aa510dd9c74f508277b39d7973bb2dfccc5eeb0618db8cd74046ff337f0a7bf2c8e03e10f642c1886798d71806ab1e888d9e5ee87d0838c5655cb21c6cb83313b5a631175dff4963772cce9108188b34ac87c81c41e662ee4dd2dd7b2bc707961b1e646c4047669dcb6584f0d8d770daf5d7e7deb2e388ab20e2573d171a88108e79d820e98f26c0b84aa8b2f4aa4968dbb818ea32293237c50ba75ee485f4c22adf2f741400bdf8d6a9cc7df7ecae576221665d7358448818bb4ae4562849e949e17ac16e0be16688e156b5cf15e098c627c0056a90000000000000000000000000000000000000000000000000000000000000000112b077c64ed4a22dfb0ab3c2622d6ddbf3a5423afeb05878c2c21c4cb5e65da0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000b48ca794d49eec406a5dd2c547717e37b5952a8300000000000000000000000000000000000000000000000003782dace9d9000000000000000000000000000000000000000000000000000000000000000005200000000000000000000000000000000000000000000000000000000000000000",
"contractAddress": "",
"cumulativeGasUsed": "134606",
"gasUsed": "134606",
"confirmations": "36465",
"methodId": "0x2cffd02e",
"functionName": ""
}
]
}
Get a list of 'Internal' Transactions by Address
Returns the list of internal transactions performed by an address, with optional pagination.
https://api-cardona-zkevm.polygonscan.com/api
?module=account
&action=txlistinternal
&address=0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582
&startblock=0
&endblock=99999999
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "2556",
"timeStamp": "1702504784",
"hash": "0x862b1e21233da4b15823739accdda442f2d55ee27a24ff02ec5794e7d5f6987f",
"from": "0x528e26b25a34a4a5d0dbda1d57d318153d2ed582",
"to": "0x8bd36ca1a55e389335004872aa3c3be0969d3aa7",
"value": "0",
"contractAddress": "",
"input": "",
"type": "delegatecall",
"gas": "90342",
"gasUsed": "88092",
"traceId": "0_1",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "2556",
"timeStamp": "1702504784",
"hash": "0x862b1e21233da4b15823739accdda442f2d55ee27a24ff02ec5794e7d5f6987f",
"from": "0x528e26b25a34a4a5d0dbda1d57d318153d2ed582",
"to": "0xa40d5f56745a118d0906a34e69aec8c0db1cb8fa",
"value": "0",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "60806",
"gasUsed": "9590",
"traceId": "0_1_1",
"isError": "0",
"errCode": ""
}
]
}
Get 'Internal Transactions' by Transaction Hash
Returns the list of internal transactions performed within a transaction.
https://api-cardona-zkevm.polygonscan.com/api
?module=account
&action=txlistinternal
&txhash=0x7a7734512805478150634fe0a208ce9b161a77665cda48320f274a8a4b3b0cbd
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "39015",
"timeStamp": "1705027055",
"from": "0x528e26b25a34a4a5d0dbda1d57d318153d2ed582",
"to": "0x9af3049dd15616fd627a35563b5282bea5c32e20",
"value": "100000000000000",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "7446",
"gasUsed": "0",
"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-cardona-zkevm.polygonscan.com/api
?module=account
&action=txlistinternal
&startblock=39000
&endblock=latest
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "39002",
"timeStamp": "1705026283",
"hash": "0x00d3c13add997314fd032daa4f2b291a041b4928c999886ee5efd1998314a460",
"from": "0x528e26b25a34a4a5d0dbda1d57d318153d2ed582",
"to": "0x8bd36ca1a55e389335004872aa3c3be0969d3aa7",
"value": "0",
"contractAddress": "",
"input": "",
"type": "delegatecall",
"gas": "52985",
"gasUsed": "46062",
"traceId": "0_1",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "39002",
"timeStamp": "1705026283",
"hash": "0x00d3c13add997314fd032daa4f2b291a041b4928c999886ee5efd1998314a460",
"from": "0x528e26b25a34a4a5d0dbda1d57d318153d2ed582",
"to": "0xa40d5f56745a118d0906a34e69aec8c0db1cb8fa",
"value": "0",
"contractAddress": "",
"input": "",
"type": "call",
"gas": "40866",
"gasUsed": "9590",
"traceId": "0_1_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-cardona-zkevm.polygonscan.com/api
?module=account
&action=tokentx
&contractaddress=0xc91e39268281653eBeDb27afeBb6AD9c6b33B147
&address=0xaBB37caA3411699C9E8A83906611b5c61b304196
&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": "2678",
"timeStamp": "1702563784",
"hash": "0x6d6a3e77b56ef40c5120404a0856901a79a5ab68d0bf34be1a771966870f616e",
"nonce": "37",
"blockHash": "0xd716b43a929683bc91d24331890017f18c306300709353a1a993fc2447628f53",
"from": "0xabb37caa3411699c9e8a83906611b5c61b304196",
"contractAddress": "0xc91e39268281653ebedb27afebb6ad9c6b33b147",
"to": "0xff6250d0e86a2465b0c1bf8e36409503d6a26963",
"value": "801795320536136",
"tokenName": "BenchToken",
"tokenSymbol": "BTK",
"tokenDecimal": "18",
"transactionIndex": "0",
"gas": "60000",
"gasPrice": "36300000000",
"gasUsed": "52451",
"cumulativeGasUsed": "52451",
"input": "deprecated",
"confirmations": "36351"
}
]
}
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-cardona-zkevm.polygonscan.com/api
?module=account
&action=tokennfttx
&contractaddress=0xd6f9e7defa52ac67cdfd6a9a352ce6e0a9684b0a
&address=0xbb282ced765a2a2573747f04101cabd2adab8f45
&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":"18597440",
"timeStamp":"1630960097",
"hash":"0x0391b0b66457b45f77b0107ab0f96f82a76e3089da86fc1f560817f1f2d67a2b",
"nonce":"0",
"blockHash":"0x2dcc4c772282d504e4da64046e3bfacfb17092558cb6422f73890acb1690c96d",
"from":"0x9ea7783b3e45213e0da1e9fe7bca3b7362f052b1",
"contractAddress":"0xd6f9e7defa52ac67cdfd6a9a352ce6e0a9684b0a",
"to":"0xbb282ced765a2a2573747f04101cabd2adab8f45",
"tokenID":"374",
"tokenName":"MoonieNFT",
"tokenSymbol":"MOONIE",
"tokenDecimal":"0",
"transactionIndex":"2",
"gas":"0",
"gasPrice":"0",
"gasUsed":"0",
"cumulativeGasUsed":"0",
"input":"deprecated",
"confirmations":"1577636"
},
{
"blockNumber":"18597440",
"timeStamp":"1630960097",
"hash":"0x0391b0b66457b45f77b0107ab0f96f82a76e3089da86fc1f560817f1f2d67a2b",
"nonce":"0",
"blockHash":"0x2dcc4c772282d504e4da64046e3bfacfb17092558cb6422f73890acb1690c96d",
"from":"0x9ea7783b3e45213e0da1e9fe7bca3b7362f052b1",
"contractAddress":"0xd6f9e7defa52ac67cdfd6a9a352ce6e0a9684b0a",
"to":"0xbb282ced765a2a2573747f04101cabd2adab8f45",
"tokenID":"455",
"tokenName":"MoonieNFT",
"tokenSymbol":"MOONIE",
"tokenDecimal":"0",
"transactionIndex":"2",
"gas":"0",
"gasPrice":"0",
"gasUsed":"0",
"cumulativeGasUsed":"0",
"input":"deprecated",
"confirmations":"1577636"
}
]
}
Get list of Blocks Validated by Address
Returns the list of blocks validated by an address.
https://api-cardona-zkevm.polygonscan.com/api
?module=account
&action=getminedblocks
&address=0xc26880a0af2ea0c7e8130e6ec47af756465452e8
&blocktype=blocks
&page=1
&offset=10
&apikey=YourApiKeyToken
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"20175095",
"timeStamp":"1634227443",
"blockReward":"3917894000000000"
},
{
"blockNumber":"20175094",
"timeStamp":"1634227441",
"blockReward":"1111176000000000"
},
{
"blockNumber":"20175093",
"timeStamp":"1634227439",
"blockReward":"1830072000000000"
}
]
}