trace_filter RPC Method

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.

Deprecation Notice

This method will be deprecated on Amoy Testnet (July 1, 2026) and Mainnet (July 15, 2026) following Polygon Labs' sunset of Erigon. Use eth_getLogs for range-based filtering as an alternative.

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

Loading...

fromBlock

string

Loading...

toBlock

string

Loading...

fromAddress

array

Loading...

toAddress

array

Loading...

after

integer

Loading...

count

integer

Loading...

Returns

array

Loading...

action

Loading...

action

Loading...

from

Loading...

callType

Loading...

gas

Loading...

input

Loading...

to

Loading...

value

Loading...

blockHash

Loading...

blockNumber

Loading...

result

Loading...

gasUsed

Loading...

output

Loading...

subtraces

Loading...

traceAddress

Loading...

transactionHash

Loading...

transactionPosition

Loading...

type

Loading...

Request

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

1
curl -X POST "https://docs-demo.matic.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "trace_filter",
6
  "params": [
7
    {
8
      "fromBlock": "0xccb943",
9
      "toBlock": "0xccb943",
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.matic.quiknode.pro/");
5
    const response = await provider.send("trace_filter", [
6
    {
7
        "fromBlock": "0xccb943",
8
        "toBlock": "0xccb943",
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.matic.quiknode.pro/");
5
    const response = await provider.send("trace_filter", [
6
    {
7
        "fromBlock": "0xccb943",
8
        "toBlock": "0xccb943",
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.matic.quiknode.pro/'))
3
response = w3.provider.make_request("trace_filter", [{"fromBlock":"0xccb943","toBlock":"0xccb943","fromAddress":["0xEdC763b3e418cD14767b3Be02b667619a6374076"]}])
4
print(response)

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.matic.quiknode.pro/'))
3
response = w3.provider.make_request("trace_filter", [{"fromBlock":"0xccb943","toBlock":"0xccb943","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.matic.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'trace_filter',
10
        params: [
11
          {
12
            "fromBlock": "0xccb943",
13
            "toBlock": "0xccb943",
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.matic.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'trace_filter',
10
        params: [
11
          {
12
            "fromBlock": "0xccb943",
13
            "toBlock": "0xccb943",
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": "0xccb943",
10
    "toBlock": "0xccb943",
11
    "fromAddress": [
12
      "0xEdC763b3e418cD14767b3Be02b667619a6374076"
13
    ]
14
  }
15
],
16
  undefined,
17
  'https://docs-demo.matic.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": "0xccb943",
10
    "toBlock": "0xccb943",
11
    "fromAddress": [
12
      "0xEdC763b3e418cD14767b3Be02b667619a6374076"
13
    ]
14
  }
15
],
16
  undefined,
17
  'https://docs-demo.matic.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": "0xccb943",
11
                "toBlock": "0xccb943",
12
                "fromAddress": [
13
                    "0xEdC763b3e418cD14767b3Be02b667619a6374076"
14
                ]
15
            }
16
        ],
17
        endpoint_url="https://docs-demo.matic.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": "0xccb943",
11
                "toBlock": "0xccb943",
12
                "fromAddress": [
13
                    "0xEdC763b3e418cD14767b3Be02b667619a6374076"
14
                ]
15
            }
16
        ],
17
        endpoint_url="https://docs-demo.matic.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" => "0xccb943",
10
      "toBlock" => "0xccb943",
11
      "fromAddress" => [
12
        "0xEdC763b3e418cD14767b3Be02b667619a6374076"
13
      ]
14
    }
15
  ],
16
  endpoint_url: "https://docs-demo.matic.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" => "0xccb943",
10
      "toBlock" => "0xccb943",
11
      "fromAddress" => [
12
        "0xEdC763b3e418cD14767b3Be02b667619a6374076"
13
      ]
14
    }
15
  ],
16
  endpoint_url: "https://docs-demo.matic.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": "0xccb943",
13
        "toBlock": "0xccb943",
14
        "fromAddress": [
15
            "0xEdC763b3e418cD14767b3Be02b667619a6374076"
16
        ]
17
    }
18
])),
19
            None,
20
            Some("https://docs-demo.matic.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": "0xccb943",
13
        "toBlock": "0xccb943",
14
        "fromAddress": [
15
            "0xEdC763b3e418cD14767b3Be02b667619a6374076"
16
        ]
17
    }
18
])),
19
            None,
20
            Some("https://docs-demo.matic.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":"0xccb943","toBlock":"0xccb943","fromAddress":["0xEdC763b3e418cD14767b3Be02b667619a6374076"]}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.matic.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":"0xccb943","toBlock":"0xccb943","fromAddress":["0xEdC763b3e418cD14767b3Be02b667619a6374076"]}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.matic.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.matic.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "trace_filter",
9
  "params": [
10
    {
11
      "fromBlock": "0xccb943",
12
      "toBlock": "0xccb943",
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.matic.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "trace_filter",
9
  "params": [
10
    {
11
      "fromBlock": "0xccb943",
12
      "toBlock": "0xccb943",
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.matic.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "trace_filter",
11
  params: [{"fromBlock":"0xccb943","toBlock":"0xccb943","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.matic.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "trace_filter",
11
  params: [{"fromBlock":"0xccb943","toBlock":"0xccb943","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
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": []
5
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free