debug_traceCall: parameters, returns and CU

Summary

Run an eth_call on top of a given block state and generate an execution trace. Official documentation

Compute units (CU) and pricing

CU per call

100 CU

Price per 1M calls (USD)

$10.00

Parameters

Parameter	Type	Description
`call`	`object`	Transaction call object, containing from, to, data, gas, gasPrice, value.
`block`	`QUANTITY\|TAG\|HASH`	Block number (0x-prefixed hexadecimal quantity), block hash, or the 'latest' / 'pending' tag to trace against; safe, finalized and earliest return -32011.
`options`	`object`	Trace options object (optional): tracer is callTracer, flatCallTracer, prestateTracer, 4byteTracer or noopTracer, omitted uses the default struct logger, and any other value returns -32602 tracer not allowed; tracerConfig passes tracer-specific options (such as onlyTopCall and withLog for callTracer, diffMode for prestateTracer); timeout is at most 30s; reexec sets the block number to re-execute the transaction at; stateOverrides, blockOverrides and txIndex are also supported.

Returns

Type: OBJECT
Description: Execution trace result object matching the requested tracer (CallFrame tree for callTracer).

Notes

The target block must be within the chain's state window (state_window_blocks); out-of-window requests return -32011 (not billed).

Request example

export BLOCKVECTRA_API_KEY=rgw_your_api_key

curl -X POST "https://api.blockvectra.com/v1/robinhood_mainnet" \
  -H 'Content-Type: application/json' \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "debug_traceCall",
    "params": [
      {
        "to": "<toAddress>",
        "data": "<callData>"
      },
      "latest",
      {
        "tracer": "callTracer"
      }
    ],
    "id": 1
  }'

Supported chains

Available on all supported chains except: Base (base_mainnet), BNB Smart Chain (bsc_mainnet), Ethereum Sepolia (eth_sepolia), HyperEVM (hyperevm_mainnet).