$ man tx-receipt-decode
/tx-receipt-decode
PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgemarketCATEGORY
uncategorized
STATUS
● live
NAME
tx-receipt-decode — decodes an evm transaction receipt and every event log from a tx hash
SYNOPSIS
POST https://x402.agentutility.ai/tx-receipt-decode
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Decodes an EVM transaction receipt and every event log from a tx hash. Fetches the receipt + transaction via Etherscan v2 and decodes each 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. Use it as a log decoder, event log reader, receipt parser, Etherscan tx debug, Basescan tx explainer, or tenderly-style trace lite.
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.agentutility.ai/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 the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the tx-receipt-decode tool from your MCP-aware agent.
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 | DefiLlama API / DeFi TVL protocol lookup. | $0.02 |
| defi-llama-api | Looks up DeFi protocol fundamentals from DefiLlama, resolving protocol TVL, category, chains, token symbol, and protocol metadata. | $0.02 |
| defi-llama-protocol | Looks up any DeFi protocol's TVL and metadata from DefiLlama. | $0.02 |
| defi-tvl | DeFi TVL API / total value locked by protocol. | $0.02 |
| defillama | DefiLlama protocol TVL lookup / DeFi protocol metadata. | $0.02 |
| gas-api | Estimates blockchain gas fees with EIP-1559 tiers for Base, Ethereum, Optimism, and Arbitrum. | $0.02 |
| gas-fees | Estimates EIP-1559 transaction fees on Base, Ethereum, Optimism, and Arbitrum. | $0.02 |
| gas-now-base | Real-time gas price oracle for Base, Ethereum, Optimism, Arbitrum, and Polygon. | $0.02 |
SEE ALSO