Accounts

Endpoints with 
 are under the API Pro subscription. To upgrade your API plan, browse through the PolygonScan APIs page.
Get MATIC Balance for a Single Address
Returns the MATIC balance of a given address.
https://api.polygonscan.com/api
   ?module=account
   &action=balance
   &address=0x5A534988535cf27a70e74dFfe299D06486f185B7
   &apikey=YourApiKeyToken
Try this endpoint in your browser ​🔗
​
Request
Response
Query Parameters
Parameter
Description
address
the string representing the address to check for balance
tag
the string pre-defined block parameter, either earliest, pending or latest
Sample response
{
   "status":"1",
   "message":"OK",
   "result":"9996128487000000000"
}
​📖
 Tip: The result is returned in wei. ​
Convert MATIC units using our Unit Converter.​
Get MATIC Balance for Multiple Addresses in a Single Call
Returns the balance of the accounts from a list of addresses.
https://api.polygonscan.com/api
   ?module=account
   &action=balancemulti
   &address=0x5A534988535cf27a70e74dFfe299D06486f185B7,0x54bA15efe1b6D886bA4Cd5C5837240675BD0D43a,0x39842a0Fe638cc956b76A49E918c30d818708BA0
   &tag=latest
   &apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
address
the strings representing the addresses to check for balance, separated by , commas
tag
the string pre-defined block parameter, either earliest, pending or latest
Sample Response
{
    "status":"1",
    "message":"OK",
    "result":[
        {
            "account":"0x5A534988535cf27a70e74dFfe299D06486f185B7",
            "balance":"9996128487000000000"
        },
        {
            "account":"0x54bA15efe1b6D886bA4Cd5C5837240675BD0D43a",
            "balance":"119463385027459645"
        },
        {
            "account":"0x39842a0Fe638cc956b76A49E918c30d818708BA0",
            "balance":"100761697447268339"
        }
    ]
}
​📖
 Tip: The result is returned in wei. ​
Convert MATIC units using our Unit Converter. ​
Get Historical MATIC Balance for a Single Address by BlockNo 
​
Returns the historical MATIC balance of an address at a certain block height.
​📝
 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
https://api.polygonscan.com/api
   ?module=account
   &action=balancehistory
   &address=0x23eA5Ec7Ea2d4282012313c9899Cdc07bd45243d
   &blockno=18798641
   &apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
address
the string representing the address to check for balance
blockno
the integer block number to check balance for eg. 2000000
Sample Response
{
   "status":"1",
   "message":"OK",
   "result":"3885795692543222390"
}
​📖
 Tip: The result is returned in wei. ​
Convert MATIC 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.
​​ ​ 📝
 Note : This API endpoint returns a maximum of 10000 records only.
