Get POL Balance for a Single Address
Returns the POL balance of a given address.
https://api-amoy.polygonscan.com/api
?module=account
&action=balance
&address=0x54d03EC0C462e9a01F77579C090cdE0FC2617817
&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":"9398781291528228483995885"
}
Get POL Balance for Multiple Addresses in a Single Call
Returns the balance of the accounts from a list of addresses.
https://api-amoy.polygonscan.com/api
?module=account
&action=balancemulti
&address=0x54d03EC0C462e9a01F77579C090cdE0FC2617817,0x21C7360b49D0Fc1Af267203E659f71DF2234cffb,0x16F6409ED185a03e3784738AC9c87456f3E13D41
&tag=latest
&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 string pre-defined block parameter, either earliest , pending or latest |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"account": "0x54d03EC0C462e9a01F77579C090cdE0FC2617817",
"balance": "9398781090688228483995885"
},
{
"account": "0x21C7360b49D0Fc1Af267203E659f71DF2234cffb",
"balance": "6629894241895562522901745"
},
{
"account": "0x16F6409ED185a03e3784738AC9c87456f3E13D41",
"balance": "2387376382332089293117838"
}
]
}
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-amoy.polygonscan.com/api
?module=account
&action=txlist
&address=0x54d03EC0C462e9a01F77579C090cdE0FC2617817
&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",
"result": [
{
"blockNumber": "1510701",
"timeStamp": "1703696217",
"hash": "0xd33b63fcc6f9ed12d433b906b7ac65e4b750c76b0fe9a1a33980fda767f6a602",
"nonce": "0",
"blockHash": "0x1ce8e4b46bea69fbcc479a8af0c0ce1ec2543e36802dc711f2e9df5da63c048b",
"transactionIndex": "0",
"from": "0x54d03ec0c462e9a01f77579c090cde0fc2617817",
"to": "0x7cd697041e98c860e64e4bd41a889b8579753e6f",
"value": "200000000000000000",
"gas": "150000",
"gasPrice": "40000000000",
"isError": "0",
"txreceipt_status": "1",
"input": "0x",
"contractAddress": "",
"cumulativeGasUsed": "21000",
"gasUsed": "21000",
"confirmations": "4181904",
"methodId": "0x",
"functionName": ""
},
{
"blockNumber": "1513127",
"timeStamp": "1703701373",
"hash": "0xe9786e663d19aff8f9a0453a3dd077e940a1c102e7142d9a363f0f6d6b278f88",
"nonce": "1",
"blockHash": "0x1c5db3c201ccd463c089be659c35c61b229e047b3213e5197fc94d9526dc48b3",
"transactionIndex": "0",
"from": "0x54d03ec0c462e9a01f77579c090cde0fc2617817",
"to": "0x753e08b2f9f57f14536a6faf6bf66ecd7196baf7",
"value": "200000000000000000",
"gas": "150000",
"gasPrice": "40000000000",
"isError": "0",
"txreceipt_status": "1",
"input": "0x",
"contractAddress": "",
"cumulativeGasUsed": "21000",
"gasUsed": "21000",
"confirmations": "4179478",
"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-amoy.polygonscan.com/api
?module=account
&action=txlistinternal
&address=0x55358DA2E6cA71DB2f2439b8E2899B85D78B34Ad
&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",
"result": [
{
"blockNumber": "5710423",
"timeStamp": "1712778381",
"hash": "0xea67ec9284ec11bbe63dabc7b8b1bf6493ea58ddd3ce00d7477f6676c76d9a1f",
"from": "0x55358da2e6ca71db2f2439b8e2899b85d78b34ad",
"to": "",
"value": "0",
"contractAddress": "0xd0b45b80a0c8d7ee064f9f2ce36ae51940103cfa",
"input": "",
"type": "create",
"gas": "394136",
"gasUsed": "162918",
"traceId": "0_1_1",
"isError": "0",
"errCode": ""
},
{
"blockNumber": "5710429",
"timeStamp": "1712778393",
"hash": "0x095e578f120e6f786b4b33d4a203a1f87705a4edd7a1d92514e3d723efef1d40",
"from": "0x55358da2e6ca71db2f2439b8e2899b85d78b34ad",
"to": "",
"value": "0",
"contractAddress": "0x5de09190ded7bf6a64da7493ff2320068c6c8bf0",
"input": "",
"type": "create",
"gas": "425265",
"gasUsed": "162918",
"traceId": "0_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-amoy.polygonscan.com/api
?module=account
&action=txlistinternal
&txhash=0xba6984ebd71532f1afcd137de3ed639adae63e246845fc42ad03d8b516465b05
&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",
"result": [
{
"blockNumber": "5916849",
"timeStamp": "1713235192",
"from": "0x55358da2e6ca71db2f2439b8e2899b85d78b34ad",
"to": "",
"value": "0",
"contractAddress": "0xfe866f2c581d458e9200132b51cdd8fbd66441f4",
"input": "",
"type": "create",
"gas": "453465",
"gasUsed": "162918",
"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.
Try this endpoint in your browser 🔗
https://api-amoy.polygonscan.com/api
?module=account
&action=txlistinternal
&startblock=5916849
&endblock=5916850
&page=1
&offset=2
&sort=asc
&apikey=YourApiKeyToken
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",
"result": [
{
"blockNumber": "5916849",
"timeStamp": "1713235192",
"hash": "0xba6984ebd71532f1afcd137de3ed639adae63e246845fc42ad03d8b516465b05",
"from": "0x55358da2e6ca71db2f2439b8e2899b85d78b34ad",
"to": "",
"value": "0",
"contractAddress": "0xfe866f2c581d458e9200132b51cdd8fbd66441f4",
"input": "",
"type": "create",
"gas": "453465",
"gasUsed": "162918",
"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-amoy.polygonscan.com/api
?module=account
&action=tokentx
&contractaddress=0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582
&address=0xfDc9cD3D0a9270d0EdFEc7954CAb52111A1001cc
&page=1
&offset=2
&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 sorting preference, use asc to sort by ascending and desc to sort by descending |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "5817466",
"timeStamp": "1713012938",
"hash": "0x99440518d81c63f6929050f60873fad6f51d39db3ced693e77850164c5d2f934",
"nonce": "5956",
"blockHash": "0x58a07d2d7a9b76a844e31a894daa84ef99d98140182da695dcc214234a4fb86f",
"from": "0x48520ff9b32d8b5bf87abf789ea7b3c394c95ebe",
"contractAddress": "0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582",
"to": "0xfdc9cd3d0a9270d0edfec7954cab52111a1001cc",
"value": "10000000",
"tokenName": "USDC",
"tokenSymbol": "USDC",
"tokenDecimal": "6",
"transactionIndex": "0",
"gas": "100000",
"gasPrice": "500000000000",
"gasUsed": "62159",
"cumulativeGasUsed": "62159",
"input": "deprecated",
"confirmations": "99475"
},
{
"blockNumber": "5818167",
"timeStamp": "1713014428",
"hash": "0x08789ffdd93106ee93736a8b3a90fa4b7d4e9861f1e3af9604570324a0869563",
"nonce": "9",
"blockHash": "0xf85706d97db1545ab3a5e99305405de4e26e12d33c4be683fa6fc7786cb0cd19",
"from": "0xfdc9cd3d0a9270d0edfec7954cab52111a1001cc",
"contractAddress": "0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582",
"to": "0xc1c4de9ba00e97375d6698c8b0f512db768d763c",
"value": "3000000",
"tokenName": "USDC",
"tokenSymbol": "USDC",
"tokenDecimal": "6",
"transactionIndex": "1",
"gas": "93970",
"gasPrice": "421231521015",
"gasUsed": "62159",
"cumulativeGasUsed": "83159",
"input": "deprecated",
"confirmations": "98774"
}
]
}
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-amoy.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.
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 sorting preference, use asc to sort by ascending and desc to sort by descending |
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-amoy.polygonscan.com/api
?module=account
&action=getminedblocks
&address=0x4AD84f7014B7b44F723F284a85B1662337971439
&blocktype=blocks
&page=1
&offset=2
&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 type, blocks for canonical blocks |
| the integer page number, if pagination is enabled |
| the number of transactions displayed per page |
Sample Response
{
"status": "1",
"message": "OK",
"result": [
{
"blockNumber": "5916955",
"timeStamp": "1713235448",
"blockReward": "1717980000858990"
},
{
"blockNumber": "5916954",
"timeStamp": "1713235446",
"blockReward": "10642250000000000"
}
]
}