eth_getTransactionByHash

eth_getTransactionByHash returns the full transaction object for a given hash on the Avalanche C-Chain: sender, recipient, AVAX value, gas pricing, input data, and — once mined — the block hash and number it landed in. It is the everyday way to look up a transaction you submitted or saw on Snowtrace and read its details programmatically. Thanks to the C-Chain's roughly 1–2 second finality under Snowman consensus, a freshly broadcast transaction usually resolves to a mined object within a couple of seconds. Send the request to https://avalanche.therpc.io/YOUR_API_KEY (chain ID 43114, 0xa86a) with the 32-byte transaction hash.

Use cases

• Confirm a submitted C-Chain transaction was mined by checking that blockNumber is non-null after broadcast.
• Decode the input field to identify which contract function was called — for example a swap on Trader Joe or a borrow on Aave.
• Read the from address and AVAX value to verify an inbound payment before crediting an account.

Parameters

Response

Example request

1curl https://avalanche.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 Avalanche playground.

Errors & troubleshooting

Common pitfalls

• A non-null object only means the transaction exists, not that it succeeded — fetch eth_getTransactionReceipt and check its status field for the actual execution outcome.
• A still-pending transaction returns an object whose blockHash, blockNumber, and transactionIndex are all null; treat those nulls as "not yet mined", not "not found".
• A dropped or never-broadcast hash returns null outright, so null-check the response before reading any field.

Supported networks

• Mainnet — Chain ID: 43114
• Fuji

See also

• eth_getTransactionReceipt
• eth_getTransactionByBlockHashAndIndex
• eth_getTransactionByBlockNumberAndIndex

1curl https://avalanche.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":[""]}'