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.

सामग्री लोड हो रही है...

USDC Yield With Cover Built InQuicknode Earn now runs USDC yield with cover for protocol risk built in, underwritten by OpenCover. Six covered vaults on Base.

घोषणा पढ़ें

गाइड देखें

// Key-Value Store

अपनी पाइपलाइन की निगरानी के दायरे को बदलें। पुनः तैनाती की आवश्यकता नहीं है।

की-वैल्यू स्टोर में आपकी सूचियाँ और मूल्य मौजूद होते हैं। Streams फ़िल्टर, Webhooks बाहरी ऐप्स इसे पढ़ और लिख सकते हैं। REST API के माध्यम से वॉलेट जोड़ें या कॉन्ट्रैक्ट हटाएं, और एक चालू फ़िल्टर वर्तमान संस्करण को पढ़ लेगा।

अपनी पहली सूची बनाएं दस्तावेज़ पढ़ें

हर जगह उपलब्ध है Quicknode योजना।

रेस्ट एपीआई

PATCH /kv/rest/v1/lists/watched_wallets

+ "0x8f3c…9ad1"

देखे गए वॉलेट

की-वैल्यू स्टोर

0x8f3c…9ad1
// Added via REST API
0x41be…7c02
0xc0a9…3efd
0x9a2f…44ee
0x6d1a…e830

पठनकर्ता: Streams · Webhooks · आराम

// Dynamic lists and values

सूची फिर से बदल गई। आपका फ़िल्टर नहीं बदला।

गतिशील सूची को चालू रखें Streams फ़िल्टर को पुनः तैनात किए बिना, फ़िल्टर की जाँच की जाती है।

फ़िल्टर कोड को छुए बिना सूची बदलें।

REST API के माध्यम से एक पैच बदलने से क्या होता है qnLib.qnContainsListItems देखता है।

सूचियाँ और मान जहाँ भी उपयोग किए जाते हैं, वहाँ अपडेट हो जाते हैं।

जब आप अपनी सूची या मानों को अपडेट करते हैं, तो वे विश्व स्तर पर उपलब्ध होते हैं। Streams , Webhooks और REST API के माध्यम से।

एक ही कुंजी के तहत लाखों आइटम स्टोर करें।

फ़िल्टर पूरी सूची के प्रत्येक ब्लॉक की जाँच करते हैं, चाहे सूची कितनी भी बड़ी क्यों न हो जाए।

// Your list

हर पैच में बदलाव होते हैं।

0x8f3c…9ad1 जोड़ा गया
0xb44e…0f17 हटा दिया गया
0x6d1a…e830 जोड़ा गया

// Your filter

कभी नहीं बदलता।

qnLib.qnContainsListItems (
  'देखे गए वॉलेट' , प्रेषक
)

// One list, everywhere

विश्व स्तर पर उपलब्ध सूचियाँ और मान आपके Streams , Webhooks और ऐप्स सिंक्रनाइज़्ड हैं।

की-वैल्यू स्टोर Quicknode खाते तक सीमित है, किसी एक प्रोजेक्ट या endpoint तक नहीं। REST API आपके agents रन के बीच रखी जाने वाली स्थिति के लिए भी एक माध्यम है।

अपनी पहली सूची बनाएं

// Read by

सतह विनिर्देश

Streams
ब्लॉक आने पर फ़िल्टर qnLib.qnContainsListItems के साथ बैच सदस्यता जांच चलाते हैं।
बैच लुकअप
Webhooks
Webhooks अपनी सूचियों को भी पढ़ें Streams फ़िल्टर की जाँच।
साझा सूची
रेस्ट एपीआई
आपके बैकएंड, स्क्रिप्ट और CI/CD पाइपलाइन के लिए 13 एंडपॉइंट। वही डेटा जिसे फ़िल्टर पढ़ता है।
वैश्विक पहुंच

// Lookups & reads included in Streams

सूचियों को पढ़ें और उनकी तुलना करें तथा अपने डेटा में मान प्राप्त करें Streams बिना किसी लागत के फ़िल्टर करें। अपनी सूचियों का उपयोग करके Webhooks इसमें शामिल है।

// Two data types

बड़ी गतिशील सूचियाँ और वैश्विक मान। कार्य के अनुसार चुनें।

की-वैल्यू स्टोर में दो प्रकार के डेटा होते हैं: सूचियाँ और मान।

देखे गए वॉलेट

0x8f3c

0x6d1a

0xb44e

…

सूची 1 : n

एक ही कुंजी के अंतर्गत संग्रहीत स्ट्रिंग आइटमों का एक नामयुक्त संग्रह। सदस्यता जांच के लिए सर्वोत्तम: क्या यह पता मेरी वॉचलिस्ट में है?

qnLib.qnUpsertListअपनी सूची में आइटम जोड़ें और हटाएं
qnLib.qnAddListItemएक आइटम जोड़ें
qnLib.qnRemoveListItemएक वस्तु हटाएँ
qnLib.qnGetListपूरी सूची पढ़ें
qnLib.qnContainsListItemsबैच सदस्यता खोज
qnLib.qnDeleteListसूची हटाएँ

आइटम केस-सेंसिटिव हैं: 0xAbC1 और 0xabc1 अलग-अलग प्रविष्टियाँ हैं। अपने फ़िल्टर की तुलना के लिए ब्लॉकचेन पते को केस में स्टोर करें।

अंतिम संसाधित ब्लॉक

19271294

मान 1 : 1

एक एकल कुंजी-मान युग्म। समय के साथ किसी विशिष्ट डेटा बिंदु को संग्रहीत और पुनर्प्राप्त करने के लिए सर्वोत्तम, जैसे कि आपके द्वारा संसाधित किया गया अंतिम ब्लॉक।

qnLib.qnAddValueएक मान लिखें
qnLib.qnGetValueएक मान पढ़ें
qnLib.qnBulkValuesएक साथ कई लिखें
qnLib.qnDeleteValueकिसी मान को हटाएँ

डेटा एक ब्लॉक से दूसरे ब्लॉक तक बना रहता है। Streams अगले निष्पादन पर जाएं। lastProcessedBlock को इस प्रकार लिखें: 19271294 एक दौर के अंत में इसे पढ़ें, और अगले दौर की शुरुआत में इसे दोबारा पढ़ें।

अपनी पहली सूची को काम में लाएं।

इसे एक बार बनाएं। हर बार इसकी जांच करें। Streams अकाउंट पर फ़िल्टर और वेबहुक लगाएं, और REST API के माध्यम से इसे कहीं से भी अपडेट करें।

अपनी पहली सूची बनाएं दस्तावेज़ पढ़ें

करने के लिए नई Quicknode एक ही बार में खाता बनाएं और अपनी पहली सूची तैयार करें।

// FAQ

अक्सर पूछे जाने वाले प्रश्नों

लागत, सीमाएं, दायरा और सतहें आपस में कैसे जुड़ती हैं। की-वैल्यू स्टोर के दस्तावेज़ इन सभी पहलुओं को कवर करते हैं। endpoint और कार्य।

की-वैल्यू स्टोर है Quicknode डेटा पाइपलाइन जिन छोटे-छोटे स्टेट डेटा पर निर्भर करती है, उनके लिए 's अकाउंट-लेवल स्टोर, जिसे सूचियों और मानों के रूप में व्यवस्थित किया गया है। Streams फ़िल्टर, Webhooks सभी बाहरी एप्लिकेशन फ़िल्टर के अंदर qnLib फ़ंक्शंस और अन्य सभी जगहों पर REST API के माध्यम से एक ही डेटा को पढ़ते और लिखते हैं। watched_wallets जैसी सूची सदस्यता जांच को संचालित करती है। lastProcessedBlock जैसा मान एक डेटा बिंदु रखता है जिसे पाइपलाइन समय के साथ अपडेट करती है।

सूची को फ़िल्टर कोड में हार्डकोड करने के बजाय की-वैल्यू स्टोर में स्टोर करें। फ़िल्टर qnLib.qnContainsListItems का उपयोग करके सदस्यता की जाँच करता है, और REST API या qnLib.qnUpsertList के माध्यम से अपडेट करने पर जाँच का परिणाम बदल जाता है। चल रहा फ़िल्टर सूची के वर्तमान संस्करण को पढ़ता है, इसलिए वॉचलिस्ट में परिवर्तन होने पर भी पाइपलाइन प्रोसेसिंग जारी रखती है।

हाँ। की-वैल्यू स्टोर में एक सूची खाता-आधारित होती है, इसलिए वही watched_wallets सूची एक Streams qnLib.qnContainsListItems के साथ फ़िल्टर जाँच खाते के प्रत्येक वेबहुक पर उपलब्ध है। प्रत्येक उत्पाद के लिए अलग से कॉपी बनाने या सिंक में रखने की आवश्यकता नहीं है। REST API के माध्यम से सूची को एक बार अपडेट करें, और दोनों वेबहुक वर्तमान संस्करण को पढ़ लेंगे।

एक सूची एक ही कुंजी के अंतर्गत संग्रहीत स्ट्रिंग आइटमों का एक नामयुक्त संग्रह है, जिसे सदस्यता जांच के लिए बनाया गया है, जैसे कि qnLib.qnContainsListItems का उपयोग करके प्रेषकों का watched_wallets से मिलान करना। एक मान एक कुंजी के अंतर्गत एक डेटा बिंदु संग्रहीत करता है, जिसे समय के साथ ट्रैक किया जाता है, जैसे कि lastProcessedBlock। सूचियाँ यह बताती हैं कि कोई आइटम किसी संग्रह से संबंधित है या नहीं। मान यह बताते हैं कि वर्तमान में ट्रैक किए गए डेटा बिंदु में क्या जानकारी है।

qnLib.qnContainsListItems का उपयोग आपके अंदर Streams फ़िल्टर करें, और अपनी सूची का उपयोग करें Webhooks हर एक पर ये चीजें बिना किसी अतिरिक्त लागत के शामिल हैं। Quicknode योजना। यह उन खोजों पर लागू होता है, लेखन या संग्रहण पर नहीं, इसलिए एक Streams फ़िल्टर जितनी बार चलता है उतनी बार एक बड़ी सूची की जाँच कर सकता है। बाकी सभी चीज़ों के लिए वर्तमान शर्तों की जाँच करें। Quicknode मूल्य निर्धारण पृष्ठ।

की-वैल्यू स्टोर हर जगह उपलब्ध है Quicknode बिना कुछ अलग से खरीदे या उपलब्ध कराए योजना बनाएं। qnLib.qnContainsListItems का उपयोग आपके अंदर करें Streams फ़िल्टर करें, और अपनी सूची का उपयोग करें Webhooks ये सेवाएं बिना किसी शुल्क के शामिल हैं। लेखन और भंडारण संबंधी वर्तमान शर्तों के लिए, कृपया देखें। Quicknode मूल्य निर्धारण पृष्ठ।

REST API और qnLib फ़ंक्शन एक ही अंतर्निहित डेटा तक पहुँचने के दो तरीके हैं। Streams फ़िल्टर चलते समय qnLib.qnGetValue जैसे फ़ंक्शन को सीधे कॉल करता है। एक बैकएंड, स्क्रिप्ट, या agent उसी के साथ REST API को कॉल करता है Quicknode एपीआई कुंजी। किसी भी माध्यम से सूची को अपडेट करें, और इसे पढ़ने वाला कोई भी उपकरण, चाहे वह फ़िल्टर हो या एप्लिकेशन, वर्तमान संस्करण को पढ़ेगा।

हाँ। की-वैल्यू स्टोर डेटा अकाउंट-स्कोप वाला होता है: यह वहीं रहता है। Quicknode खाता स्तर पर, किसी एक प्रोजेक्ट के अंदर नहीं या endpoint । प्रत्येक Streams फ़िल्टर और खाते पर मौजूद हर वेबहुक एक ही सूची और मान पढ़ता है, और REST API खाते की API कुंजी के साथ उसी डेटा तक पहुँचता है। watched_wallets को एक बार बनाएं, और प्रत्येक पाइपलाइन अपनी अलग कॉपी बनाए रखने के बजाय एक मौजूदा कॉपी की जाँच करती है।

की-वैल्यू स्टोर में लाखों आइटम रखे जा सकते हैं, इसलिए एक बड़ी वॉचलिस्ट को watched_wallets जैसी एक ही लिस्ट में रखा जा सकता है। इसे सिस्टम में विभाजित करने की कोई आवश्यकता नहीं है। qnLib.qnContainsListItems के साथ सदस्यता जांच उसी लिस्ट को अंदर से पढ़ती है। Streams फ़िल्टर। संग्रहण और आइटम गणना के बारे में नवीनतम जानकारी के लिए, कार्यभार का आकार निर्धारित करने से पहले कुंजी-मूल्य स्टोर दस्तावेज़ देखें।

हां, की-वैल्यू स्टोर में आइटम केस-सेंसिटिव होते हैं, इसलिए 0xAbC1 और 0xabc1 दो अलग-अलग प्रविष्टियां हैं। ब्लॉकचेन पतों के मामले में यह सबसे ज़्यादा मायने रखता है। किसी पते को उसी केस में स्टोर करें जिस केस में दूसरा पता स्टोर किया गया हो। Streams फ़िल्टर का उपयोग तब किया जाता है जब यह qnLib.qnContainsListItems को कॉल करता है, अन्यथा चेकसम की गई प्रविष्टि अपने लोअरकेस समकक्ष से मेल नहीं खाएगी। लेखन के समय सुसंगत केसिंग सदस्यता जांच को सटीक बनाए रखती है।

हाँ। दो नमूना ऐप्स में Quicknode सैंपल ऐप लाइब्रेरी इस पृष्ठ पर वर्णित डायनामिक-वॉचलिस्ट पैटर्न पर आधारित है। वॉलेट ट्रैकिंग वॉलेट पतों की निगरानी करती है। Solana और Ethereum वॉचलिस्ट को की-वैल्यू स्टोर में रखा जाता है और एक सरल यूआई के माध्यम से अपडेट किया जाता है। हाइपरकोर ऑर्डर मॉनिटर ट्रेडिंग ऑर्डर को ट्रैक करता है। Hyperliquid कोर, जिसमें वॉच किए गए पते और ऑर्डर की स्थिति की-वैल्यू स्टोर सूचियों में मौजूद हैं। दोनों के साथ सोर्स कोड आता है जिसे आप क्लोन कर सकते हैं।

वॉलेट-ट्रैकिंग.जेएस

const प्रेषक = txs.map ( tx => tx . से )
स्थिर हिट्स = qnLib.qnContainsListItems की प्रतीक्षा करें (
  'देखे गए वॉलेट' , प्रेषक
)

// Streams + Key-Value Store

वॉलेट ट्रैकिंग

वॉलेट पतों की सूची पर नज़र रखें Solana और Ethereum यूआई में पता जोड़ने या हटाने पर, ऐप फ़िल्टर द्वारा जाँची जाने वाली कुंजी-मान भंडार सूची को अपडेट कर देता है। स्ट्रीम कभी भी पुनः तैनात नहीं होती है। Next.js · TypeScript · SSE

नमूना ऐप देखें

ORDER-MONITOR.JS

const traders = orders.map ( o => o . उपयोगकर्ता )
स्थिर हिट्स = qnLib.qnContainsListItems की प्रतीक्षा करें (
  'देखे गए व्यापारी' , व्यापारी
)

// Streams + Key-Value Store

हाइपरकोर ऑर्डर मॉनिटर

ट्रेडिंग ऑर्डर को ट्रैक करें Hyperliquid कोर वास्तविक समय में काम करता है। की-वैल्यू स्टोर सूचियों में ट्रेडर के पते और ऑर्डर की स्थिति को लाइव देखा जा सकता है, जिससे स्ट्रीम को रीस्टार्ट किए बिना फ़िल्टरिंग में बदलाव किए जा सकते हैं। Next.js · TypeScript · SSE

नमूना ऐप देखें

// Getting started

कुछ भी नया चलाने की जरूरत नहीं है। यह आपकी मौजूदा योजना के अनुसार काम करता है।

की-वैल्यू स्टोर हर किसी का हिस्सा है Quicknode बिना किसी अतिरिक्त व्यवस्था के योजना बनाएं। सूचियों को बनाएं और प्रबंधित करें। Quicknode डेवलपर पोर्टल का उपयोग करें, या खाते में पहले से मौजूद एपीआई कुंजी के साथ 13 रेस्ट एंडपॉइंट के माध्यम से सब कुछ करें।

// Sample apps

दो ऐप्स पहले से ही इस पैटर्न पर चल रहे हैं। उनमें से एक को क्लोन करें।

दोनों सैंपल ऐप्स ठीक उसी लूप पर आधारित हैं जिसका वर्णन इस पेज पर किया गया है: Streams फ़िल्टर एक वॉचलिस्ट को पढ़ता है जिसे की-वैल्यू स्टोर में रखा गया है, और स्ट्रीम चलने के दौरान इसे अपडेट किया जाता है।

// 01

एक सूची बनाएं।

डेवलपर पोर्टल से, या REST API पर एक POST अनुरोध के माध्यम से।

// 02

इसे अपनी पाइपलाइन में पढ़ें।

Call qnLib.qnContainsListItems in a Streams फ़िल्टर करें, या सूची को वेबहुक से कनेक्ट करें।

// 03

इसे कहीं से भी अपडेट करें।

बैकएंड या किसी अन्य माध्यम से सूची को पैच करें। agent फ़िल्टर चलाने से वर्तमान संस्करण पढ़ा जाता है।

// Docs

की-वैल्यू स्टोर दस्तावेज़

प्रत्येक endpoint और कार्य।

दस्तावेज़ पढ़ें

// Pricing

मूल्य निर्धारण

लेखन और भंडारण संबंधी वर्तमान शर्तें।

मूल्य निर्धारण देखें

क्या आप अपडेट रहना चाहते हैं?

डेवलपर उपकरण

दस्तावेज़ और गाइड