Accounts

Get ETH Balance for a Single Address

Returns the ETH balance of a given address.

https://api-zkevm.polygonscan.com/api
   ?module=account
   &action=balance
   &address=0xE4eDb277e41dc89aB076a1F049f4a3EfA700bCE8
   &apikey=YourApiKeyToken

Query Parameters

Sample response

{
   "status":"1",
   "message":"OK",
   "result":"9996128487000000000"
}

Convert ETH units using our Unit Converter.

Get ETH Balance for Multiple Addresses in a Single Call

Returns the balance of the accounts from a list of addresses.

https://api-zkevm.polygonscan.com/api
   ?module=account
   &action=balancemulti
   &address=0x5A534988535cf27a70e74dFfe299D06486f185B7,0x54bA15efe1b6D886bA4Cd5C5837240675BD0D43a,0x39842a0Fe638cc956b76A49E918c30d818708BA0
   &tag=latest
   &apikey=YourApiKeyToken

Query Parameters

Sample Response

{
    "status":"1",
    "message":"OK",
    "result":[
        {
            "account":"0x5A534988535cf27a70e74dFfe299D06486f185B7",
            "balance":"9996128487000000000"
        },
        {
            "account":"0x54bA15efe1b6D886bA4Cd5C5837240675BD0D43a",
            "balance":"119463385027459645"
        },
        {
            "account":"0x39842a0Fe638cc956b76A49E918c30d818708BA0",
            "balance":"100761697447268339"
        }
    ]
}

Convert ETH units using our Unit Converter.

Get a list of 'Normal' Transactions By Address

Returns the list of transactions performed by an address, with optional pagination.

https://api-zkevm.polygonscan.com/api
   ?module=account
   &action=txlist
   &address=0xE4eDb277e41dc89aB076a1F049f4a3EfA700bCE8
   &startblock=0
   &endblock=99999999
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken

Query Parameters

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "8300",
      "blockHash": "0x9c24cca6d177c21dc185cdbc08db980fe52a866e90a0b8957538cf6ca83cf449",
      "timeStamp": "1679988122",
      "hash": "0x03185c94f200ef6864b9bf215f7b1c1bba63b3037ca018e8f7b3d24ce5de8c66",
      "nonce": "2",
      "transactionIndex": "0",
      "from": "0x151409521fc4af3dbace6d97fd4148a44bf07300",
      "to": "0xe4edb277e41dc89ab076a1f049f4a3efa700bce8",
      "value": "59000000000000000000",
      "gas": "21000",
      "gasPrice": "3540001235",
      "input": "0x",
      "methodId": "0x",
      "functionName": "",
      "contractAddress": "",
      "cumulativeGasUsed": "21000",
      "txreceipt_status": "1",
      "gasUsed": "21000",
      "confirmations": "353827",
      "isError": "0"
    },
    {
      "blockNumber": "9804",
      "blockHash": "0x2ef9b780faeefc106d17c5364be9bc467e6f473072efd79abda88690b233db6a",
      "timeStamp": "1679998590",
      "hash": "0xed7306be4961d46755dbd5896e3de15582f4cae7126256f0f0ea8ec2b1a07c57",
      "nonce": "0",
      "transactionIndex": "0",
      "from": "0xe4edb277e41dc89ab076a1f049f4a3efa700bce8",
      "to": "0xfd38ea22ebc3be1de4ca39f460da500db85edcc6",
      "value": "5000000000000089",
      "gas": "100000",
      "gasPrice": "3640000000",
      "input": "0x",
      "methodId": "0x",
      "functionName": "",
      "contractAddress": "",
      "cumulativeGasUsed": "21000",
      "txreceipt_status": "1",
      "gasUsed": "21000",
      "confirmations": "352323",
      "isError": "0"
    }
  ]
}

Get a list of 'Internal' Transactions by Address

Returns the list of internal transactions performed by an address, with optional pagination.

https://api-zkevm.polygonscan.com/api
   ?module=account
   &action=txlistinternal
   &address=0x90cc6C10C7211844c66640b4d01486cb45E0F3E8
   &startblock=0
   &endblock=99999999
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken

