Question 1

What is Key-Value Store?

Accepted Answer

Key-Value Store is Quicknode's account-level store for the small pieces of state a data pipeline depends on, organized as lists and values. Streams filters, Webhooks, and external applications all read and write the same data, through qnLib functions inside filters and a REST API everywhere else. A list such as watched_wallets drives membership checks. A value such as lastProcessedBlock holds one data point a pipeline updates over time.

Question 2

How do I update a Streams filter's address list without redeploying the filter?

Accepted Answer

Store the list in Key-Value Store instead of hardcoding it in filter code. The filter checks membership with qnLib.qnContainsListItems, and an update through the REST API, or with qnLib.qnUpsertList, changes what that check sees. The running filter reads the current version of the list, so the pipeline keeps processing while the watchlist changes.

Question 3

Can Webhooks read the same list as my Streams filter?

Accepted Answer

Yes. A list in Key-Value Store is account-scoped, so the same watched_wallets list a Streams filter checks with qnLib.qnContainsListItems is available to every Webhook on the account. There is no per-product copy to create or keep in sync. Update the list once through the REST API, and both surfaces read the current version.

Question 4

What is the difference between a list and a value?

Accepted Answer

A list is a named collection of string items stored under one key, built for membership checks, like matching senders against watched_wallets with qnLib.qnContainsListItems. A value stores one data point under one key, tracked over time, like lastProcessedBlock. Lists answer whether an item belongs to a collection. Values answer what one tracked data point currently holds.

Question 5

Is there a cost for lookups inside Streams filters and Webhooks?

Accepted Answer

qnLib.qnContainsListItems usage inside your Streams filter, and using your list in Webhooks are included at no cost, on every Quicknode plan. That applies to those lookups, not to writes or storage, so a Streams filter can check a large list as often as it runs. For current terms on everything else, check the Quicknode pricing page.

Question 6

What does Key-Value Store cost?

Accepted Answer

Key-Value Store is available on every Quicknode plan with nothing separate to buy or provision. qnLib.qnContainsListItems usage inside your Streams filter, and using your list in Webhooks are included at no cost. For current terms on writes and storage, check the Quicknode pricing page.

Question 7

How do the REST API and the qnLib functions relate?

Accepted Answer

The REST API and the qnLib functions are two ways into the same underlying data. A Streams filter calls functions like qnLib.qnGetValue natively while it runs. A backend, script, or agent calls the REST API with the same Quicknode API key. Update a list through either surface, and anything reading it, filter or application, reads the current version.

Question 8

Is Key-Value Store data shared across my whole account?

Accepted Answer

Yes. Key-Value Store data is account-scoped: it lives at the Quicknode account level, not inside one project or endpoint. Every Streams filter and every Webhook on the account reads the same lists and values, and the REST API reaches the same data with the account's API key. Create watched_wallets once, and each pipeline checks one current copy instead of maintaining its own.

Question 9

Is there a limit on how much Key-Value Store holds?

Accepted Answer

Key-Value Store can hold millions of items, so a large watchlist fits in one list like watched_wallets. No need to shard it across systems. Membership checks with qnLib.qnContainsListItems read that same list from inside Streams filters. For current specifics on storage and item counts, check the Key-Value Store docs before sizing a workload.

Question 10

Are Key-Value Store items case-sensitive?

Accepted Answer

Yes, items in Key-Value Store are case-sensitive, so 0xAbC1 and 0xabc1 are two different entries. This matters most with blockchain addresses. Store an address in the same case a Streams filter uses when it calls qnLib.qnContainsListItems, or a checksummed entry will not match its lowercase twin. Consistent casing at write time keeps membership checks accurate.

Question 11

Are there working examples of Key-Value Store with Streams?

Accepted Answer

Yes. Two sample apps in the Quicknode Sample App Library are built on the dynamic-watchlist pattern this page describes. Wallet Tracking monitors wallet addresses on Solana and Ethereum, with the watchlist held in Key-Value Store and updated through a simple UI. HyperCore Order Monitor tracks trading orders on Hyperliquid Core, with watched addresses and order statuses in Key-Value Store lists. Both ship with source code you can clone.

想掌握最新動態嗎？

開發者工具

文件與指南

沒有新的程式需要執行。按照你現有的計畫運作即可。

建立一份清單。

請在您的處理流程中閱讀此內容。

無論身在何處，都能進行更新。

變更管道所監控的對象。跳過重新部署。

清單又變了。但您的篩選條件卻沒有改變。

每個 PATCH 都有變更。

永遠不變。

大型動態清單與全域變數。依工作選取。

全球可用的清單和值可讓您的Streams 、Webhooks 以及應用程式保持同步。

目前已有兩款應用程式採用這種模式。請複製其中一款。

錢包追蹤

HyperCore 訂單監控器

鍵值儲存庫文件

定價

讓你的第一份清單發揮作用吧。

常見問題