Parameters

object

object

REQUIRED

The transaction response object which contains the following filter information:

fromBlock

string

REQUIRED

The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators

toBlock

string

REQUIRED

The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators

address

string

The contract address or a list of addresses from which logs should originate

topics

array

An array of DATA topics and also, the topics are order-dependent. Visit here to learn more about topics

Returns

result

string

It returns a filter id to be used when calling eth_getFilterChanges

Request

1
curl -X POST "https://docs-demo.ritual-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_newFilter",
6
  "params": [
7
    {
8
      "fromBlock": "0x50000",
9
      "toBlock": "0x50000",
10
      "address": "0x0000000000000000000000000000000000002002",
11
      "topics": []
12
    }
13
  ],
14
  "id": 1
15
}'

1
curl -X POST "https://docs-demo.ritual-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_newFilter",
6
  "params": [
7
    {
8
      "fromBlock": "0x50000",
9
      "toBlock": "0x50000",
10
      "address": "0x0000000000000000000000000000000000002002",
11
      "topics": []
12
    }
13
  ],
14
  "id": 1
15
}'

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.ritual-mainnet.quiknode.pro/");
5
    const response = await provider.send("eth_newFilter", [
6
    {
7
        "fromBlock": "0x50000",
8
        "toBlock": "0x50000",
9
        "address": "0x0000000000000000000000000000000000002002",
10
        "topics": []
11
    }
12
]);
13
    console.log(response);
14
}
15

16
main();

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.ritual-mainnet.quiknode.pro/");
5
    const response = await provider.send("eth_newFilter", [
6
    {
7
        "fromBlock": "0x50000",
8
        "toBlock": "0x50000",
9
        "address": "0x0000000000000000000000000000000000002002",
10
        "topics": []
11
    }
12
]);
13
    console.log(response);
14
}
15

16
main();

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.ritual-mainnet.quiknode.pro/'))
3
response = w3.provider.make_request("eth_newFilter", [{"fromBlock":"0x50000","toBlock":"0x50000","address":"0x0000000000000000000000000000000000002002","topics":[]}])
4
print(response)

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.ritual-mainnet.quiknode.pro/'))
3
response = w3.provider.make_request("eth_newFilter", [{"fromBlock":"0x50000","toBlock":"0x50000","address":"0x0000000000000000000000000000000000002002","topics":[]}])
4
print(response)

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

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

8
    const result = await client.request({
9
        method: 'eth_newFilter',
10
        params: [
11
          {
12
            "fromBlock": "0x50000",
13
            "toBlock": "0x50000",
14
            "address": "0x0000000000000000000000000000000000002002",
15
            "topics": []
16
          }
17
        ]
18
    })
19

20
    console.log(result)
21
}
22

23
main()

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

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

8
    const result = await client.request({
9
        method: 'eth_newFilter',
10
        params: [
11
          {
12
            "fromBlock": "0x50000",
13
            "toBlock": "0x50000",
14
            "address": "0x0000000000000000000000000000000000002002",
15
            "topics": []
16
          }
17
        ]
18
    })
19

20
    console.log(result)
21
}
22

23
main()

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

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'eth_newFilter',
7
  [
8
  {
9
    "fromBlock": "0x50000",
10
    "toBlock": "0x50000",
11
    "address": "0x0000000000000000000000000000000000002002",
12
    "topics": []
13
  }
14
],
15
  undefined,
16
  'https://docs-demo.ritual-mainnet.quiknode.pro/'
17
)
18

19
console.log(result)

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

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'eth_newFilter',
7
  [
8
  {
9
    "fromBlock": "0x50000",
10
    "toBlock": "0x50000",
11
    "address": "0x0000000000000000000000000000000000002002",
12
    "topics": []
13
  }
14
],
15
  undefined,
16
  'https://docs-demo.ritual-mainnet.quiknode.pro/'
17
)
18

19
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
        "eth_newFilter",
8
        [
9
            {
10
                "fromBlock": "0x50000",
11
                "toBlock": "0x50000",
12
                "address": "0x0000000000000000000000000000000000002002",
13
                "topics": []
14
            }
15
        ],
16
        endpoint_url="https://docs-demo.ritual-mainnet.quiknode.pro/",
17
    )
18
    print(result)
19

20
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
        "eth_newFilter",
8
        [
9
            {
10
                "fromBlock": "0x50000",
11
                "toBlock": "0x50000",
12
                "address": "0x0000000000000000000000000000000000002002",
13
                "topics": []
14
            }
15
        ],
16
        endpoint_url="https://docs-demo.ritual-mainnet.quiknode.pro/",
17
    )
18
    print(result)
19

20
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: "eth_newFilter",
7
  params: [
8
    {
9
      "fromBlock" => "0x50000",
10
      "toBlock" => "0x50000",
11
      "address" => "0x0000000000000000000000000000000000002002",
12
      "topics" => []
13
    }
14
  ],
15
  endpoint_url: "https://docs-demo.ritual-mainnet.quiknode.pro/"
16
)
17

18
puts result

1
require "quicknode_sdk"
2

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

5
result = qn.rpc.call(
6
  method: "eth_newFilter",
7
  params: [
8
    {
9
      "fromBlock" => "0x50000",
10
      "toBlock" => "0x50000",
11
      "address" => "0x0000000000000000000000000000000000002002",
12
      "topics" => []
13
    }
14
  ],
15
  endpoint_url: "https://docs-demo.ritual-mainnet.quiknode.pro/"
16
)
17

18
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
            "eth_newFilter",
10
            Some(serde_json::json!([
11
    {
12
        "fromBlock": "0x50000",
13
        "toBlock": "0x50000",
14
        "address": "0x0000000000000000000000000000000000002002",
15
        "topics": []
16
    }
17
])),
18
            None,
19
            Some("https://docs-demo.ritual-mainnet.quiknode.pro/".into()),
20
        )
21
        .await?;
22

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

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
            "eth_newFilter",
10
            Some(serde_json::json!([
11
    {
12
        "fromBlock": "0x50000",
13
        "toBlock": "0x50000",
14
        "address": "0x0000000000000000000000000000000000002002",
15
        "topics": []
16
    }
17
])),
18
            None,
19
            Some("https://docs-demo.ritual-mainnet.quiknode.pro/".into()),
20
        )
21
        .await?;
22

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

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'eth_newFilter',
4
    params: [{"fromBlock":"0x50000","toBlock":"0x50000","address":"0x0000000000000000000000000000000000002002","topics":[]}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.ritual-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: 'eth_newFilter',
4
    params: [{"fromBlock":"0x50000","toBlock":"0x50000","address":"0x0000000000000000000000000000000000002002","topics":[]}],
5
    id: 1
6
}
7

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

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

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

25
print(response.text)

1
import requests
2
import json
3

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

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

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

25
print(response.text)

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

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

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_newFilter",
11
  params: [{"fromBlock":"0x50000","toBlock":"0x50000","address":"0x0000000000000000000000000000000000002002","topics":[]}]
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.ritual-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_newFilter",
11
  params: [{"fromBlock":"0x50000","toBlock":"0x50000","address":"0x0000000000000000000000000000000000002002","topics":[]}]
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": "0xceb61c4cd786057c26d3c0f5b07b8b13"
5
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": "0xceb61c4cd786057c26d3c0f5b07b8b13"
5
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free