Path Parameters

templateId

string

REQUIRED

The template ID.

evmWalletFilterevmContractEventsevmAbiFiltersolanaWalletFilterbitcoinWalletFilterxrplWalletFilterhyperliquidWalletEventsFilterstellarWalletTransactionsSourceAccountFilter

Body Parameters

name

string

REQUIRED

A name for your webhook.

network

string

REQUIRED

The network for this webhook.

notification_email

string

Notify when webhook is terminated.

destination_attributes

object

REQUIRED

Webhook destination configuration including URL, security token, and compression settings.

url

string

The URL where webhook data will be sent.

security_token

string

Security token for webhook authentication. If no value is included, we will generate a token for this Webhook.

compression

string

Compression type for webhook payloads.

nonegzip

templateArgs

object

REQUIRED

Template-specific arguments. Select a template to see its required arguments.

Arguments for the evmWalletFilter template.

walletsListName

string

REQUIRED

Name of a kv store list containing EVM wallet addresses to monitor.

Arguments for the evmContractEvents template. At least one of contractsListName or eventHashesListName should be provided.

contractsListName

string

Name of a kv store list containing contract addresses to monitor.

eventHashesListName

string

Name of a kv store list containing event signature hashes to monitor.

Arguments for the evmAbiFilter template.

abiJson

string

REQUIRED

ABI JSON string.

contractsListName

string

Name of a kv store list containing contract addresses to monitor.

Arguments for the solanaWalletFilter template.

accountsListName

string

REQUIRED

Name of a kv store list containing Solana account addresses to monitor.

Arguments for the bitcoinWalletFilter template.

walletsListName

string

REQUIRED

Name of a kv store list containing Bitcoin wallet addresses to monitor.

Arguments for the xrplWalletFilter template.

walletsListName

string

REQUIRED

Name of a kv store list containing XRP Ledger wallet addresses to monitor.

Arguments for the hyperliquidWalletEventsFilter template.

walletsListName

string

REQUIRED

Name of a kv store list containing Hyperliquid wallet addresses to monitor.

Arguments for the stellarWalletTransactionsSourceAccountFilter template.

walletsListName

string

REQUIRED

Name of a kv store list containing Stellar wallet addresses to monitor.

Returns

id

string

The ID of the webhook

created_at

string

The timestamp when the webhook was created

name

string

The webhook name

network

string

The network of the webhook

notification_email

string

Email for termination notifications

destination_attributes

object

Webhook destination configuration

url

string

The URL where webhook data is sent

security_token

string

Security token for webhook authentication

compression

string

Compression type for webhook payloads

sequence

integer

The last delivered block from the data range

status

string

The current status of the webhook

templateId

string

The template ID used to create this webhook.

templateArgs

object

The template arguments (kv store list names).

Request

1
curl -X POST \
2
    "https://api.quicknode.com/webhooks/rest/v1/webhooks/template/evmWalletFilter" \
3
    -H "accept: application/json" \
4
    -H "Content-Type: application/json" \
5
    -H "x-api-key: YOUR_API_KEY" \
6
    -d $'{
7
  "name": "My Wallet Monitor Webhook",
8
  "network": "ethereum-mainnet",
9
  "notification_email": "contact@example.com",
10
  "destination_attributes": {
11
    "url": "https://webhook.site/your-unique-url",
12
    "compression": "none"
13
  },
14
  "templateArgs": {
15
    "wallets": [
16
      "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
17
      "0xdac17f958d2ee523a2206206994597c13d831ec7"
18
    ]
19
  }
20
}' 

1
curl -X POST \
2
    "https://api.quicknode.com/webhooks/rest/v1/webhooks/template/evmWalletFilter" \
3
    -H "accept: application/json" \
4
    -H "Content-Type: application/json" \
5
    -H "x-api-key: YOUR_API_KEY" \
6
    -d $'{
7
  "name": "My Wallet Monitor Webhook",
8
  "network": "ethereum-mainnet",
9
  "notification_email": "contact@example.com",
10
  "destination_attributes": {
11
    "url": "https://webhook.site/your-unique-url",
12
    "compression": "none"
13
  },
14
  "templateArgs": {
15
    "wallets": [
16
      "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
17
      "0xdac17f958d2ee523a2206206994597c13d831ec7"
18
    ]
19
  }
20
}' 

1
const axios = require('axios')
2

3
const templateId = 'evmWalletFilter' // Can be: evmWalletFilter, evmContractEvents, solanaWalletFilter, bitcoinWalletFilter, evmAbiFilter
4
const url = `https://api.quicknode.com/webhooks/rest/v1/webhooks/template/${templateId}`
5

