Endpoints with are under the API Pro subscription. To upgrade your API plan, browse through the PolygonScan APIs page.
Get POL Balance for a Single Address
Returns the POL balance of a given address.
https://api.polygonscan.com/api
?module=account
&action=balance
&address=0x5A534988535cf27a70e74dFfe299D06486f185B7
&apikey=YourApiKeyToken
Try this endpoint in your browser
Sample response
{
"status":"1",
"message":"OK",
"result":"9996128487000000000"
}
Get POL 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
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"account":"0x5A534988535cf27a70e74dFfe299D06486f185B7",
"balance":"9996128487000000000"
},
{
"account":"0x54bA15efe1b6D886bA4Cd5C5837240675BD0D43a",
"balance":"119463385027459645"
},
{
"account":"0x39842a0Fe638cc956b76A49E918c30d818708BA0",
"balance":"100761697447268339"
}
]
}
Returns the historical POL balance of an address at a certain block height.
https://api.polygonscan.com/api
?module=account
&action=balancehistory
&address=0x23eA5Ec7Ea2d4282012313c9899Cdc07bd45243d
&blockno=18798641
&apikey=YourApiKeyToken
Sample Response
{
"status":"1",
"message":"OK",
"result":"3885795692543222390"
}
Get a list of 'Normal' Transactions By Address
Returns the list of transactions performed by an address, with optional pagination.
https://api.polygonscan.com/api
?module=account
&action=txlist
&address=0xb91dd8225Db88dE4E3CD7B7eC538677A2c1Be8Cb
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
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.
https://api.polygonscan.com/api
?module=account
&action=txlistinternal
&address=0x0f4240D9bD4D3CFCE7aDE7F26415780824958Bc3
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
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.
https://api.polygonscan.com/api
?module=account
&action=txlistinternal
&txhash=0x23a07d4f622ba88c8338763d7811437953a0e8fab123b4346486936646f8578d
&apikey=YourApiKeyToken
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.
https://api.polygonscan.com/api
?module=account
&action=txlistinternal
&startblock=19568000
&endblock=19569000
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
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.
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.
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.
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 Plasma Deposits by Address
Returns a list of Plasma Deposits received by an address.
https://api.polygonscan.com/api
?module=account
&action=txnbridge
&address=0x4880bd4695a8e59dc527d124085749744b6c988e
&apikey=YourApiKeyToken
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"hash":"0xf645deb2b6fbb8b76ccbcf4bde782e28d3520e8a30e9a568b9b8c526e2fd8434",
"blockNumber":"51844560",
"timeStamp":"1704181285",
"from":"0x0000000000000000000000000000000000000000",
"address":"0x4880bd4695a8e59dc527d124085749744b6c988e",
"amount":"2341706540000000000",
"tokenName":"Matic Token",
"symbol":"POL",
"contractAddress":"0x0000000000000000000000000000000000001010",
"divisor":"18"
}
]
}
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
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"19569186",
"timeStamp":"1632738360",
"blockReward":"388632493476995398"
},
{
"blockNumber":"19569185",
"timeStamp":"1632738358",
"blockReward":"1021530830332446078"
},
]
}