Query Parameters

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "306744",
      "timeStamp": "1684511175",
      "hash": "0x408f3c8e4e1f0824ac19fb64ecb96c5f88c21dd321d828923c7d2f9463287e5d",
      "from": "0x0000000000ffe8b47b3e2130213b802212439497",
      "to": "",
      "value": "0",
      "contractAddress": "0x90cc6c10c7211844c66640b4d01486cb45e0f3e8",
      "input": "",
      "type": "create2",
      "gas": "586434",
      "gasUsed": "3",
      "traceId": "0_1",
      "isError": "0",
      "errCode": ""
    }
  ]
}

Get 'Internal Transactions' by Transaction Hash

Returns the list of internal transactions performed within a transaction.

https://api-zkevm.polygonscan.com/api
   ?module=account
   &action=txlistinternal
   &txhash=0x408f3c8e4e1f0824ac19fb64ecb96c5f88c21dd321d828923c7d2f9463287e5d
   &apikey=YourApiKeyToken

Query Parameters

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "306744",
      "timeStamp": "1684511175",
      "from": "0x0000000000ffe8b47b3e2130213b802212439497",
      "to": "",
      "value": "0",
      "contractAddress": "0x90cc6c10c7211844c66640b4d01486cb45e0f3e8",
      "input": "",
      "type": "create2",
      "gas": "586434",
      "gasUsed": "3",
      "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-zkevm.polygonscan.com/api
   ?module=account
   &action=txlistinternal
   &startblock=306743
   &endblock=306744
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken

Query Parameters

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "306744",
      "timeStamp": "1684511175",
      "hash": "0x408f3c8e4e1f0824ac19fb64ecb96c5f88c21dd321d828923c7d2f9463287e5d",
      "from": "0x0000000000ffe8b47b3e2130213b802212439497",
      "to": "",
      "value": "0",
      "contractAddress": "0x90cc6c10c7211844c66640b4d01486cb45e0f3e8",
      "input": "",
      "type": "create2",
      "gas": "586434",
      "gasUsed": "3",
      "traceId": "0_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-zkevm.polygonscan.com/api
   ?module=account
   &action=tokentx
   &contractaddress=0x90cc6C10C7211844c66640b4d01486cb45E0F3E8
   &address=0x808081269906e0e01285ed9c3525c67e09811860
   &startblock=0
   &endblock=99999999
   &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.

Query Parameters

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "306744",
      "timeStamp": "1684511175",
      "hash": "0x408f3c8e4e1f0824ac19fb64ecb96c5f88c21dd321d828923c7d2f9463287e5d",
      "nonce": "0",
      "blockHash": "0xd9bd4ca7862c8c415666ec089ab5107b8ce03a742ad20c379cf5e5219cf14368",
      "from": "0x0000000000000000000000000000000000000000",
      "contractAddress": "0x90cc6c10c7211844c66640b4d01486cb45e0f3e8",
      "to": "0x808081269906e0e01285ed9c3525c67e09811860",
      "value": "21000000000000000000000000",
      "tokenName": "Fastest Shipper",
      "tokenSymbol": "SHIP",
      "tokenDecimal": "18",
      "transactionIndex": "0",
      "gas": "670044",
      "gasPrice": "6380000000",
      "gasUsed": "666289",
      "cumulativeGasUsed": "666289",
      "input": "deprecated",
      "confirmations": "55439"
    }
  ]
}

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-zkevm.polygonscan.com/api
   ?module=account
   &action=tokennfttx
   &contractaddress=0x91553861aA69B17F2d0302811B4CeC0626602174
   &address=0xfece8860904bcf6d27084dd0b62f098224aea250
   &startblock=0
   &endblock=99999999
   &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.