6
const payload = {
7
	name: 'My Wallet Monitor Webhook',
8
	network: 'ethereum-mainnet',
9
	notification_email: 'contact@example.com',
10
	destination_attributes: {
11
		url: 'https://webhook.site/your-unique-url',
12
		compression: 'gzip',
13
	},
14
	templateArgs: {
15
		wallets: [
16
			'0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
17
			'0xdac17f958d2ee523a2206206994597c13d831ec7',
18
		],
19
	},
20
}
21

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

28
axios
29
	.post(url, payload, { headers })
30
	.then(response => {
31
		console.log(response.data)
32
	})
33
	.catch(error => {
34
		console.error('Error:', error.response?.data || error.message)
35
	})
36

1
const axios = require('axios')
2

3
const templateId = 'evmWalletFilter' // Can be: evmWalletFilter, evmContractEvents, solanaWalletFilter, bitcoinWalletFilter, evmAbiFilter
4
const url = `https://api.quicknode.com/webhooks/rest/v1/webhooks/template/${templateId}`
5

6
const payload = {
7
	name: 'My Wallet Monitor Webhook',
8
	network: 'ethereum-mainnet',
9
	notification_email: 'contact@example.com',
10
	destination_attributes: {
11
		url: 'https://webhook.site/your-unique-url',
12
		compression: 'gzip',
13
	},
14
	templateArgs: {
15
		wallets: [
16
			'0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
17
			'0xdac17f958d2ee523a2206206994597c13d831ec7',
18
		],
19
	},
20
}
21

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

28
axios
29
	.post(url, payload, { headers })
30
	.then(response => {
31
		console.log(response.data)
32
	})
33
	.catch(error => {
34
		console.error('Error:', error.response?.data || error.message)
35
	})
36

1
import requests
2

3
template_id = "evmWalletFilter"  # Can be: evmWalletFilter, evmContractEvents, solanaWalletFilter, bitcoinWalletFilter, evmAbiFilter
4
url = f"https://api.quicknode.com/webhooks/rest/v1/webhooks/template/{template_id}"
5

6
payload = {
7
    "name": "My Wallet Monitor Webhook",
8
    "network": "ethereum-mainnet",
9
    "notification_email": "contact@example.com",
10
    "destination_attributes": {
11
        "url": "https://webhook.site/your-unique-url",
12
        "compression": "gzip"
13
    },
14
    "templateArgs": {
15
        "wallets": [
16
            "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
17
            "0xdac17f958d2ee523a2206206994597c13d831ec7"
18
        ]
19
    }
20
}
21

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

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

30
print(response.text) 

1
import requests
2

3
template_id = "evmWalletFilter"  # Can be: evmWalletFilter, evmContractEvents, solanaWalletFilter, bitcoinWalletFilter, evmAbiFilter
4
url = f"https://api.quicknode.com/webhooks/rest/v1/webhooks/template/{template_id}"
5

6
payload = {
7
    "name": "My Wallet Monitor Webhook",
8
    "network": "ethereum-mainnet",
9
    "notification_email": "contact@example.com",
10
    "destination_attributes": {
11
        "url": "https://webhook.site/your-unique-url",
12
        "compression": "gzip"
13
    },
14
    "templateArgs": {
15
        "wallets": [
16
            "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
17
            "0xdac17f958d2ee523a2206206994597c13d831ec7"
18
        ]
19
    }
20
}
21

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

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

30
print(response.text) 

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

5
template_id = "evmWalletFilter"  # Can be: evmWalletFilter, evmContractEvents, solanaWalletFilter, bitcoinWalletFilter, evmAbiFilter
6
url = URI("https://api.quicknode.com/webhooks/rest/v1/webhooks/template/#{template_id}")
7

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

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

16
request.body = {
17
  "name" => "My Wallet Monitor Webhook",
18
  "network" => "ethereum-mainnet",
19
  "notification_email" => "contact@example.com",
20
  "destination_attributes" => {
21
    "url" => "https://webhook.site/your-unique-url",
22
    "compression" => "gzip"
23
  },
24
  "templateArgs" => {
25
    "wallets" => [
26
      "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
27
      "0xdac17f958d2ee523a2206206994597c13d831ec7"
28
    ]
29
  }
30
}.to_json
31

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

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

5
template_id = "evmWalletFilter"  # Can be: evmWalletFilter, evmContractEvents, solanaWalletFilter, bitcoinWalletFilter, evmAbiFilter
6
url = URI("https://api.quicknode.com/webhooks/rest/v1/webhooks/template/#{template_id}")
7

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

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

16
request.body = {
17
  "name" => "My Wallet Monitor Webhook",
18
  "network" => "ethereum-mainnet",
19
  "notification_email" => "contact@example.com",
20
  "destination_attributes" => {
21
    "url" => "https://webhook.site/your-unique-url",
22
    "compression" => "gzip"
23
  },
24
  "templateArgs" => {
25
    "wallets" => [
26
      "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
27
      "0xdac17f958d2ee523a2206206994597c13d831ec7"
28
    ]
29
  }
30
}.to_json
31

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

