$ man tx-receipt-decode
/tx-receipt-decode(1)
PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgemarketCATEGORY
uncategorized
STATUS
● live
NAME
tx-receipt-decode — evm transaction receipt decoder / log decoder / event log reader / etherscan tx debug / receipt parser / basescan tx explainer / tenderly…
SYNOPSIS
POST https://x402.org/v1/tx-receipt-decode
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
EVM transaction receipt decoder / log decoder / event log reader / Etherscan tx debug / receipt parser / Basescan tx explainer / tenderly-style trace lite. Given a tx hash, fetches the receipt + transaction via Etherscan v2 and decodes every log: ERC-20 / ERC-721 Transfer + Approval + ApprovalForAll are decoded canonically (from/to/value/tokenId etc.); other logs use the contract's verified ABI when available; remaining unknown topics are looked up against 4byte.directory's event-signature index. Returns status (success/failed), block number, gas used + gas price (gwei), from/to/value, and a structured array of decoded logs with named params and contract names where verified.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| tx_hash | string | 0x-prefixed 32-byte transaction hash (66 chars total). | required |
| chain | string | EVM chain. Default 'base'. enum: base · ethereum · polygon · arbitrum · optimism | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| tx_hash | string | Transaction hash that was decoded, echoed back from the request. |
| chain | string | EVM chain the tx was fetched from (e.g. base, mainnet, optimism). |
| status | string | Receipt status, either 'success' or 'failed' based on the tx outcome. |
| block_number | string | Block number the transaction was included in, as a decimal string. |
| gas_used | string | Gas units consumed by the transaction, as a decimal string. |
| gas_price_gwei | string | Effective gas price paid for the transaction, denominated in gwei. |
| from | string | Sender address (EOA or contract) that originated the transaction. |
| to | string | Recipient address of the transaction, or null for contract-creation calls. |
| value_wei | string | Native token value transferred by the tx itself, in wei as a decimal string. |
| decoded_logs | string | Array of decoded event logs with named params, contract names, and canonical ERC-20/721 fields. |
| unknown_logs_count | string | Count of logs whose topics couldn't be resolved via verified ABI or 4byte lookup. |
| source | string | Upstream data source used to fetch the receipt and ABI (e.g. etherscan-v2). |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/tx-receipt-decode \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# install once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the tx-receipt-decode tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- evmtransaction-receiptlog-decodererc20-transfersevent-logsetherscantx-debugreceipt-decoder
- methods
- POST
- cluster
- edgemarket
- price
- $0.02 USDC per call
ADJACENT — other endpoints in edgemarket
| endpoint | description | price |
|---|---|---|
| defi-llama-protocol | DefiLlama protocol lookup — TVL, chain breakdown, current TVL, 24h/7d/30d changes, audits, parent protocol, categories. | $0.02 |
| gas-now-base | Gas oracle / EIP-1559 fee estimator. | $0.02 |
| gas-price | Gas price API / EIP-1559 fee estimator / Base + Ethereum + Optimism + Arbitrum gas tracker / pre-tx cost estimator. | $0.02 |
| token-price | Crypto token price API / CoinGecko wrapper. | $0.02 |
| tx-simulate-swap | Tx simulate swap / pre-trade quote / DEX swap simulator / 1inch + LlamaSwap quote / would-it-succeed check. | $0.02 |
| bridge-rates | Cross-chain bridge rate aggregator. | $0.03 |
| dao-proposal-monitor | Snapshot.org DAO proposal monitor. | $0.03 |
| ens-resolve | ENS resolver / Ethereum Name Service lookup. | $0.03 |
SEE ALSO