For the full documentation of available parameters and descriptions, please visit the official Ethereum JSON-RPC docs.
eth_blockNumber
Returns the number of most recent block
https://api-cardona-zkevm.polygonscan.com/api
?module=proxy
&action=eth_blockNumber
&apikey=YourApiKeyToken
Try this endpoint in your browser π
Sample response
{
"jsonrpc":"2.0",
"id":83,
"result":"0x133dd79"
}
eth_getBlockByNumber
Returns information about a block by block number.
https://api-cardona-zkevm.polygonscan.com/api
?module=proxy
&action=eth_getBlockByNumber
&tag=AD08
&boolean=true
&apikey=YourApiKeyToken
Try this endpoint in your browser π
Query Parameters
Parameter | Description |
---|
| the block number, in hex eg. 0xC36B3C |
| the boolean value to show full transaction objects. when true , returns full transaction objects and their information, when false only returns a list of transactions. |
Sample response
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"parentHash": "0xeced0e5171ac2491602f17f3202461108109769af6bd771369c38217fd34360b",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"miner": "0x761d53b47334bee6612c0bd1467fb881435375b2",
"stateRoot": "0x9bbb6a54d5725a0f567e8d57a4a5dc62c760a86c6e1bf7413074a95c107aafb9",
"transactionsRoot": "0x9c5af0901960a0e75c60ee04cf483127c21ff46bc3b0b007ecaf3c57c0efe3b5",
"receiptsRoot": "0x4d73d458f824f6563db98a063e5769f185b0cd16c6ccd33de0eed7bab1b38da9",
"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"difficulty": "0x0",
"totalDifficulty": "0x0",
"size": "0x272",
"number": "0xad08",
"gasLimit": "0x1c9c380",
"gasUsed": "0x5208",
"timestamp": "0x65a60b1f",
"extraData": "0x",
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"nonce": "0x0000000000000000",
"hash": "0xd5c0a128506b3335721b7dda4a025b548fa12c3ad4a0ed6599359f58688ea29a",
"transactions": [
{
"nonce": "0x947c",
"gasPrice": "0x165a0bc000",
"gas": "0x5208",
"to": "0x417a7ba2d8d0060ae6c54fd098590db854b9c1d5",
"value": "0x9184e72a000",
"input": "0x",
"v": "0x1337",
"r": "0x73bd9bef0a6a7fa92d0575b0b6ef7cb37a7b929307447efa0cc8ac6873afa401",
"s": "0x210b12996c13151bff216dd7ade9da1572e9a334085b7b32b6db20a1cfa1b2e2",
"hash": "0x8eac90f1551878c5adb011cad7c453a432876e214ce828e2c8602b9b9a3aff9f",
"from": "0x9af3049dd15616fd627a35563b5282bea5c32e20",
"blockHash": "0xd5c0a128506b3335721b7dda4a025b548fa12c3ad4a0ed6599359f58688ea29a",
"blockNumber": "0xad08",
"transactionIndex": "0x0",
"chainId": "0x98a",
"type": "0x0"
}
],
"uncles": []
}
}
eth_getBlockTransactionCountByNumber
Returns the number of transactions in a block.
https://api-cardona-zkevm.polygonscan.com/api
?module=proxy
&action=eth_getBlockTransactionCountByNumber
&tag=AD08
&apikey=YourApiKeyToken
Try this endpoint in your browser π
Query Parameters
Parameter | Description |
---|
| the block number, in hex eg. 0x10FB78 |
Sample response
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1"
}
eth_getTransactionByHash
Returns information about a transaction requested by transaction hash.
https://api-cardona-zkevm.polygonscan.com/api
?module=proxy
&action=eth_getTransactionByHash
&txhash=0x0108074295ae6d5e1e5722775db31259c8acb807251cef8f27eb700be3dddb76
&apikey=YourApiKeyToken
Try this endpoint in your browser π
Query Parameters
Parameter | Description |
---|
| the string representing the hash of the transaction |
Sample Response
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"nonce": "0x947d",
"gasPrice": "0x7080f6e00",
"gas": "0x5208",
"to": "0x417a7ba2d8d0060ae6c54fd098590db854b9c1d5",
"value": "0x9184e72a000",
"input": "0x",
"v": "0x1337",
"r": "0x4667cddbe363535ab3967ac5e8640ce74842e932b508a2619660a60f782cc56d",
"s": "0x1a1d0e33d5f2aef35d9bdc2825e3ca91633c6c5541c51296c70833ff3a1c732",
"hash": "0x0108074295ae6d5e1e5722775db31259c8acb807251cef8f27eb700be3dddb76",
"from": "0x9af3049dd15616fd627a35563b5282bea5c32e20",
"blockHash": "0xac2c182462d26af66002d7b3f8abd00ac2d089bed3317f7d8cd73ae9194cc510",
"blockNumber": "0xad09",
"transactionIndex": "0x0",
"chainId": "0x98a",
"type": "0x0"
}
}
eth_getTransactionByBlockNumberAndIndex
Returns information about a transaction by block number and transaction index position.
https://api-cardona-zkevm.polygonscan.com/api
?module=proxy
&action=eth_getTransactionByBlockNumberAndIndex
&tag=0x12bad94
&index=0x1
&apikey=YourApiKeyToken
Try this endpoint in your browser π
Query Parameters
Parameter | Description |
---|
| the block number, in hex eg. 0x10FB78 |
| the position of the uncle's index in the block, in hex eg. 0x1 |
Sample Response
{
"jsonrpc":"2.0",
"id":1,
"result":{
"blockHash":"0xb74b93bfab74e594b00929f8d86f914061a1608a4fc270819dd661352bd08a31",
"blockNumber":"0x12bad94",
"from":"0xc0012c30a5f333bb5de24752cf82ce5d95d4c444",
"gas":"0x7a120",
"gasPrice":"0xee6b2800",
"hash":"0x2615b95113d5429eeec394cc4c2b0c54510f6c96852dfe3844ea8b35a5184326",
"input":"0xf91b6e68000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000002c000000000000000000000000000000000000000000000000000000000000000670000000000000000000000000000000099a9efc022ec11ec94a9fb49b166e18c000000000000000000000000f9997b4032635e18daebb0f7575b655742d5f2f00000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000149b5000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000017284f043d000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000020653335653962306263613032633934363461363732366432386132346536383800000000000000000000000000000000000000000000000000000000000000415d3fd9644c4232f6311ae09d9be80a60fd8061c8ac0ce6364815608e023456d851d8b9eeaaccd143a958f2cfbf6c2db7ebfce9430ff0dcde84fc3a78ff0621c11b00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000018000000000000000000000000000000000000000000000000000000000000001c0000000000000000000000000245c15bf2e2ab28e9dcc46210ea172c42dd1c00b000000000000000000000000475056af4d4e64a960b4ba10dacf6d5bd1d653d100000000000000000000000000000000000000000000000000000000000149b50000000000000000000000000000000000000000000000000000000005073a5c00000000000000000000000000000000000000000000000000000000000148e3000000000000000000000000000000000000000000000000000000000504028800000000000000000000000000000000000000000000000000000000000000a8000000000000000000000000000000000000000000000000000000000000002a000000000000000000000000000000000000000000000000000000000000dac00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000344494c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000035553440000000000000000000000000000000000000000000000000000000000",
"nonce":"0x147b",
"to":"0x86c6a85e3772b7e2bc04495d6732754555d685f7",
"transactionIndex":"0x1",
"value":"0x0",
"type":"0x0",
"v":"0x27125",
"r":"0x6689c4c92865d464b64fe7402ee71f4773bcb1c5a01f58f8776e19f773155d3e",
"s":"0x339f2d6b60a6047fd23dda57fe9475042698ac27b89f2d1862215ec0ff14bde8"
}
}
eth_getTransactionCount
Returns the number of transactions performed by an address.
https://api-cardona-zkevm.polygonscan.com/api
?module=proxy
&action=eth_getTransactionCount
&address=0x9AF3049dD15616Fd627A35563B5282bEA5C32E20
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser π
Query Parameters
Parameter | Description |
---|
| the string representing the address to get transaction count |
| the string pre-defined block parameter, either earliest , pending or latest |
Sample Response
{
"jsonrpc":"2.0",
"id":1,
"result":"0x9480"
}
eth_sendRawTransaction
Submits a pre-signed transaction for broadcast to the Polygon zkEVMChain network.
https://api-cardona-zkevm.polygonscan.com/api
?module=proxy
&action=eth_sendRawTransaction
&hex=0xf904808000831cfde080
&apikey=YourApiKeyToken
Try this endpoint in your browser π
Query Parameters
Parameter | Description |
---|
| the string representing the signed raw transaction data to broadcast. |
ποΈ Tip: For more information on creating a signed raw transaction, visit this page.
Sample Response
{
"id":1,
"jsonrpc": "2.0",
"result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}
βοΈ Note: The result
represents the transaction hash of the submitted raw transaction.
Use eth_getTransactionReceipt to retrieve full details.
eth_getTransactionReceipt
Returns the receipt of a transaction that has been validated.
https://api-cardona-zkevm.polygonscan.com/api
?module=proxy
&action=eth_getTransactionReceipt
&txhash=0x0108074295ae6d5e1e5722775db31259c8acb807251cef8f27eb700be3dddb76
&apikey=YourApiKeyToken
Try this endpoint in your browser π
Query Parameters
Parameter | Description |
---|
| the string representing the hash of the transaction |
Sample Response
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"root": "0xb62d3be4fb772c5aac31eb8ab66a2eeb203e1edcc3502b44b49fd1b39a659fdb",
"cumulativeGasUsed": "0x5208",
"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"logs": [],
"status": "0x1",
"transactionHash": "0x0108074295ae6d5e1e5722775db31259c8acb807251cef8f27eb700be3dddb76",
"transactionIndex": "0x0",
"blockHash": "0xac2c182462d26af66002d7b3f8abd00ac2d089bed3317f7d8cd73ae9194cc510",
"blockNumber": "0xad09",
"gasUsed": "0x5208",
"from": "0x9af3049dd15616fd627a35563b5282bea5c32e20",
"to": "0x417a7ba2d8d0060ae6c54fd098590db854b9c1d5",
"contractAddress": null,
"type": "0x0",
"effectiveGasPrice": "0x38b0fc66e"
}
}
eth_call
Executes a new message call immediately without creating a transaction on the block chain.
https://api-cardona-zkevm.polygonscan.com/api
?module=proxy
&action=eth_call
&to=0x42088174635391921b5a50d36e37ca816a0f3ee0
&data=0xdbdff2c1
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser π
Query Parameters
Parameter | Description |
---|
| the string representing the address to interact with |
| the hash of the method signature and encoded parameters |
| the string pre-defined block parameter, either earliest , pending or latest |
β½ Note: The gas
parameter is capped at 2x the current block gas limit.
Sample Response
{
"jsonrpc":"2.0",
"id":1,
"result":"0x00000000000000000000000000000000000000000000000000601d8888141c00"
}
eth_getCode
Returns code at a given address.
https://api-cardona-zkevm.polygonscan.com/api
?module=proxy
&action=eth_getCode
&address=0xBC8DF46B5AbBB49B4e3cbDdD03788f87FE8C8358
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser π
Query Parameters
Parameter | Description |
---|
| the string representing the address to get code |
| the string pre-defined block parameter, either earliest , pending or latest |
Sample Response
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x6080604052348015600f57600080fd5b5060043610603c5760003560e01c8063313ce5671460415780633fb5c1cb1460575780638381f58a146068575b600080fd5b6001545b60405190815260200160405180910390f35b606660623660046080565b6070565b005b604560015481565b607a8161ea8a6098565b60015550565b600060208284031215609157600080fd5b5035919050565b808202811582820484141760bc57634e487b7160e01b600052601160045260246000fd5b9291505056fea26469706673582212200c39ccbe94bb845318d7d22afd2537824e3279d831ae058e19391e52a0f2ef7564736f6c63430008110033"
}
eth_getStorageAt
Returns the value from a storage position at a given address.
This endpoint is still experimental and may have potential issues
https://api-cardona-zkevm.polygonscan.com/api
?module=proxy
&action=eth_getStorageAt
&address=0xBC8DF46B5AbBB49B4e3cbDdD03788f87FE8C8358
&position=0x0
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser π
Query Parameters
Parameter | Description |
---|
| the string representing the address to get code |
| the hex code of the position in storage, eg 0x0 |
| the string pre-defined block parameter, either earliest , pending or latest |
Sample Response
{
"jsonrpc":"2.0",
"id":1,
"result":"0x0000000000000000000000000000000000000000000000000000000000000000"
}
eth_gasPrice
Returns the current price per gas in wei.
https://api-cardona-zkevm.polygonscan.com/api
?module=proxy
&action=eth_gasPrice
&apikey=YourApiKeyToken
Try this endpoint in your browser π
Sample Response
{
"jsonrpc":"2.0",
"id":73,
"result":"0x98bca5a00"
}
π Tip: The result
is returned in wei.
Easily convert ETH units using our unit converter.
eth_estimateGas
Makes a call or transaction, which won't be added to the blockchain and returns the gas used.
https://api-cardona-zkevm.polygonscan.com/api
?module=proxy
&action=eth_estimateGas
&data=0x4e71d92d
&to=0xEeee7341f206302f2216e39D715B96D8C6901A1C
&value=0xff22
&gasPrice=0x51da038cc
&gas=0x5f5e0ff
&apikey=YourApiKeyToken
Try this endpoint in your browser π
Query Parameters
Parameter | Description |
---|
| the hash of the method signature and encoded parameters |
| the string representing the address to interact with |
| the value sent in this transaction, in hex eg. 0xff22 |
| the amount of gas provided for the transaction, in hex eg. 0x5f5e0ff |
| the gas price paid for each unit of gas, in wei |
β½ Note: The gas
parameter is capped at 2x the current block gas limit.
Sample Response
{
"jsonrpc":"2.0",
"id":1,
"result":"0x5248"
}
Last updated