1. Home
  2. Docs
  3. Polygon POS Chain Developer APIs
  4. Account APIs

Account APIs

Account APIs

Get MATIC Balance for a single Address

https://api.polygonscan.com/api?module=account&action=balance&address=0x0000000000000000000000000000000000001010&tag=latest&apikey=YourApiKeyToken

Get MATIC Balance for multiple Addresses in a single call

https://api.polygonscan.com/api?module=account&action=balancemulti&address=0x0000000000000000000000000000000000001010,0x0000000000000000000000000000000000001010,0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c&tag=latest&apikey=YourApiKeyToken

Separate addresses by comma, up to a maxium of 20 accounts in a single batch

Get a list of ‘Normal’ Transactions By Address

[Optional Parameters] startblock: starting blockNo to retrieve results, endblock: ending blockNo to retrieve results

https://api.polygonscan.com/api?module=account&action=txlist&address=0x0000000000000000000000000000000000001010&startblock=1&endblock=99999999&sort=asc&apikey=YourApiKeyToken

(Returned ‘isError’ values: 0=No Error, 1=Got Error)

(Returns up to a maximum of the last 10000 transactions only)

or

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

(To get paginated results use page=<page number> and offset=<max records to return>)

Get a list of ‘Internal’ Transactions by Address

[Optional Parameters] startblock: starting blockNo to retrieve results, endblock: ending blockNo to retrieve results

https://api.polygonscan.com/api?module=account&action=txlistinternal&address=0x0000000000000000000000000000000000001010&startblock=0&endblock=2702578&sort=asc&apikey=YourApiKeyToken

(Returned ‘isError’ values: 0=No Error, 1=Got Error)

(Returns up to a maximum of the last 10000 transactions only)

or

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

(To get paginated results use page=<page number> and offset=<max records to return>)

Get “Internal Transactions” by Transaction Hash

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

(Returned ‘isError’ values: 0=Ok, 1=Rejected/Cancelled)

(Returns up to a maximum of the last 10000 transactions only)

Get “Internal Transactions” by Block Range

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

(Returns up to a maximum of the last 10000 transactions only)

Get a list of “ERC-20 – Token Transfer Events” by Address

[Optional Parameters] startblock: starting blockNo to retrieve results, endblock: ending blockNo to retrieve results

https://api.polygonscan.com/api?module=account&action=tokentx&address=0x0000000000000000000000000000000000001010&startblock=0&endblock=19999999&sort=asc&apikey=YourApiKeyToken

(Returns up to a maximum of the last 10000 transactions only)

or

https://api.polygonscan.com/api?module=account&action=tokentx&contractaddress=0x0000000000000000000000000000000000001010&page=1&offset=100&sort=asc&apikey=YourApiKeyToken

(To get paginated results use page=<page number> and offset=<max records to return>)

or

https://api.polygonscan.com/api?module=account&action=tokentx&contractaddress=0x2791bca1f2de4661ed88a30c99a7a9449aa84174&address=0x0000000000000000000000000000000000001010&page=1&offset=100&sort=asc&apikey=YourApiKeyToken

(To get transfer events for a specific token contract, include the contractaddress parameter)

Get a list of “ERC721 – Token Transfer Events” by Address

[Optional Parameters] startblock: starting blockNo to retrieve results, endblock: ending blockNo to retrieve results

https://api.polygonscan.com/api?module=account&action=tokennfttx&address=0x0000000000000000000000000000000000001010&startblock=0&endblock=999999999&sort=asc

(Returns up to a maximum of the last 10000 transactions only)

or

https://api.polygonscan.com/api?module=account&action=tokennfttx&contractaddress=0xf556faf23fc2feefa33ee6db2d1ee4c70e534513&page=1&offset=100&sort=asc

(To get paginated results use page=<page number> and offset=<max records to return>)

or

https://api.polygonscan.com/api?module=account&action=tokennfttx&contractaddress=0xf556faf23fc2feefa33ee6db2d1ee4c70e534513&address=0x0910741516743fbf6e6d796e8c5a033ff953a0ee&page=1&offset=100&sort=asc

(To get transfer events for a specific token contract, include the contractaddress parameter)

Get list of Blocks Validated by Address

https://api.polygonscan.com/api?module=account&action=getminedblocks&address=0x46a3a41bd932244dd08186e4c19f1a7e48cbcdf4&blocktype=blocks&apikey=YourApiKeyToken

or

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

(To get paginated results use page=<page number> and offset=<max records to return>)

** type = blocks (full blocks only)

Originally published @ https://polygonscan.com/apis#accounts

Was this article helpful to you? Yes No

How can we help?