Parameters

filter ID

string

REQUIRED

The filter id that is returned from eth_newFilter, eth_newBlockFilter or eth_newPendingTransactionFilter

Returns

array

array

An array of one of the following, depending on the filter type, or empty if there were no changes since the last poll:

address

string

address

blockHash

string

blockHash

blockNumber

string

blockNumber

data

string

data

logIndex

string

logIndex

removed

boolean

removed

topics

array

topics

transactionHash

string

transactionHash

transactionIndex

string

transactionIndex

Request

1
curl -X POST "https://docs-demo.bsc.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_getFilterChanges",
6
  "params": [
7
    "YOUR_FILTER_ID"
8
  ],
9
  "id": 1
10
}'

1
curl -X POST "https://docs-demo.bsc.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_getFilterChanges",
6
  "params": [
7
    "YOUR_FILTER_ID"
8
  ],
9
  "id": 1
10
}'

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.bsc.quiknode.pro/");
5
    const response = await provider.send("eth_getFilterChanges", [
6
    "YOUR_FILTER_ID"
7
]);
8
    console.log(response);
9
}
10

11
main();

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.bsc.quiknode.pro/");
5
    const response = await provider.send("eth_getFilterChanges", [
6
    "YOUR_FILTER_ID"
7
]);
8
    console.log(response);
9
}
10

11
main();

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.bsc.quiknode.pro/'))
3
response = w3.provider.make_request("eth_getFilterChanges", ["YOUR_FILTER_ID"])
4
print(response)

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.bsc.quiknode.pro/'))
3
response = w3.provider.make_request("eth_getFilterChanges", ["YOUR_FILTER_ID"])
4
print(response)

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

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

8
    const result = await client.request({
9
        method: 'eth_getFilterChanges',
10
        params: [
11
          "YOUR_FILTER_ID"
12
        ]
13
    })
14

15
    console.log(result)
16
}
17

18
main()

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

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

8
    const result = await client.request({
9
        method: 'eth_getFilterChanges',
10
        params: [
11
          "YOUR_FILTER_ID"
12
        ]
13
    })
14

15
    console.log(result)
16
}
17

18
main()

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

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'eth_getFilterChanges',
7
  [
8
  "YOUR_FILTER_ID"
9
],
10
  undefined,
11
  'https://docs-demo.bsc.quiknode.pro/'
12
)
13

14
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_getFilterChanges',
7
  [
8
  "YOUR_FILTER_ID"
9
],
10
  undefined,
11
  'https://docs-demo.bsc.quiknode.pro/'
12
)
13

14
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_getFilterChanges",
8
        [
9
            "YOUR_FILTER_ID"
10
        ],
11
        endpoint_url="https://docs-demo.bsc.quiknode.pro/",
12
    )
13
    print(result)
14

15
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_getFilterChanges",
8
        [
9
            "YOUR_FILTER_ID"
10
        ],
11
        endpoint_url="https://docs-demo.bsc.quiknode.pro/",
12
    )
13
    print(result)
14

15
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_getFilterChanges",
7
  params: [
8
    "YOUR_FILTER_ID"
9
  ],
10
  endpoint_url: "https://docs-demo.bsc.quiknode.pro/"
11
)
12

13
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_getFilterChanges",
7
  params: [
8
    "YOUR_FILTER_ID"
9
  ],
10
  endpoint_url: "https://docs-demo.bsc.quiknode.pro/"
11
)
12

13
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_getFilterChanges",
10
            Some(serde_json::json!([
11
    "YOUR_FILTER_ID"
12
])),
13
            None,
14
            Some("https://docs-demo.bsc.quiknode.pro/".into()),
15
        )
16
        .await?;
17

18
    println!("{result}");
19
    Ok(())
20
}

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_getFilterChanges",
10
            Some(serde_json::json!([
11
    "YOUR_FILTER_ID"
12
])),
13
            None,
14
            Some("https://docs-demo.bsc.quiknode.pro/".into()),
15
        )
16
        .await?;
17

18
    println!("{result}");
