eth_getTransactionByHash

eth_getTransactionByHash returns the full transaction object for a given hash on Polygon PoS (chain ID 137) — sender, recipient, value in MATIC wei, gas fields, the input calldata, and, once mined, its block number and position. It is the workhorse for tracking any transaction you have submitted or observed on Polygon, from a QuickSwap swap to a USDC transfer. Send the hash to https://polygon.therpc.io/YOUR_API_KEY and you get the transaction object back, or null while it is still pending and unknown to the node, or if it was never seen.

Use cases

• Confirm a transaction you broadcast to Polygon has been included by checking that blockNumber is non-null (Bor blocks land in about 2 seconds, so this flips quickly).
• Decode the input calldata to identify which contract function was invoked — for instance distinguishing an ERC-20 transfer from an approve on a Polygon token.
• Read the from address and value to verify an incoming MATIC payment before crediting it.

Parameters

Response

Example request

1curl https://polygon.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "eth_getTransactionByHash",
7    "params": ["0x0000000000000000000000000000000000000000000000000000000000000000"],
8    "id": 1
9  }'

Try it live in the Polygon playground.

Errors & troubleshooting

Common pitfalls

• A non-null object only means the transaction exists, not that it succeeded — execution can still have reverted; check the status field of eth_getTransactionReceipt for the actual outcome.
• A pending transaction comes back as an object with blockHash, blockNumber, and transactionIndex all null; do not mistake that for confirmation.
• Dropped or never-broadcast hashes return null outright, so always null-check the response before reading any field.

Supported networks

• Mainnet — Chain ID: 137
• Amoy — Chain ID: 80002

See also

• eth_getTransactionReceipt
• eth_getTransactionByBlockHashAndIndex
• eth_getTransactionByBlockNumberAndIndex

1curl https://polygon.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getTransactionByHash","params":[""]}'