https://api.polygonscan.com/api
   ?module=account
   &action=txlist
   &address=0xb91dd8225Db88dE4E3CD7B7eC538677A2c1Be8Cb
   &startblock=0
   &endblock=99999999
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken
Try this endpoint in your browser ​🔗
​
Request
Response
Query Parameters
Parameter
Description
address
the string representing the addresses to check for balance
startblock
the integer block number to start searching for transactions
endblock
the integer block number to stop searching for transactions
page
the integer page number, if pagination is enabled
offset
the number of transactions displayed per page
sort
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":"19087857",
            "blockHash":"0x2dfa320b3a606769bcc11e3bf62bbccc78e9ad554477053c6296eb9421a0584a",
            "timeStamp":"1631600445",
            "hash":"0x72d4375b21207307ae0154542f1f9f3b99275596b846337efd30e6597e764f78",
            "nonce":"0",
            "transactionIndex":"66",
            "from":"0xb91dd8225db88de4e3cd7b7ec538677a2c1be8cb",
            "to":"0xa81ce04168e41a47f68a975d67a00fbef729af9b",
            "value":"0",
            "gas":"500000",
            "gasPrice":"1000000001",
            "input":"0xedca65250000000000000000000000000000000000000000000000000000009e1e9e1409000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000040000000000000000000000008f2172568ad3b2024b8cb29b03279e4b3d4849c8000000000000000000000000cccec4a90b3435065f5e1fec6346be9da1b7b5ed000000000000000000000000adbf1854e5883eb8aa7baf50705338739e558e5b000000000000000000000000853ee4b2a13f8a742d64c8f088be7ba2131f670d",
            "contractAddress":"",
            "cumulativeGasUsed":"19685967",
            "txreceipt_status":"1",
            "gasUsed":"56112",
            "confirmations":"480898",
            "isError":"0"
        },
        {
            "blockNumber":"19089338",
            "blockHash":"0x1d32e743d3b2cf1b981478f01758cdd50bd57d1dc27d3ac9de1bb10b5f90635d",
            "timeStamp":"1631603783",
            "hash":"0xd70e432c764ed87eb8aa24c2741ca10b408a9232fdc0f4627e98a74fbc126feb",
            "nonce":"1",
            "transactionIndex":"48",
            "from":"0xb91dd8225db88de4e3cd7b7ec538677a2c1be8cb",
            "to":"0xa81ce04168e41a47f68a975d67a00fbef729af9b",
            "value":"0",
            "gas":"400000",
            "gasPrice":"1000000000",
            "input":"0xedca652500000000000000000000000000000000000000000000000000000000009e1e0800000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000002000000000000000000000000b5d51cad73ee111170d454cb2977b78681526ce40000000000000000000000000da3b65b61a55399be3cc6f11a58462cf079e543",
            "contractAddress":"",
            "cumulativeGasUsed":"18419754",
            "txreceipt_status":"1",
            "gasUsed":"40871",
            "confirmations":"479417",
            "isError":"0"
        },
        {
            "blockNumber":"19089952",
            "blockHash":"0xa1ce8c409bcc096d6363f471963a44c657a885024a2481112f0d64d8ad7c6403",
            "timeStamp":"1631605053",
            "hash":"0x21c38dea93ed1e9a13c1929262acaf35af370867bba503baea0780a36be1a90e",
            "nonce":"2",
            "transactionIndex":"38",
            "from":"0xb91dd8225db88de4e3cd7b7ec538677a2c1be8cb",
            "to":"0xa81ce04168e41a47f68a975d67a00fbef729af9b",
            "value":"0",
            "gas":"500000",
            "gasPrice":"10000000000",
            "input":"0xedca6525000000000000000000000000000000000000000000000000000000981e9e1e0400000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000004000000000000000000000000e62ec2e799305e0d367b0cc3ee2cda135bf8981600000000000000000000000034965ba0ac2451a34a0471f04cca3f990b8dea270000000000000000000000002cf7252e74036d1da831d11089d326296e64a7280000000000000000000000000509083749716b68f0fdb490a59ca62f2cffebb9",
            "contractAddress":"",
            "cumulativeGasUsed":"3136017",
            "txreceipt_status":"1",
            "gasUsed":"56138",
            "confirmations":"478803",
            "isError":"0"
        }
    ]
}
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.polygonscan.com/api
   ?module=account
   &action=txlistinternal
   &address=0x0f4240D9bD4D3CFCE7aDE7F26415780824958Bc3
   &startblock=0
   &endblock=99999999
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
address
the string representing the addresses to check for balance
startblock
the integer block number to start searching for transactions
endblock
the integer block number to stop searching for transactions
page
the integer page number, if pagination is enabled
offset
the number of transactions displayed per page
sort
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":"15364697",
            "timeStamp":"1622899655",
            "hash":"0x2993627de1b1c10005e0b73e9a813134c3c0ff0d064375a51c655c2fe3ef524d",
            "from":"0x9d67e0660f5056fdbf97106e39b79f0682a92d13",
            "to":"0x0f4240d9bd4d3cfce7ade7f26415780824958bc3",
            "value":"118800000000000000",
            "contractAddress":"",
            "input":"",
            "type":"call",
            "gas":"0",
            "gasUsed":"0",
            "traceId":"0_1",
            "isError":"0",
            "errCode":""
        },
        {
            "blockNumber":"15364771",
            "timeStamp":"1622899807",
            "hash":"0xb0e61900aee46eb8f6531a1ca855e65bb0d7105d08fed3c2c4c1fa81875358a7",
            "from":"0x9d67e0660f5056fdbf97106e39b79f0682a92d13",
            "to":"0x0f4240d9bd4d3cfce7ade7f26415780824958bc3",
            "value":"118800000000000000",
            "contractAddress":"",
            "input":"",
            "type":"call",
            "gas":"0",
            "gasUsed":"0",
            "traceId":"0_1",
            "isError":"0",
            "errCode":""
        },
        {
            "blockNumber":"15366114",
            "timeStamp":"1622902705",
            "hash":"0x4d8cc0a7ceeee6b5dfb2fd2e7edcc1cec15d482e3e0f13d37debbae748d4f10c",
            "from":"0x9d67e0660f5056fdbf97106e39b79f0682a92d13",
            "to":"0x0f4240d9bd4d3cfce7ade7f26415780824958bc3",
            "value":"396000000000000000",
            "contractAddress":"",
            "input":"",
            "type":"call",
            "gas":"0",
            "gasUsed":"0",
            "traceId":"0_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.polygonscan.com/api
   ?module=account
   &action=txlistinternal
   &txhash=0x23a07d4f622ba88c8338763d7811437953a0e8fab123b4346486936646f8578d
   &apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
txhash
the string representing the transaction hash to check for internal transactions
Sample Response
{
    "status":"1",
    "message":"OK",
    "result":[
        {
            "blockNumber":"19568872",
            "timeStamp":"1632737705",
            "from":"0x8dfdea6a4818d2aa7463edb9a8841cb0c04255af",
            "to":"0xdef1c0ded9bec7f1a1670819833240f027b25eff",
            "value":"100000000000000",
            "contractAddress":"",
            "input":"",
            "type":"call",
            "gas":"566960",
            "gasUsed":"236506",
            "isError":"0",
            "errCode":""
        },
        {
            "blockNumber":"19568872",
            "timeStamp":"1632737705",
            "from":"0xdef1c0ded9bec7f1a1670819833240f027b25eff",
            "to":"0xdb6f1920a889355780af7570773609bd8cb1f498",
            "value":"100000000000000",
            "contractAddress":"",
            "input":"",
            "type":"call",
            "gas":"2300",
            "gasUsed":"55",
            "isError":"0",
            "errCode":""
        },
        {
            "blockNumber":"19568872",
            "timeStamp":"1632737705",
            "from":"0xdb6f1920a889355780af7570773609bd8cb1f498",
            "to":"0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
            "value":"100000000000000",
            "contractAddress":"",
            "input":"",
            "type":"call",
            "gas":"491444",
            "gasUsed":"23977",
            "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.polygonscan.com/api
   ?module=account
   &action=txlistinternal
   &startblock=19568000
   &endblock=19569000
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter
Description
startblock
the integer block number to start searching for transactions
endblock
the integer block number to stop searching for transactions
page
the integer page number, if pagination is enabled
offset
the number of transactions displayed per page
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
    "status":"1",
    "message":"OK",
    "result":[
        {
            "blockNumber":"19568000",
            "timeStamp":"1632735779",
            "hash":"0x6f05de7f741b6a20d660a4a44644adf2dda19048c7c6fb268c4d0be67b85e960",
            "from":"0x1a577b7456100a5efe9fbc48f0042c4142d3913e",
            "to":"0x0000000000004946c0e9f43f4dee607b0ef1fa1c",
            "value":"0",
            "contractAddress":"",
            "input":"",
            "type":"suicide",
            "gas":"0",
            "gasUsed":"0",
            "traceId":"0_1_1_1",
            "isError":"0",
            "errCode":""
        },
        {
            "blockNumber":"19568000",
            "timeStamp":"1632735779",
            "hash":"0x6f05de7f741b6a20d660a4a44644adf2dda19048c7c6fb268c4d0be67b85e960",
            "from":"0x3ad5f34008164353dcfb99f190bf833031bb0c4e",
            "to":"0x0000000000004946c0e9f43f4dee607b0ef1fa1c",
            "value":"0",
            "contractAddress":"",
            "input":"",
            "type":"suicide",
            "gas":"0",
            "gasUsed":"0",
            "traceId":"0_1_1_1",
            "isError":"0",
            "errCode":""
        },
        {
            "blockNumber":"19568000",
            "timeStamp":"1632735779",
            "hash":"0x6f05de7f741b6a20d660a4a44644adf2dda19048c7c6fb268c4d0be67b85e960",
            "from":"0xf48b279e25d9220a2ddbfd98e54b26f8d5b4f995",
            "to":"0x0000000000004946c0e9f43f4dee607b0ef1fa1c",
            "value":"0",
            "contractAddress":"",
            "input":"",
            "type":"suicide",
            "gas":"0",
            "gasUsed":"0",
            "traceId":"0_1_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.polygonscan.com/api
   ?module=account
   &action=tokentx
   &contractaddress=0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270
   &address=0x6813ad11cca98e15ff181a257a3c2855d1eee69e
   &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.
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
address
the string representing the address to check for balance
contractaddress
the string representing the token contract address to check for balance
startblock
the integer block number to start searching for transactionsthe integer block number to start searching for transactions
endblock
the integer block number to stop searching for transactions
page
the integer page number, if pagination is enabled
offset
the number of transactions displayed per page
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
    "status":"1",
    "message":"OK",
    "result":[
        {
            "blockNumber":"14564127",
            "timeStamp":"1621168214",
            "hash":"0xe36f1c05abc143b2c60a09df75a5635b5b2b7a5f81e80511f73164352305120e",
            "nonce":"87",
            "blockHash":"0x6e25c1ec23f0aea9613c5483fb46e8d559ebc3bd7b1f1bcc3988df50cb75b41a",
            "from":"0xa3378ca78633b3b9b2255eaa26748770211163ae",
            "contractAddress":"0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
            "to":"0x6813ad11cca98e15ff181a257a3c2855d1eee69e",
            "value":"2078024843058232005",
            "tokenName":"Wrapped Matic",
            "tokenSymbol":"WMATIC",
            "tokenDecimal":"18",
            "transactionIndex":"39",
            "gas":"150026",
            "gasPrice":"1000000000",
            "gasUsed":"150026",
            "cumulativeGasUsed":"7213250",
            "input":"deprecated",
            "confirmations":"5005170"
        },
        {
            "blockNumber":"14648841",
            "timeStamp":"1621355284",
            "hash":"0x29543b00119f3370b3791676d4ecc62c8b1fcbc04499049cdbc13823c3df9e64",
            "nonce":"92",
            "blockHash":"0xfa516dbce5864ca17b078cf2d9453ea612b2dd572314d4d8daf4e6ac32cd2473",
            "from":"0xa3378ca78633b3b9b2255eaa26748770211163ae",
            "contractAddress":"0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
            "to":"0x6813ad11cca98e15ff181a257a3c2855d1eee69e",
            "value":"3784646058191219463",
            "tokenName":"Wrapped Matic",
            "tokenSymbol":"WMATIC",
            "tokenDecimal":"18",
            "transactionIndex":"69",
            "gas":"120026",
            "gasPrice":"1000000000",
            "gasUsed":"86229",
            "cumulativeGasUsed":"11350345",
            "input":"deprecated",
            "confirmations":"4920456"
        },
        {
            "blockNumber":"14648858",
            "timeStamp":"1621355318",
            "hash":"0x4c5623eff714eb82e36027d64321295b56ca6f70824bd53322dbfefebe3e9fe6",
            "nonce":"93",
            "blockHash":"0xbf6b6bb9930c855b666744ccada5e78cec658e79f9fcfe5a1cc6aaac84522f41",
            "from":"0xa3378ca78633b3b9b2255eaa26748770211163ae",
            "contractAddress":"0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
            "to":"0x6813ad11cca98e15ff181a257a3c2855d1eee69e",
            "value":"7777090721429512157",
            "tokenName":"Wrapped Matic",
            "tokenSymbol":"WMATIC",
            "tokenDecimal":"18",
            "transactionIndex":"114",
            "gas":"120026",
            "gasPrice":"1000000000",
            "gasUsed":"120026",
            "cumulativeGasUsed":"7911156",
            "input":"deprecated",
            "confirmations":"4920439"
        }
    ]
}
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.polygonscan.com/api
   ?module=account
   &action=tokennfttx
   &contractaddress=0x7227e371540cf7b8e512544ba6871472031f3335
   &address=0x30b32e79ed9c4012a71f4235f77dcf90a6f6800f
   &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.
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
address
the string representing the address to check for balance
contractaddress
the string representing the token contract address to check for balance
startblock
the integer block number to start searching for transactions
endblock
the integer block number to stop searching for transactions
page
the integer page number, if pagination is enabled
offset
the number of transactions displayed per page
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
    "status":"1",
    "message":"OK",
    "result":[
        {
            "blockNumber":"19569223",
            "timeStamp":"1632738438",
            "hash":"0xd10f0d982b6af51e75e72669f03cc29b9419e0af38bff216a87dde459f1e3120",
            "nonce":"1325664",
            "blockHash":"0xa7f90f1befd90f07bccf2e855623d1c6943fd9f289306e28c2d813aae7925f0b",
            "from":"0xb8ee86024faff179f93f36ccdc7ce758d5f278e2",
            "contractAddress":"0x7227e371540cf7b8e512544ba6871472031f3335",
            "to":"0x30b32e79ed9c4012a71f4235f77dcf90a6f6800f",
            "tokenID":"158456332942182445758440449393",
            "tokenName":"Neon District Season One Item",
            "tokenSymbol":"NDITEM1",
            "tokenDecimal":"0",
            "transactionIndex":"1",
            "gas":"916960",
            "gasPrice":"54390000000",
            "gasUsed":"402155",
            "cumulativeGasUsed":"528093",
            "input":"deprecated",
            "confirmations":"91"
        },
        {
            "blockNumber":"19569250",
            "timeStamp":"1632738492",
            "hash":"0x003e1acc2874c12e3cf15efcd700f56a27eba47d67faff812a295968763e1d4f",
            "nonce":"1325694",
            "blockHash":"0xa2573d4dcfc3491d60f27070ad36cdcdd6016d9b19279df0cd7fe4322dcc0979",
            "from":"0xb8ee86024faff179f93f36ccdc7ce758d5f278e2",
            "contractAddress":"0x7227e371540cf7b8e512544ba6871472031f3335",
            "to":"0x30b32e79ed9c4012a71f4235f77dcf90a6f6800f",
            "tokenID":"158456328957685725837177300329",
            "tokenName":"Neon District Season One Item",
            "tokenSymbol":"NDITEM1",
            "tokenDecimal":"0",
            "transactionIndex":"7",
            "gas":"848488",
            "gasPrice":"35000000000",
            "gasUsed":"382919",
            "cumulativeGasUsed":"815967",
            "input":"deprecated",
            "confirmations":"64"
        },
        {
            "blockNumber":"19569279",
            "timeStamp":"1632738550",
            "hash":"0xe266bb07fec6bad7340afe124caa855acbaf1cbe7370bc502ebbd975c0fc5538",
            "nonce":"1325737",
            "blockHash":"0xcdb5f2278bb5b3c0faaecac6e415520a4af27601e3fe772e0e92032f34c6d1a1",
            "from":"0xb8ee86024faff179f93f36ccdc7ce758d5f278e2",
            "contractAddress":"0x7227e371540cf7b8e512544ba6871472031f3335",
            "to":"0x30b32e79ed9c4012a71f4235f77dcf90a6f6800f",
            "tokenID":"158456327481946199940413171050",
            "tokenName":"Neon District Season One Item",
            "tokenSymbol":"NDITEM1",
            "tokenDecimal":"0",
            "transactionIndex":"1",
            "gas":"848488",
            "gasPrice":"35000000000",
            "gasUsed":"382919",
            "cumulativeGasUsed":"403919",
            "input":"deprecated",
            "confirmations":"35"
        }
    ]
}
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.polygonscan.com/api
   ?module=account
   &action=token1155tx
   &contractaddress=0x22d5f9b75c524fec1d6619787e582644cd4d7422
   &address=0x29a845a182c2fee158de363d5c17c545dcaf8c13
   &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.
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
address
the string representing the address to check for balance
contractaddress
the string representing the token contract address to check for balance
page
the integer page number, if pagination is enabled
offset
the number of transactions displayed per page
startblock
the integer block number to start searching for transactions
endblock
the integer block number to stop searching for transactions
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "blockNumber":"27991098",
         "timeStamp":"1651839367",
         "hash":"0x71cb5e4e5a6439ebc54698fddf4b287fa991a19836df69e474d7f86cbb2e0474",
         "nonce":"2",
         "blockHash":"0xa7689aa9ae6e8bec0af8de7c8a0c3b8574ed1b72fcd2f6d5698875c0ad9ae9a2",
         "transactionIndex":"60",
         "gas":"399628",
         "gasPrice":"58622583937",
         "gasUsed":"266349",
         "cumulativeGasUsed":"8731265",
         "input":"deprecated",
         "contractAddress":"0x22d5f9b75c524fec1d6619787e582644cd4d7422",
         "from":"0x0000000000000000000000000000000000000000",
         "to":"0x29a845a182c2fee158de363d5c17c545dcaf8c13",
         "tokenID":"501",
         "tokenValue":"1",
         "tokenName":"Sunflower Land Inventory",
         "tokenSymbol":"SLI",
         "confirmations":"3803652"
      },
      {
         "blockNumber":"27991098",
         "timeStamp":"1651839367",
         "hash":"0x71cb5e4e5a6439ebc54698fddf4b287fa991a19836df69e474d7f86cbb2e0474",
         "nonce":"2",
         "blockHash":"0xa7689aa9ae6e8bec0af8de7c8a0c3b8574ed1b72fcd2f6d5698875c0ad9ae9a2",
         "transactionIndex":"60",
         "gas":"399628",
         "gasPrice":"58622583937",
         "gasUsed":"266349",
         "cumulativeGasUsed":"8731265",
         "input":"deprecated",
         "contractAddress":"0x22d5f9b75c524fec1d6619787e582644cd4d7422",
         "from":"0x0000000000000000000000000000000000000000",
         "to":"0x29a845a182c2fee158de363d5c17c545dcaf8c13",
         "tokenID":"503",
         "tokenValue":"1",
         "tokenName":"Sunflower Land Inventory",
         "tokenSymbol":"SLI",
         "confirmations":"3803652"
      },
      {
         "blockNumber":"28241955",
         "timeStamp":"1652389794",
         "hash":"0x3184731c2b641d0b6fe93d950ef5721e433d35452ddc9b329b01f4b7ea1b52fc",
         "nonce":"4",
         "blockHash":"0xb0262ff65e3000f59ffd4663fcb43d6e4b0e4d887b4718d378d82831a0b0699f",
         "transactionIndex":"19",
         "gas":"383076",
         "gasPrice":"413629978451",
         "gasUsed":"255199",
         "cumulativeGasUsed":"4089128",
         "input":"deprecated",
         "contractAddress":"0x22d5f9b75c524fec1d6619787e582644cd4d7422",
         "from":"0x0000000000000000000000000000000000000000",
         "to":"0x29a845a182c2fee158de363d5c17c545dcaf8c13",
         "tokenID":"101",
         "tokenValue":"115000000000000000000",
         "tokenName":"Sunflower Land Inventory",
         "tokenSymbol":"SLI",
         "confirmations":"3552795"
      }
   ]
}
Get list of Blocks Validated by Address
Returns the list of blocks validated by an address.
https://api.polygonscan.com/api
   ?module=account
   &action=getminedblocks
   &address=0xb79fad4ca981472442f53d16365fdf0305ffd8e9
   &blocktype=blocks
   &page=1
   &offset=10
   &apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
address
the string representing the address to check for balance
blocktype
the string pre-defined block type, blocksfor canonical blocks
page
the integer page number, if pagination is enabled
offset
the number of transactions displayed per page
Sample Response
{
    "status":"1",
    "message":"OK",
    "result":[
        {
            "blockNumber":"19569186",
            "timeStamp":"1632738360",
            "blockReward":"388632493476995398"
        },
        {
            "blockNumber":"19569185",
            "timeStamp":"1632738358",
            "blockReward":"1021530830332446078"
        },
    ]
}
​⏳
 Note : The timeStamp is represented in Unix timestamp. ​
Parameter	Description
address	the `string` representing the address to check for balance
contractaddress	the `string` representing the token contract address to check for balance
page	the `integer` page number, if pagination is enabled
offset	the number of transactions displayed per page
startblock	the `integer` block number to start searching for transactions
endblock	the `integer` block number to stop searching for transactions
sort	the sorting preference, use `asc` to sort by ascending and `desc` to sort by descending
Last modified 5mo ago
Parameter	Description
txhash	the `string` representing the transaction hash to check for internal transactions
Accounts

Get MATIC Balance for a Single Address

Get MATIC Balance for Multiple Addresses in a Single Call

Get Historical MATIC Balance for a Single Address by BlockNo ​

Get a list of 'Normal' Transactions By Address

Get a list of 'Internal' Transactions by Address

Get 'Internal Transactions' by Transaction Hash

Get 'Internal Transactions' by Block Range

Get a list of 'ERC-20 Token Transfer Events' by Address

Get a list of 'ERC-721 Token Transfer Events' by Address

Get a list of 'ERC1155 - Token Transfer Events' by Address

Get list of Blocks Validated by Address

Get Historical MATIC Balance for a Single Address by BlockNo