19
    Ok(())
20
}

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'eth_getFilterChanges',
4
    params: ["YOUR_FILTER_ID"],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.bsc.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_getFilterChanges',
4
    params: ["YOUR_FILTER_ID"],
5
    id: 1
6
}
7

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

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "eth_getFilterChanges",
9
  "params": [
10
    "YOUR_FILTER_ID"
11
  ],
12
  "id": 1
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

18
response = requests.request("POST", url, headers=headers, data=payload)
19

20
print(response.text)

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "eth_getFilterChanges",
9
  "params": [
10
    "YOUR_FILTER_ID"
11
  ],
12
  "id": 1
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

18
response = requests.request("POST", url, headers=headers, data=payload)
19

20
print(response.text)

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

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

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_getFilterChanges",
11
  params: ["YOUR_FILTER_ID"]
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.bsc.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_getFilterChanges",
11
  params: ["YOUR_FILTER_ID"]
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
      "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
7
      "blockHash": "0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
8
      "blockNumber": "0xc5043f",
9
      "data": "0x000000000000000000000000000000000000000000000000058d15e176280000",
10
      "logIndex": "0x0",
11
      "removed": false,
12
      "topics": [
13
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
14
        "0x0000000000000000000000008894e0a0c962cb723c1976a4421c95949be2d4e3",
15
        "0x0000000000000000000000002c46b28e4bac6b0188baf722f17f5f36e2170330"
16
      ],
17
      "transactionHash": "0xf79d96d5f3d5c82088cd79ad5fc5c5bbe9c8c805221e30041133b69b49162866",
18
      "transactionIndex": "0x0"
19
    },
20
    {
21
      "address": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f",
22
      "blockHash": "0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
23
      "blockNumber": "0xc5043f",
24
      "data": "0x000000000000000000000000f7ae43fabe91b091e3bae07d91b5c8758e97c12b00000000000000000000000081b7e08f65bdf5648606c89998a9cc8164397647",
25
      "logIndex": "0x1",
26
      "removed": false,
27
      "topics": [
28
        "0x0d3648bd0f6ba80134a33ba9275ac585d9d315f0ad8355cddefde31afa28d0e9",
29
        "0x000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
30
        "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
31
      ],
32
      "transactionHash": "0x950395ad0360cb32373c86cc9ff0169cc2aaaa04f9dd42a3ab6aa8b47d3cb2cf",
33
      "transactionIndex": "0x1"
34
    }
35
  ]
36
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": [
5
    {
6
      "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
7
      "blockHash": "0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
8
      "blockNumber": "0xc5043f",
9
      "data": "0x000000000000000000000000000000000000000000000000058d15e176280000",
10
      "logIndex": "0x0",
11
      "removed": false,
12
      "topics": [
13
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
14
        "0x0000000000000000000000008894e0a0c962cb723c1976a4421c95949be2d4e3",
15
        "0x0000000000000000000000002c46b28e4bac6b0188baf722f17f5f36e2170330"
16
      ],
17
      "transactionHash": "0xf79d96d5f3d5c82088cd79ad5fc5c5bbe9c8c805221e30041133b69b49162866",
18
      "transactionIndex": "0x0"
19
    },
20
    {
21
      "address": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f",
22
      "blockHash": "0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
23
      "blockNumber": "0xc5043f",
24
      "data": "0x000000000000000000000000f7ae43fabe91b091e3bae07d91b5c8758e97c12b00000000000000000000000081b7e08f65bdf5648606c89998a9cc8164397647",
25
      "logIndex": "0x1",
26
      "removed": false,
27
      "topics": [
28
        "0x0d3648bd0f6ba80134a33ba9275ac585d9d315f0ad8355cddefde31afa28d0e9",
29
        "0x000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
30
        "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
31
      ],
32
      "transactionHash": "0x950395ad0360cb32373c86cc9ff0169cc2aaaa04f9dd42a3ab6aa8b47d3cb2cf",
33
      "transactionIndex": "0x1"
34
    }
35
  ]
36
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free