1
qn webhook create --name wallet-watch \
2
      --network ethereum-mainnet \
3
      --url https://example.com/hook \
4
      --compression none \
5
      --template {template_id} \
6
      --wallet {wallet_address} \
7
      -o json

1
qn webhook create --name wallet-watch \
2
      --network ethereum-mainnet \
3
      --url https://example.com/hook \
4
      --compression none \
5
      --template {template_id} \
6
      --wallet {wallet_address} \
7
      -o json

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

3
const qn = new QuicknodeSdk({ apiKey: "YOUR_API_KEY" })
4

5
const response = await qn.webhooks.createWebhookFromTemplate({ name: "Wallet activity", network: "ethereum-mainnet", destinationAttributes: { url: "https://example.com/webhook", compression: "none" }, templateArgs: { templateId: "evmWalletFilter", wallet: "0x0000000000000000000000000000000000000000" } })
6
console.log(response)
7

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

3
const qn = new QuicknodeSdk({ apiKey: "YOUR_API_KEY" })
4

5
const response = await qn.webhooks.createWebhookFromTemplate({ name: "Wallet activity", network: "ethereum-mainnet", destinationAttributes: { url: "https://example.com/webhook", compression: "none" }, templateArgs: { templateId: "evmWalletFilter", wallet: "0x0000000000000000000000000000000000000000" } })
6
console.log(response)
7

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4

5
async def main():
6
    qn = QuicknodeSdk(SdkFullConfig(api_key="YOUR_API_KEY"))
7
    response = await qn.webhooks.create_webhook_from_template(name="Wallet activity", network="ethereum-mainnet", destination_attributes={"url": "https://example.com/webhook", "compression": "none"}, template_args={"template_id": "evmWalletFilter", "wallet": "0x0000000000000000000000000000000000000000"})
8
    print(response)
9

10

11
asyncio.run(main())
12

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4

5
async def main():
6
    qn = QuicknodeSdk(SdkFullConfig(api_key="YOUR_API_KEY"))
7
    response = await qn.webhooks.create_webhook_from_template(name="Wallet activity", network="ethereum-mainnet", destination_attributes={"url": "https://example.com/webhook", "compression": "none"}, template_args={"template_id": "evmWalletFilter", "wallet": "0x0000000000000000000000000000000000000000"})
8
    print(response)
9

10

11
asyncio.run(main())
12

1
require "quicknode_sdk"
2

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

5
response = qn.webhooks.create_webhook_from_template(name: "Wallet activity", network: "ethereum-mainnet", destination_attributes: { url: "https://example.com/webhook", compression: "none" }, template_args: { template_id: "evmWalletFilter", wallet: "0x0000000000000000000000000000000000000000" })
6
puts response
7

1
require "quicknode_sdk"
2

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

5
response = qn.webhooks.create_webhook_from_template(name: "Wallet activity", network: "ethereum-mainnet", destination_attributes: { url: "https://example.com/webhook", compression: "none" }, template_args: { template_id: "evmWalletFilter", wallet: "0x0000000000000000000000000000000000000000" })
6
puts response
7

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::builder().api_key("YOUR_API_KEY").build())?;
6
    let response = qn.webhooks.create_webhook_from_template(&quicknode_sdk::webhooks::CreateWebhookFromTemplateParams { name: "Wallet activity".to_string(), network: "ethereum-mainnet".to_string(), notification_email: None, destination_attributes: quicknode_sdk::webhooks::WebhookDestinationAttributes { url: "https://example.com/webhook".to_string(), security_token: None, compression: Some("none".to_string()) }, template_args: quicknode_sdk::webhooks::TemplateArgs::evm_wallet_filter(&quicknode_sdk::webhooks::EvmWalletFilterTemplate { wallets: vec!["0x0000000000000000000000000000000000000000".to_string()] })? }).await?;
7

8
    println!("{:?}", response);
9
    Ok(())
10
}
11

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::builder().api_key("YOUR_API_KEY").build())?;
6
    let response = qn.webhooks.create_webhook_from_template(&quicknode_sdk::webhooks::CreateWebhookFromTemplateParams { name: "Wallet activity".to_string(), network: "ethereum-mainnet".to_string(), notification_email: None, destination_attributes: quicknode_sdk::webhooks::WebhookDestinationAttributes { url: "https://example.com/webhook".to_string(), security_token: None, compression: Some("none".to_string()) }, template_args: quicknode_sdk::webhooks::TemplateArgs::evm_wallet_filter(&quicknode_sdk::webhooks::EvmWalletFilterTemplate { wallets: vec!["0x0000000000000000000000000000000000000000".to_string()] })? }).await?;
7

8
    println!("{:?}", response);
9
    Ok(())
10
}
11

Try in Swagger

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free