Beatae error blanditiis libero

Retrieve transaction history, status, and internal calls for any address or transaction hash on Polygon PoS.

The Polygon Transaction API is the core module for querying on-chain activity. Whether you are building a portfolio tracker, a compliance tool, or a block explorer integration, these endpoints provide everything needed to inspect and verify Polygon transactions in real time.

Querying Transaction History by Address

The most common use case is retrieving the full transaction history of a wallet address. Use the txlist action in the account module:

?module=account&action=txlist&address=0xADDRESS&startblock=0&endblock=99999999&sort=asc&apikey=KEY

Each transaction record includes: hash, blockNumber, timeStamp, from, to, value (in Wei), gas, gasPrice, gasUsed, isError, and txreceipt_status. Paginate results using the page and offset parameters.

Internal Transactions

Internal transactions are value transfers that occur inside smart contract executions — they do not appear in the main transaction list. Use txlistinternal to fetch them by address, or by parent transaction hash for a specific call trace:

• By address: action=txlistinternal&address=0xADDR
• By tx hash: action=txlistinternal&txhash=0xHASH
• By block range: action=txlistinternal&startblock=X&endblock=Y

Transaction Status & Receipts

To check whether a submitted transaction succeeded or was reverted, use the transaction module:

• getstatus – Returns the contract execution status: 0 (fail) or 1 (pass), plus an error description if applicable
• gettxreceiptstatus – Returns the transaction receipt status: 0 (fail) or 1 (success)

Token Transfer Queries

Track ERC-20, ERC-721, and ERC-1155 token transfers using dedicated actions:

• tokentx – ERC-20 transfers for an address or contract
• tokennfttx – ERC-721 NFT transfers
• token1155tx – ERC-1155 multi-token transfers

Each transfer record includes: tokenName, tokenSymbol, tokenDecimal, contractAddress, from, to, value, and the block and timestamp of the transfer.