← Documentation
/ eth_newFilter
Eth New Filter
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
Join AWS, Dust Labs & OrangeDAO at QuickPitch. Win $80k — Apply Today.
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.
The API credit value for this method is 2 . To learn more about API credits and each method's value, visit the API Credits page.
Parameters:
fromBlock - string - (optional) 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. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain
toBlock - string - (optional) 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. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain
address - string - (optional) The contract address or a list of addresses from which logs should originate
topics - string - (optional) An array of DATA topics and also, the topics are order-dependent. Visit here to learn more about topics
Returns:
Code Examples:
const ethers = require("ethers");
const filter = {
fromBlock: "0xe20360",
toBlock: "0xe20411",
address: "0x6B175474E89094C44Da98b954EedeAC495271d0F",
topics: [],
};
(async () => {
const provider = new ethers.providers.JsonRpcProvider("http://sample-endpoint-name.network.quiknode.pro/token-goes-here/");
const filterId = await provider.send("eth_newFilter", [filter]);
console.log(filterId);
})();
require 'ethereum.rb'
client = Ethereum::HttpClient.new('http://sample-endpoint-name.network.quiknode.pro/token-goes-here/')
filter = {
fromBlock: "0xe20360",
toBlock: "0xe20411",
address: "0x6B175474E89094C44Da98b954EedeAC495271d0F",
topics: []
}
response = client.eth_new_filter(filter)
puts response["result"]
import requests
import json
url = "http://sample-endpoint-name.network.quiknode.pro/token-goes-here/"
payload = json.dumps({
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0xe20360",
"toBlock": "0xe20411",
"address": "0x6b175474e89094c44da98b954eedeac495271d0f",
"topics": []
}
],
"id": 1
})
headers = {
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
curl http://sample-endpoint-name.network.quiknode.pro/token-goes-here/ \
-X POST \
-H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"fromBlock": "0xe20360", "toBlock": "0xe20411", "address": "0x6b175474e89094c44da98b954eedeac495271d0f","topics": []}],"id":1}'
var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
var raw = JSON.stringify({
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0xe20360",
"toBlock": "0xe20411",
"address": "0x6b175474e89094c44da98b954eedeac495271d0f",
"topics": []
}
],
"id": 1
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("http://sample-endpoint-name.network.quiknode.pro/token-goes-here/", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
require "uri"
require "json"
require "net/http"
url = URI("http://sample-endpoint-name.network.quiknode.pro/token-goes-here/")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
"jsonrpc": "2.0",
"method": "eth_newFilter",
"params": [
{
"fromBlock": "0xe20360",
"toBlock": "0xe20411",
"address": "0x6b175474e89094c44da98b954eedeac495271d0f",
"topics": []
}
],
"id": 1
})
response = https.request(request)
puts response.read_body
from web3 import Web3, HTTPProvider
w3 = Web3(HTTPProvider('http://sample-endpoint-name.network.quiknode.pro/token-goes-here/'))
newFilterId = w3.eth.filter({
'fromBlock': "0xe20360",
'toBlock': "0xe20411",
'address': '0x6B175474E89094C44Da98b954EedeAC495271d0F',
'topics': []
})
print(newFilterId)