Overview
The Quicknode SDK is a single SDK for working with Quicknode product APIs from the language you already use: Rust, Python, Node.js, and Ruby.
Use it to build Quicknode product workflows, operational services, scripts, and AI agents that need typed access to:
- Admin API: Manage endpoints, usage, billing, teams, endpoint security, rate limits, logs, metrics, and account tags.
- Streams: Create, update, pause, activate, test, and delete Streams.
- Webhooks: Create and manage webhook subscriptions from Quicknode webhook templates.
- Key-Value Store: Store and retrieve sets and lists for application state, stream filters, watchlists, cursors, and agent memory.
Complete reference for developers and agents building with the Quicknode SDK:
When to use the SDK
Use the SDK when you want one consistent client for Quicknode product APIs, especially when your app or agent needs to coordinate multiple products in one workflow.
Common workflows include:
- Create or manage endpoints with the Admin API.
- Create a Stream and deliver filtered onchain data to a webhook destination.
- Store processing state or watchlists in Key-Value Store.
- Create webhooks from templates and manage their lifecycle.
- Build agent workflows that can inspect account state, provision resources, and clean up test infrastructure.
This SDK version is focused on Quicknode product APIs. If you need call the blockchain directly, use your Quicknode endpoint directly with your preferred chain library.
Packages
| Language | Package | Install |
|---|---|---|
| Node.js / TypeScript | @quicknode/sdk | npm install @quicknode/sdk |
| Python | quicknode-sdk | pip install quicknode-sdk |
| Rust | quicknode-sdk | cargo add quicknode-sdk --features rust |
| Ruby | quicknode_sdk | gem install quicknode_sdk |
Platform support
The SDK is built around a shared Rust core with bindings for specific languages. The core compiles to native libraries for each supported platform, giving you predictable performance and a small dependency footprint. The trade-off is that we publish binaries for a specific set of targets rather than running in every environment our host languages support.
Supported targets
Precompiled native modules are published for:
| Platform | Targets |
|---|---|
| Linux (glibc) | x86_64, aarch64 on glibc 2.17+ (manylinux2014) |
| Linux (musl) | x86_64, aarch64 on Alpine and other musl distros |
| macOS | Apple Silicon (arm64) |
Linux glibc binaries are built against glibc 2.17, so they load on any distro released from 2014 onward, including RHEL 7+, Ubuntu 14.04+, Debian 8+, Amazon Linux 2+, SLES 12+, and Fedora 19+.
Not supported
- Browsers: The Quicknode SDK is not browser-compatible. It uses a Rust core through native bindings, which require Node.js or another runtime that supports native add-ons. Standard browser bundles cannot load these bindings.
- Windows: No precompiled binary is published. WSL2 works and is the recommended path for Windows developers.
- Intel macOS: Apple Silicon only.
- Older Linux distros: below the glibc floor: RHEL/CentOS 6 (glibc 2.12), Debian 7 (glibc 2.13), Ubuntu 12.04 (glibc 2.15), SLES 11 (glibc 2.11).
On an unsupported platform, importing the SDK fails fast at load time with an error listing the available targets. The failure surfaces at install or import, not at first call.
Product clients
Construct the SDK once, then use the product clients exposed from that shared configuration.
| Client | Purpose | REST API |
|---|---|---|
admin | Endpoints, teams, usage, logs, billing, metrics, security, and rate limits | https://api.quicknode.com/v0/ |
streams | Streams creation, updates, lifecycle, and filter testing | https://api.quicknode.com/streams/rest/v1/ |
webhooks | Webhook templates, destinations, lifecycle, and counts | https://api.quicknode.com/webhooks/rest/v1/ |
kvstore | Sets and lists for persisted state | https://api.quicknode.com/kv/rest/v1/ |
The SDK entry point is QuicknodeSdk in each language binding. Ruby exposes it as QuicknodeSdk::SDK.
Authentication
Create an API key in the Quicknode dashboard, then configure the SDK with the QN_SDK__API_KEY environment variable.
export QN_SDK__API_KEY="YOUR_API_KEY"
The SDK also supports base URL overrides for local development, staging, and agent sandboxes:
| Environment variable | Default |
|---|---|
QN_SDK__ADMIN__BASE_URL | https://api.quicknode.com/v0/ |
QN_SDK__STREAMS__BASE_URL | https://api.quicknode.com/streams/rest/v1/ |
QN_SDK__WEBHOOKS__BASE_URL | https://api.quicknode.com/webhooks/rest/v1/ |
QN_SDK__KVSTORE__BASE_URL | https://api.quicknode.com/kv/rest/v1/ |
QN_SDK__HTTP__TIMEOUT_SECS | 30 |
For agents
The SDK is designed to be useful for humans and agents. Agents can initialize one SDK handle, reuse the same credentials across product clients, and rely on typed method inputs and responses instead of composing raw REST calls for each workflow.
Next steps
- Start with the Quick Start to install and initialize the SDK.
- Use Examples to see Admin API, Streams, Webhooks, and Key-Value Store workflows.
- Refer to the product API docs for complete endpoint behavior: Admin API, Streams, Webhooks, and Key-Value Store.
We ❤️ Feedback
Share feedback on missing methods, naming, examples, and agent workflows so we can keep improving the SDK.