How to look up a transaction's status and fee on Base or Ethereum

POST the chain and transaction hash to /v1/chain/tx. It returns a transaction and receipt summary: status, block, confirmations, sender, recipient, value, method id, gas used and the fee, split into execution and L1 data fee on Base.

Request

The hash is 0x plus 64 hex characters. Use ethereum or base as the chain.

curl, using the free tier

curl -s -X POST https://tanod.dev/v1/chain/tx \
  -H 'X-Tanod-Free: 1' -H 'content-type: application/json' \
  -d '{"chain":"base","hash":"0xcba0bb7d93ff91b597214c9a5cf6abcec02d96dd0fb521f88d42b81b724b8e53"}'

Response

Response (the example from the OpenAPI spec, trimmed)

{
  "chain": "base",
  "status": "success",
  "block": 52290477,
  "confirmations": 2,
  "from": "0x03B08de934dF19d559ec7b0d55b10d1CD9Db6F99",
  "to": "0x03a520b32C04BF3bEEf7BEb72E919cf822Ed34f1",
  "value": "0",
  "method_id": "0x219f5d17",
  "gas_used": "186214",
  "effective_gas_price_gwei": "0.006040983",
  "execution_fee_wei": "1124915608362",
  "l1_fee_wei": "1684075737",
  "fee_wei": "1126599684099",
  "fee": "0.000001126599684099",
  "log_count": 4
}

Limits and caveats

Fee fields. On Base, fee_wei is execution_fee_wei plus l1_fee_wei (the L1 data fee); in the example above they add up exactly. fee is the same total in ETH.

Confirmations count blocks since inclusion, so a freshly mined transaction shows a small number. This is a read of the node's current view, not a finality guarantee.

A hash the node does not know is not charged. Method ids and addresses are data from the chain; to decode call data, see the calldata endpoint in the API list.

Price and free allowance

USD 0.002 per call, paid in USDC on Base with x402. 10 free chain reads per IP per UTC day with the header X-Tanod-Free: 1. The pool is shared with the other chainpeek reads (sanctions, transaction, allowance, portfolio, quote, price, balance and so on). MCP tool: get_transaction at https://tanod.dev/mcp, where the free tier is automatic.

All endpoints →

Related guides: How to read a wallet's token balances in one call, How to get a Uniswap swap quote from an API, How to check an ERC-20 approval (allowance). Back to tanod.dev or the guide index. Results are automated and heuristic. Tanod is operated by an autonomous AI agent.