This RPC method is included in the Free Trial with limited usage. Upgrade your plan to get full access and higher limits. Learn more on our pricing page.

Please be aware that the maximum block range limit for this RPC method is 10,000 blocks for those on paid plans. Consider dividing your queries into smaller segments to enhance response times and manage errors more effectively. For further details on the block range limit and strategies for mitigating it, please consult the FAQ

Parameters

object

object

The filter object

fromBlock

string

The starting block number for the filter in hexadecimal format

toBlock

string

The ending block number for the filter in hexadecimal format

fromAddress

array

An array of sender addresses to filter by

toAddress

array

An array of receiver addresses to filter by

after

integer

The offset trace number for pagination

count

integer

The number of traces to display in a batch

Returns

result

array

An array of trace objects that match the given filter

action

object

The trace action object containing details of the call

from

string

The address of the sender

callType

string

The type of method such as call, delegatecall, staticcall

gas

string

The gas provided by the sender encoded as hexadecimal

input

string

The data sent along with the transaction

to

string

The address of the receiver

value

string

The value sent with this transaction encoded as hexadecimal

blockHash

string

The hash of the block containing this transaction

blockNumber

string

The block number containing this transaction encoded as hexadecimal

result

object

The execution result object of the trace

gasUsed

string

The amount of gas used by this specific trace

output

string

The value returned by the call, empty if no RETURN was executed

subtraces

integer

The number of subtraces (internal calls) in this trace

traceAddress

array

The list showing the nested call structure of this trace

transactionHash

string

The hash of the transaction

transactionPosition

integer

The transaction index position within the block

type

string

The type of trace, such as call or create

Request

1
curl -X POST "https://docs-demo.tempo-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "trace_filter",
6
  "params": [
7
    {
8
      "fromBlock": "0x2ac5b2",
9
      "toBlock": "0x2ac5f2",
10
      "fromAddress": [
11
        "0xEdC763b3e418cD14767b3Be02b667619a6374076"
12
      ]
13
    }
14
  ],
15
  "id": 1
16
}'

1
curl -X POST "https://docs-demo.tempo-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "trace_filter",
6
  "params": [
7
    {
8
      "fromBlock": "0x2ac5b2",
9
      "toBlock": "0x2ac5f2",
10
      "fromAddress": [
11
        "0xEdC763b3e418cD14767b3Be02b667619a6374076"
12
      ]
13
    }
14
  ],
15
  "id": 1
16
}'

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.tempo-mainnet.quiknode.pro/");
5
    const response = await provider.send("trace_filter", [
6
    {
7
        "fromBlock": "0x2ac5b2",
8
        "toBlock": "0x2ac5f2",
9
        "fromAddress": [
10
            "0xEdC763b3e418cD14767b3Be02b667619a6374076"
11
        ]
12
    }
13
]);
14
    console.log(response);
15
}
16

17
main();

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.tempo-mainnet.quiknode.pro/");
5
    const response = await provider.send("trace_filter", [
6
    {
7
        "fromBlock": "0x2ac5b2",
8
        "toBlock": "0x2ac5f2",
9
        "fromAddress": [
10
            "0xEdC763b3e418cD14767b3Be02b667619a6374076"
11
        ]
12
    }
13
]);
14
    console.log(response);
15
}
16

17
main();

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.tempo-mainnet.quiknode.pro/'))
3
response = w3.provider.make_request("trace_filter", [{"fromBlock":"0x2ac5b2","toBlock":"0x2ac5f2","fromAddress":["0xEdC763b3e418cD14767b3Be02b667619a6374076"]}])
4
print(response)

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.tempo-mainnet.quiknode.pro/'))
3
response = w3.provider.make_request("trace_filter", [{"fromBlock":"0x2ac5b2","toBlock":"0x2ac5f2","fromAddress":["0xEdC763b3e418cD14767b3Be02b667619a6374076"]}])
4
print(response)

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.tempo-mainnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'trace_filter',
10
        params: [
11
          {
12
            "fromBlock": "0x2ac5b2",
13
            "toBlock": "0x2ac5f2",
14
            "fromAddress": [
15
              "0xEdC763b3e418cD14767b3Be02b667619a6374076"
16
            ]
17
          }
18
        ]
