Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint · rollforge · bestiary · statline · matchpoint · retail · agentops · browserworkflow · modelrouter · compose
$ man tx-receipt-decode

/tx-receipt-decode

agentutility / edge-market / tx-receipt-decode
PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgemarket
CATEGORY
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.

INPUTrequest schema
propertytypedescriptionreq?
tx_hashstring0x-prefixed 32-byte transaction hash (66 chars total).required
chainstringEVM chain. Default 'base'.
enum: base · ethereum · polygon · arbitrum · optimism
optional
OUTPUTresponse shape
fieldtypedescription
tx_hashstringTransaction hash that was decoded, echoed back from the request.
chainstringEVM chain the tx was fetched from (e.g. base, mainnet, optimism).
statusstringReceipt status, either 'success' or 'failed' based on the tx outcome.
block_numberstringBlock number the transaction was included in, as a decimal string.
gas_usedstringGas units consumed by the transaction, as a decimal string.
gas_price_gweistringEffective gas price paid for the transaction, denominated in gwei.
fromstringSender address (EOA or contract) that originated the transaction.
tostringRecipient address of the transaction, or null for contract-creation calls.
value_weistringNative token value transferred by the tx itself, in wei as a decimal string.
decoded_logsstringArray of decoded event logs with named params, contract names, and canonical ERC-20/721 fields.
unknown_logs_countstringCount of logs whose topics couldn't be resolved via verified ABI or 4byte lookup.
sourcestringUpstream data source used to fetch the receipt and ABI (e.g. etherscan-v2).
EXAMPLEStwo 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
ADJACENTother endpoints in edgemarket
endpointdescriptionprice
defi-llamaDefiLlama API / DeFi TVL protocol lookup.$0.02
defi-llama-apiLooks up DeFi protocol fundamentals from DefiLlama, resolving protocol TVL, category, chains, token symbol, and protocol metadata.$0.02
defi-llama-protocolLooks up any DeFi protocol's TVL and metadata from DefiLlama.$0.02
defi-tvlDeFi TVL API / total value locked by protocol.$0.02
defillamaDefiLlama protocol TVL lookup / DeFi protocol metadata.$0.02
gas-apiEstimates blockchain gas fees with EIP-1559 tiers for Base, Ethereum, Optimism, and Arbitrum.$0.02
gas-feesEstimates EIP-1559 transaction fees on Base, Ethereum, Optimism, and Arbitrum.$0.02
gas-now-baseReal-time gas price oracle for Base, Ethereum, Optimism, Arbitrum, and Polygon.$0.02
SEE ALSO
agentutility · edgemarket · x402 · mcp · llms.txt · registry.json · bazaar.x402.org