What is Key-Value Store?

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.

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

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.

Can Webhooks read the same list as my Streams filter?

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.

What is the difference between a list and a value?

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.

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

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.

What does Key-Value Store cost?

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.

How do the REST API and the qnLib functions relate?

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.

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

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.

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

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.

Are Key-Value Store items case-sensitive?

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.

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

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.

Almacén de clave-valor: Actualización de las listas de filtros de « Streams », sin necesidad de volver a implementar

Cargando contenido...

// FAQ

Preguntas frecuentes

Coste, límites, alcance y cómo encajan las diferentes capas. La documentación de Key-Value Store abarca todos los « endpoint » y funciones.

Key-Value Store es el almacén a nivel de cuenta de Quicknode para los pequeños fragmentos de estado de los que depende un canal de datos, organizados en forma de listas y valores. Los filtros de Streams , Webhooks y las aplicaciones externas leen y escriben los mismos datos, a través de las funciones de qnLib dentro de los filtros y de una API REST en el resto de casos. Una lista como «watched_wallets» gestiona las comprobaciones de pertenencia. Un valor como «lastProcessedBlock» contiene un punto de datos que un canal actualiza a lo largo del tiempo.

Almacena la lista en el almacén de clave-valor en lugar de codificarla de forma estática en el código del filtro. El filtro comprueba si un elemento está incluido en la lista mediante qnLib.qnContainsListItems, y cualquier actualización realizada a través de la API REST, o mediante qnLib.qnUpsertList, modifica los resultados de dicha comprobación. El filtro en ejecución lee la versión actual de la lista, por lo que el proceso continúa mientras la lista de seguimiento cambia.

Sí. Una lista en Key-Value Store tiene un ámbito de cuenta, por lo que la misma lista «watched_wallets» que un filtro de Streams comprueba con «qnLib.qnContainsListItems» está disponible para todos los webhooks de la cuenta. No es necesario crear ni mantener sincronizada una copia por producto. Basta con actualizar la lista una vez a través de la API REST para que ambas interfaces lean la versión actual.

Una lista es una colección con nombre de elementos de tipo cadena almacenados bajo una clave, diseñada para comprobar la pertenencia a una colección, como por ejemplo, comparar remitentes con las carteras vigiladas mediante qnLib.qnContainsListItems. Un valor almacena un dato bajo una clave, cuyo valor se realiza un seguimiento a lo largo del tiempo, como en el caso de lastProcessedBlock. Las listas indican si un elemento pertenece a una colección. Los valores indican cuál es el valor actual de un dato cuyo valor se realiza un seguimiento.

El uso de qnLib.qnContainsListItems dentro de tu filtro Streams y el uso de tu lista en Webhooks están incluidos sin coste alguno en todos los planes de Quicknode . Esto se aplica a esas consultas, no a las operaciones de escritura ni al almacenamiento, por lo que un filtro Streams puede comprobar una lista grande tantas veces como se ejecute. Para conocer las condiciones actuales sobre todo lo demás, consulta la página de precios de Quicknode .

La API REST y las funciones de qnLib son dos formas de acceder a los mismos datos subyacentes. Un filtro de Streams invoca funciones como qnLib.qnGetValue de forma nativa mientras se ejecuta. Un backend, un script o Agente invoca la API REST con la misma clave de API de Quicknode . Si se actualiza una lista a través de cualquiera de estas dos vías, cualquier elemento que la lea —ya sea un filtro o una aplicación— obtendrá la versión actual.

Sí. Los datos del almacén clave-valor tienen un ámbito de cuenta: se encuentran a nivel de la cuenta Quicknode , no dentro de un proyecto concreto ni en endpoint. Todos los filtros de Streams y todos los webhooks de la cuenta leen las mismas listas y los mismos valores, y la API REST accede a los mismos datos con la clave API de la cuenta. Basta con crear «watched_wallets» una sola vez, y cada pipeline comprueba una copia actualizada en lugar de mantener la suya propia.

El almacén de clave-valor puede contener millones de elementos, por lo que una lista de seguimiento extensa cabe en una sola lista, como «watched_wallets». No es necesario dividirla en fragmentos entre distintos sistemas. Las comprobaciones de pertenencia con «qnLib.qnContainsListItems» leen esa misma lista desde dentro de los filtros « Streams ». Para obtener información detallada actualizada sobre el almacenamiento y el número de elementos, consulta la documentación del almacén de clave-valor antes de dimensionar una carga de trabajo.

Sí, las entradas del almacén clave-valor distinguen entre mayúsculas y minúsculas, por lo que 0xAbC1 y 0xabc1 son dos entradas diferentes. Esto es especialmente importante en el caso de las direcciones de blockchain. Almacena una dirección con el mismo formato de mayúsculas y minúsculas que utiliza un filtro de « Streams » al llamar a qnLib.qnContainsListItems; de lo contrario, una entrada con suma de comprobación no coincidirá con su equivalente en minúsculas. Mantener un formato coherente de mayúsculas y minúsculas en el momento de la escritura garantiza la precisión de las comprobaciones de pertenencia.

Sí. Dos aplicaciones de ejemplo de la biblioteca de aplicaciones de ejemplo de Quicknode se basan en el patrón de lista de seguimiento dinámica que se describe en esta página. «Wallet Tracking» supervisa las direcciones de monedero en Solana y Ethereum, con la lista de seguimiento almacenada en Key-Value Store y actualizada a través de una interfaz de usuario sencilla. «HyperCore Order Monitor» realiza un seguimiento de las órdenes de negociación en Hyperliquid Core, con las direcciones supervisadas y los estados de las órdenes en listas de Key-Value Store. Ambas incluyen el código fuente, que puedes clonar.

¿Quieres estar al día?

Herramientas para desarrolladores

Documentación y guías

Cambia lo que supervisa tu pipeline.Omite la nueva implementación.

La lista ha vuelto a cambiar. Tu filtro no.

Cambios en cada PATCH.

Nunca cambia.

Las listas y los valores disponibles a nivel global mantienen sincronizados tus Streams, Webhooks y aplicaciones .

Listas dinámicas grandes y valores globales.Seleccionar por trabajo.

Pon en práctica tu primera lista.

Preguntas frecuentes

Seguimiento de la cartera

Monitor de pedidos de HyperCore

No hay que hacer nada nuevo.Funciona con el plan que ya tienes.

Ya hay dos aplicaciones que siguen este patrón. Clona una de ellas.

Haz una lista.

Léelo en tu proceso de trabajo.

Actualízalo desde cualquier lugar.

Documentación sobre el almacén de clave-valor

Precios