/webhooks/rest/v1/webhooks/test-filter REST API Endpoint

Body Parameters

network

string

REQUIRED

The network to test the filter against. ENUM: "abstract-mainnet", "abstract-testnet", "arbitrum-mainnet", "arbitrum-sepolia", "avalanche-fuji", "avalanche-mainnet", "b3-mainnet", "b3-sepolia", "base-mainnet", "base-sepolia", "bera-mainnet", "bera-bepolia", "bitcoin-mainnet", "blast-mainnet", "blast-sepolia", "bnbchain-mainnet", "bnbchain-testnet", "celo-mainnet", "cyber-mainnet", "cyber-sepolia", "ethereum-holesky", "ethereum-hoodi", "ethereum-mainnet", "ethereum-sepolia", "fantom-mainnet", "flow-mainnet", "flow-testnet", "fuse-flash", "gnosis-mainnet", "gravity-alpham", "hedera-mainnet", "hedera-testnet", "hemi-mainnet", "hemi-testnet", "imx-mainnet", "imx-testnet", "injective-mainnet", "injective-testnet", "ink-mainnet", "ink-sepolia", "joc-mainnet", "kaia-mainnet", "kaia-testnet", "lens-mainnet", "lens-testnet", "linea-mainnet", "mantle-mainnet", "mantle-sepolia", "monad-testnet", "morph-holesky", "morph-mainnet", "nova-mainnet", "omni-mainnet", "omni-omega", "optimism-mainnet", "optimism-sepolia", "peaq-mainnet", "plasma-testnet", "polygon-amoy", "polygon-mainnet", "race-mainnet", "race-testnet", "sahara-testnet", "scroll-mainnet", "scroll-testnet", "sei-mainnet", "sei-testnet", "solana-devnet", "solana-mainnet", "solana-testnet", "soneium-mainnet", "sophon-mainnet", "sophon-testnet", "story-aeneid", "story-mainnet", "tron-mainnet", "unichain-mainnet", "unichain-sepolia", "vana-mainnet", "vana-moksha", "worldchain-mainnet", "worldchain-sepolia", "xai-mainnet", "xai-sepolia", "zerog-galileo", "zkevm-cardona", "zkevm-mainnet", "zksync-mainnet", "zksync-sepolia", "zora-mainnet"

block

string

REQUIRED

The block number to test the filter against.

filter_function

string

REQUIRED

JS/ECMAScript compliant filter encoded in base64.

Returns

filtered_data

object

The filtered data from the test block.

block

string

The block number that was tested.

network

string

The network that was tested.

Request

curl -X POST \
    "https://api.quicknode.com/webhooks/rest/v1/webhooks/test_filter" \
    -H "accept: application/json" \
    -H "Content-Type: application/json" \
    -H "x-api-key: YOUR_API_KEY" \
    -d $'{
  "network": "ethereum-mainnet",
  "block": "17811625",
  "filter_function": "ZnVuY3Rpb24gbWFpbihwYXlsb2FkKSB7CiAgY29uc3QgewogICAgZGF0YSwKICAgIG1ldGFkYXRhLAogIH0gPSBwYXlsb2FkOwoKICAvLyBsb2dpYyB0byBmaWx0ZXIgZGF0YQoKICByZXR1cm4gcGF5bG9hZDsKfQ=="
}' 

const axios = require('axios')

const url = 'https://api.quicknode.com/webhooks/rest/v1/webhooks/test_filter'

const payload = {
	network: 'ethereum-mainnet',
	block: '17811625',
	filter_function:
		'ZnVuY3Rpb24gbWFpbihwYXlsb2FkKSB7CiAgY29uc3QgewogICAgZGF0YSwKICAgIG1ldGFkYXRhLAogIH0gPSBwYXlsb2FkOwoKICAvLyBsb2dpYyB0byBmaWx0ZXIgZGF0YQoKICByZXR1cm4gcGF5bG9hZDsKfQ==',
}

const headers = {
	accept: 'application/json',
	'Content-Type': 'application/json',
	'x-api-key': 'YOUR_API_KEY', // Replace with your actual API key
}

axios
	.post(url, payload, { headers })
	.then(response => {
		console.log(response.data)
	})
	.catch(error => {
		console.error('Error:', error.response?.data || error.message)
	})

import requests

url = "https://api.quicknode.com/webhooks/rest/v1/webhooks/test_filter"

payload = {
    "network": "ethereum-mainnet",
    "block": "17811625",
    "filter_function": "ZnVuY3Rpb24gbWFpbihwYXlsb2FkKSB7CiAgY29uc3QgewogICAgZGF0YSwKICAgIG1ldGFkYXRhLAogIH0gPSBwYXlsb2FkOwoKICAvLyBsb2dpYyB0byBmaWx0ZXIgZGF0YQoKICByZXR1cm4gcGF5bG9hZDsKfQ=="
}

headers = {
    "accept": "application/json",
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY"  # Replace with your actual API key
}

response = requests.post(url, headers=headers, json=payload)

print(response.text) 

require "uri"
require "net/http"
require "json"

# Set up the URL for the request
url = URI("https://api.quicknode.com/webhooks/rest/v1/webhooks/test_filter")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["Content-Type"] = "application/json"
request["x-api-key"] = "YOUR_API_KEY"  # Replace with your actual API key

request.body = {
  "network" => "ethereum-mainnet",
  "block" => "17811625",
  "filter_function" => "ZnVuY3Rpb24gbWFpbihwYXlsb2FkKSB7CiAgY29uc3QgewogICAgZGF0YSwKICAgIG1ldGFkYXRhLAogIH0gPSBwYXlsb2FkOwoKICAvLyBsb2dpYyB0byBmaWx0ZXIgZGF0YQoKICByZXR1cm4gcGF5bG9hZDsKfQ=="
}.to_json

response = https.request(request)
puts response.body 

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free