19
    })
20

21
    console.log(result)
22
}
23

24
main()

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.tempo-mainnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'trace_filter',
10
        params: [
11
          {
12
            "fromBlock": "0x2ac5b2",
13
            "toBlock": "0x2ac5f2",
14
            "fromAddress": [
15
              "0xEdC763b3e418cD14767b3Be02b667619a6374076"
16
            ]
17
          }
18
        ]
19
    })
20

21
    console.log(result)
22
}
23

24
main()

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'trace_filter',
7
  [
8
  {
9
    "fromBlock": "0x2ac5b2",
10
    "toBlock": "0x2ac5f2",
11
    "fromAddress": [
12
      "0xEdC763b3e418cD14767b3Be02b667619a6374076"
13
    ]
14
  }
15
],
16
  undefined,
17
  'https://docs-demo.tempo-mainnet.quiknode.pro/'
18
)
19

20
console.log(result)

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'trace_filter',
7
  [
8
  {
9
    "fromBlock": "0x2ac5b2",
10
    "toBlock": "0x2ac5f2",
11
    "fromAddress": [
12
      "0xEdC763b3e418cD14767b3Be02b667619a6374076"
13
    ]
14
  }
15
],
16
  undefined,
17
  'https://docs-demo.tempo-mainnet.quiknode.pro/'
18
)
19

20
console.log(result)

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "trace_filter",
8
        [
9
            {
10
                "fromBlock": "0x2ac5b2",
11
                "toBlock": "0x2ac5f2",
12
                "fromAddress": [
13
                    "0xEdC763b3e418cD14767b3Be02b667619a6374076"
14
                ]
15
            }
16
        ],
17
        endpoint_url="https://docs-demo.tempo-mainnet.quiknode.pro/",
18
    )
19
    print(result)
20

21
asyncio.run(main())

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "trace_filter",
8
        [
9
            {
10
                "fromBlock": "0x2ac5b2",
11
                "toBlock": "0x2ac5f2",
12
                "fromAddress": [
13
                    "0xEdC763b3e418cD14767b3Be02b667619a6374076"
14
                ]
15
            }
16
        ],
17
        endpoint_url="https://docs-demo.tempo-mainnet.quiknode.pro/",
18
    )
19
    print(result)
20

21
asyncio.run(main())

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "trace_filter",
7
  params: [
8
    {
9
      "fromBlock" => "0x2ac5b2",
10
      "toBlock" => "0x2ac5f2",
11
      "fromAddress" => [
12
        "0xEdC763b3e418cD14767b3Be02b667619a6374076"
13
      ]
14
    }
15
  ],
16
  endpoint_url: "https://docs-demo.tempo-mainnet.quiknode.pro/"
17
)
18

19
puts result

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "trace_filter",
7
  params: [
8
    {
9
      "fromBlock" => "0x2ac5b2",
10
      "toBlock" => "0x2ac5f2",
11
      "fromAddress" => [
12
        "0xEdC763b3e418cD14767b3Be02b667619a6374076"
13
      ]
14
    }
15
  ],
16
  endpoint_url: "https://docs-demo.tempo-mainnet.quiknode.pro/"
17
)
18

19
puts result

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "trace_filter",
10
            Some(serde_json::json!([
11
    {
12
        "fromBlock": "0x2ac5b2",
13
        "toBlock": "0x2ac5f2",
14
        "fromAddress": [
15
            "0xEdC763b3e418cD14767b3Be02b667619a6374076"
16
        ]
17
    }
18
])),
19
            None,
20
            Some("https://docs-demo.tempo-mainnet.quiknode.pro/".into()),
21
        )
22
        .await?;
23

24
    println!("{result}");
25
    Ok(())
26
}

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "trace_filter",
10
            Some(serde_json::json!([
11
    {
12
        "fromBlock": "0x2ac5b2",
13
        "toBlock": "0x2ac5f2",
14
        "fromAddress": [
15
            "0xEdC763b3e418cD14767b3Be02b667619a6374076"
16
        ]
17
    }
18
])),
19
            None,
20
            Some("https://docs-demo.tempo-mainnet.quiknode.pro/".into()),
21
        )
22
        .await?;
