JSON-RPCMethods

trace_transaction: parameters, returns and CU

Return all execution traces produced by a transaction on chains with Parity/OpenEthereum trace modules.

Summary

Return all traces produced during the execution of a transaction. Official documentation

Compute units (CU) and pricing

CU per call

100 CU

Price per 1M calls (USD)

$10.00

Parameters

ParameterTypeDescription
transactionHashHASH32-byte transaction hash to inspect as 0x-prefixed hex.

Returns

  • Type: ARRAY
  • Description: Array of trace objects recorded during transaction execution, in execution order.

Notes

trace_transaction is supported on chains with Parity/OpenEthereum-style trace modules enabled; see the availability table below. A block outside the state window returns -32011, and an unknown hash returns -32000; neither is billed. For Geth-style call trees, use debug_traceTransaction.

Request example

export BLOCKVECTRA_API_KEY=rgw_your_api_key

curl -X POST "https://api.blockvectra.com/v1/eth_mainnet" \
  -H 'Content-Type: application/json' \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_transaction",
    "params": [
      "<transactionHash>"
    ],
    "id": 1
  }'

Supported chains

Available on all supported chains except: Arbitrum One (arb_mainnet), Arbitrum Nova (arbnova_mainnet), Arc (arc_mainnet), Avalanche C-Chain (avax_mainnet), Base (base_mainnet), Berachain (berachain_mainnet), Boba (boba_mainnet), BNB Smart Chain (bsc_mainnet), Celo (celo_mainnet), Ethereum Sepolia (eth_sepolia), Fraxtal (fraxtal_mainnet), Gnosis (gnosis_mainnet), HyperEVM (hyperevm_mainnet), Ink (ink_mainnet), Katana (katana_mainnet), Linea (linea_mainnet), Metal L2 (metall2_mainnet), Mode (mode_mainnet), OP Mainnet (op_mainnet), Polygon (polygon_mainnet), Robinhood Chain (robinhood_mainnet), Robinhood Chain Testnet (robinhood_testnet), Rootstock (rootstock_mainnet), Soneium (soneium_mainnet), Sonic (sonic_mainnet), Unichain (unichain_mainnet), World Chain (world_mainnet), X Layer (xlayer_mainnet), Zora (zora_mainnet).

Last updated: