Hyperliquid 노드를 운영 중이신가요?Hyperliquid 피어링을 통해 블록 및 전체 멥풀에 대한 직접 경로를 활성화합니다.
자세히 알아보기SOC 2 Type II 인증 · ISO 27001
Key-Value Store is part of every Quicknode plan, with nothing extra to provision. Create and manage lists from the Quicknode Developer Portal, or do everything through 13 REST endpoints with the API key already on the account.
Create a list.
From the Developer Portal, or one POST to the REST API.
Read it in your pipeline.
Call qnLib.qnContainsListItems in a Streams filter, or wire the list into a Webhook.
Update it from anywhere.
PATCH the list from a backend or an agent. Running filters read the current version.
Key-Value Store holds the lists and values your Streams filters, Webhooks, and external apps read and write. Add a wallet or drop a contract through the REST API, and a running filter reads the current version.
Available on every Quicknode plan.
Update the dynamic list a running Streams filter checks against, without redeploying the filter.
Change the list without touching filter code.
One PATCH through the REST API changes what qnLib.qnContainsListItems sees.
Lists and Values update everywhere they're used.
When you update your list or values, they're globally available in Streams, Webhooks, and through the REST API.
Hold millions of items under a single key.
Filters check every block against the whole list, however large it grows.
qnLib.qnContainsListItems('watched_wallets', senders)
Key-Value Store has two data types: Lists and Values.
A named collection of string items stored under a single key. Best for membership checks: is this address in my watchlist?
qnLib.qnUpsertListadd and remove items from your listqnLib.qnAddListItemadd one itemqnLib.qnRemoveListItemremove one itemqnLib.qnGetListread the whole listqnLib.qnContainsListItemsbatch membership lookupqnLib.qnDeleteListdelete the listItems are case-sensitive: 0xAbC1 and 0xabc1 are different entries. Store blockchain addresses in the case your filter compares against.
A single key-value pair. Best for storing and retrieving one specific data point over time, like the last block you processed.
qnLib.qnAddValuewrite a valueqnLib.qnGetValueread a valueqnLib.qnBulkValueswrite several at onceqnLib.qnDeleteValuedelete a valueData persists block to block, from one Streams execution to the next. Write lastProcessedBlock as 19271294 at the end of one run, and read it back at the start of the next.
Key-Value Store is scoped to the Quicknode account, not to a single project or endpoint.The REST API is also the way in for state your agents keep between runs.
Streams
Filters run batch membership checks with qnLib.qnContainsListItems as blocks arrive.
Webhooks
Webhooks read the same lists your Streams filters check.
REST API
13 endpoints for your backend, scripts, and CI/CD pipelines. The same data a filter reads.
Read and compare lists and retrieve values in your Streams filter at no cost. Using your lists in Webhooks is included too.
Two apps already run this pattern. Clone one.
Both sample apps are built on the exact loop this page describes: a Streams filter reading a watchlist that Key-Value Store holds, updated while the stream runs.
const senders = txs.map(tx => tx.from)const hits = await qnLib.qnContainsListItems('watched_wallets', senders)
Monitor a list of wallet addresses on Solana and Ethereum. Add or remove an address in the UI, and the app updates the Key-Value Store list the filters check. The stream never redeploys.Next.js · TypeScript · SSE
const traders = orders.map(o => o.user)const hits = await qnLib.qnContainsListItems('watched_traders', traders)
Track trading orders on Hyperliquid Core in real time. Watched trader addresses and order statuses live in Key-Value Store lists, so filtering changes without a stream restart.Next.js · TypeScript · SSE
Key-Value Store docs
Every endpoint and function.
가격
Current terms on writes and storage.
Create it once. Check it from every Streams filter and Webhook on the account, and update it from anywhere through the REST API.
New to Quicknode? Create an account and your first list in the same sitting.
자주 묻는 질문
Cost, limits, scope, and how the surfaces fit together. The Key-Value Store docs cover every endpoint and function.
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.