Query Parameters

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "105568",
      "timeStamp": "1681095318",
      "hash": "0xaddd79d22794c6c51c0588c8d080c2d9bc40a672c219daa3e1bf58822c785c39",
      "nonce": "1545",
      "blockHash": "0x9543776a01a0fedcafabb1c466b6c759fca713d69b1e7377501f0506e6ce0ff6",
      "from": "0x0000000000000000000000000000000000000000",
      "contractAddress": "0x91553861aa69b17f2d0302811b4cec0626602174",
      "to": "0xfece8860904bcf6d27084dd0b62f098224aea250",
      "tokenID": "170493",
      "tokenName": "To Ethereum, with Love",
      "tokenSymbol": "ZKEVM",
      "tokenDecimal": "0",
      "transactionIndex": "0",
      "gas": "2698629",
      "gasPrice": "2930000000",
      "gasUsed": "2655236",
      "cumulativeGasUsed": "2655236",
      "input": "deprecated",
      "confirmations": "256702"
    },
    {
      "blockNumber": "105568",
      "timeStamp": "1681095318",
      "hash": "0xaddd79d22794c6c51c0588c8d080c2d9bc40a672c219daa3e1bf58822c785c39",
      "nonce": "1545",
      "blockHash": "0x9543776a01a0fedcafabb1c466b6c759fca713d69b1e7377501f0506e6ce0ff6",
      "from": "0x0000000000000000000000000000000000000000",
      "contractAddress": "0x91553861aa69b17f2d0302811b4cec0626602174",
      "to": "0xfece8860904bcf6d27084dd0b62f098224aea250",
      "tokenID": "170494",
      "tokenName": "To Ethereum, with Love",
      "tokenSymbol": "ZKEVM",
      "tokenDecimal": "0",
      "transactionIndex": "0",
      "gas": "2698629",
      "gasPrice": "2930000000",
      "gasUsed": "2655236",
      "cumulativeGasUsed": "2655236",
      "input": "deprecated",
      "confirmations": "256702"
    }
  ]
}

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-zkevm.polygonscan.com/api
   ?module=account
   &action=token1155tx
   &contractaddress=0xb0E834FB82f890bF6f458C9aAa4e6d9e8411BB20
   &address=0x1c87869225399b62206cfced6fe883d0ac725c11
   &page=1
   &offset=100
   &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.

Query Parameters

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "120400",
      "timeStamp": "1681403637",
      "hash": "0xe60618e221ea3f865473b4eb6a9237d43a808ae92ee454d0ed74875f84bee5de",
      "nonce": "5",
      "blockHash": "0x08db8ac68d72b3d576ef0cc2644b32e3af84a97dd329ab8b3fadc4e9bd326466",
      "transactionIndex": "0",
      "gas": "131273",
      "gasPrice": "4860000000",
      "gasUsed": "127627",
      "cumulativeGasUsed": "127627",
      "input": "deprecated",
      "contractAddress": "0xb0e834fb82f890bf6f458c9aaa4e6d9e8411bb20",
      "from": "0x0000000000000000000000000000000000000000",
      "to": "0x1c87869225399b62206cfced6fe883d0ac725c11",
      "tokenID": "0",
      "tokenValue": "1",
      "tokenName": "zkEVM – Unconstrained Scalability",
      "tokenSymbol": "ZKVITB",
      "confirmations": "241918"
    }
  ]
}

Get list of Blocks Validated by Address

Returns the list of blocks validated by an address.

https://api-zkevm.polygonscan.com/api
   ?module=account
   &action=getminedblocks
   &address=0xb79fad4ca981472442f53d16365fdf0305ffd8e9
   &blocktype=blocks
   &page=1
   &offset=10
   &apikey=YourApiKeyToken

Query Parameters

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "362331",
      "timeStamp": "1684823412",
      "blockReward": "157875690000000"
    },
    {
      "blockNumber": "362330",
      "timeStamp": "1684823412",
      "blockReward": "800646980000000"
    },
    {
      "blockNumber": "362329",
      "timeStamp": "1684823412",
      "blockReward": "1816699640000000"
    },
    {
      "blockNumber": "362328",
      "timeStamp": "1684823412",
      "blockReward": "155319400000000"
    },
    {
      "blockNumber": "362327",
      "timeStamp": "1684823412",
      "blockReward": "96908800000000"
    },
    {
      "blockNumber": "362326",
      "timeStamp": "1684823412",
      "blockReward": "90216000000000"
    },
    {
      "blockNumber": "362325",
      "timeStamp": "1684823412",
      "blockReward": "90216000000000"
    },
    {
      "blockNumber": "362324",
      "timeStamp": "1684823412",
      "blockReward": "137744540000000"
    },
    {
      "blockNumber": "362323",
      "timeStamp": "1684823412",
      "blockReward": "137780300000000"
    },
    {
      "blockNumber": "362322",
      "timeStamp": "1684823412",
      "blockReward": "70350000000000"
    }
  ]
}

PreviousEndpoint URLs NextContracts

Last updated 1 year ago