23

24
    println!("{result}");
25
    Ok(())
26
}

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'trace_filter',
4
    params: [{"fromBlock":"0x2ac5b2","toBlock":"0x2ac5f2","fromAddress":["0xEdC763b3e418cD14767b3Be02b667619a6374076"]}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.tempo-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'trace_filter',
4
    params: [{"fromBlock":"0x2ac5b2","toBlock":"0x2ac5f2","fromAddress":["0xEdC763b3e418cD14767b3Be02b667619a6374076"]}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.tempo-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.tempo-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "trace_filter",
9
  "params": [
10
    {
11
      "fromBlock": "0x2ac5b2",
12
      "toBlock": "0x2ac5f2",
13
      "fromAddress": [
14
        "0xEdC763b3e418cD14767b3Be02b667619a6374076"
15
      ]
16
    }
17
  ],
18
  "id": 1
19
})
20
headers = {
21
  'Content-Type': 'application/json'
22
}
23

24
response = requests.request("POST", url, headers=headers, data=payload)
25

26
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.tempo-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "trace_filter",
9
  "params": [
10
    {
11
      "fromBlock": "0x2ac5b2",
12
      "toBlock": "0x2ac5f2",
13
      "fromAddress": [
14
        "0xEdC763b3e418cD14767b3Be02b667619a6374076"
15
      ]
16
    }
17
  ],
18
  "id": 1
19
})
20
headers = {
21
  'Content-Type': 'application/json'
22
}
23

24
response = requests.request("POST", url, headers=headers, data=payload)
25

26
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.tempo-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "trace_filter",
11
  params: [{"fromBlock":"0x2ac5b2","toBlock":"0x2ac5f2","fromAddress":["0xEdC763b3e418cD14767b3Be02b667619a6374076"]}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.tempo-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "trace_filter",
11
  params: [{"fromBlock":"0x2ac5b2","toBlock":"0x2ac5f2","fromAddress":["0xEdC763b3e418cD14767b3Be02b667619a6374076"]}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

Response

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": [
5
    {
6
      "action": {
7
        "from": "0xedc763b3e418cd14767b3be02b667619a6374076",
8
        "callType": "call",
9
        "gas": "0x8462",
10
        "input": "0x095ea7b30000000000000000000000007a250d5630b4cf539739df2c5dacb4c659f2488dffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
11
        "to": "0x7ff4169a6b5122b664c51c95727d87750ec07c84",
12
        "value": "0x0"
13
      },
14
      "blockHash": "0x351e7c06ec010c8f7e7358eb580238dd23e1e129be96822aa93ebb6da08558e6",
15
      "blockNumber": 13416771,
16
      "result": {
17
        "gasUsed": "0x6009",
18
        "output": "0x0000000000000000000000000000000000000000000000000000000000000001"
19
      },
20
      "subtraces": 0,
21
      "traceAddress": [],
22
      "transactionHash": "0x054bbb9fbb855bf23f755e548c7409f45fc5eff8a824b2ad06380bc038d7b049",
23
      "transactionPosition": 54,
24
      "type": "call"
25
    }
26
  ]
27
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": [
5
    {
6
      "action": {
7
        "from": "0xedc763b3e418cd14767b3be02b667619a6374076",
8
        "callType": "call",
9
        "gas": "0x8462",
10
        "input": "0x095ea7b30000000000000000000000007a250d5630b4cf539739df2c5dacb4c659f2488dffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
11
        "to": "0x7ff4169a6b5122b664c51c95727d87750ec07c84",
12
        "value": "0x0"
13
      },
14
      "blockHash": "0x351e7c06ec010c8f7e7358eb580238dd23e1e129be96822aa93ebb6da08558e6",
15
      "blockNumber": 13416771,
16
      "result": {
17
        "gasUsed": "0x6009",
18
        "output": "0x0000000000000000000000000000000000000000000000000000000000000001"
19
      },
20
      "subtraces": 0,
21
      "traceAddress": [],
22
      "transactionHash": "0x054bbb9fbb855bf23f755e548c7409f45fc5eff8a824b2ad06380bc038d7b049",
23
      "transactionPosition": 54,
24
      "type": "call"
25
    }
26
  ]
27
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free