We're now supporting Polygon zkEVM!
Learn more here.


trace_filter RPC Method

The API credit value for this method is 6 . To learn more about API credits and each method's value, visit the API Credits page.

Please note that this RPC method requires the Trace Mode add-on enabled on your QuickNode endpoint. Also, it is supported only on OpenEthereum & Erigon.


  1. object - The filter object

    fromBlock - (optional) The Quantity or Tag from this block

    toBlock - (optional) The Quantity or Tag to this block

    fromAddress - (optional) An array addresses of the senders

    toAddress - (optional) An array addresses of the receivers

    after - (optional) The offset trace number

    count - (optional) The integer number of traces to display in a batch


  1. array - The block traces, which have the following fields (please note that all return types are hexadecimal representations of their data type unless otherwise stated):

    action - The ParityTrace object, which has the following fields:

    from - The address of the sender

    callType - The type of method such as call, delegatecall

    gas - The gas provided by the sender, encoded as hexadecimal

    input - The data sent along with the transaction

    to - The address of the receiver

    value - The integer of the value sent with this transaction, encoded as hexadecimal

    blockHash - The hash of the block where this transaction was in

    blockNumber - The block number where this transaction was in

    result - The ParityTraceResult object which has the following fields:

    gasUsed - The amount of gas used by this specific transaction alone

    output - The value returned by the contract call, and it only contains the actual value sent by the RETURN method. If the RETURN method was not executed, the output is empty bytes

    subtraces - The traces of contract calls made by the transaction

    traceAddress - The list of addresses where the call executed, the address of the parents and the order of the current sub call

    transactionHash - The hash of the transaction

    transactionPosition - The transaction position

    type - The value of the method such as call or create

Code Examples:

require 'eth'

client = Eth::Client.create 'http://sample-endpoint-name.network.quiknode.pro/token-goes-here/'
payload = {
    "jsonrpc": "2.0",
    "method": "trace_filter",
    "params": [{"fromBlock":"0xccb943","toBlock":"0xccb943","fromAddress":["0xEdC763b3e418cD14767b3Be02b667619a6374076"]}],
    "id": "1"

response = client.send(payload.to_json)
puts response
Ready to get started? Create a free account