Quicknode Blockchain Infrastructure
Intake Questions
- Which chain and network should Quicknode target?
- Is this read-only or should I create infrastructure (streams, webhooks, IPFS writes)?
- Does this require real-time streaming (gRPC/Yellowstone/Hypercore) or standard RPC?
- What endpoint or API key should I use (default:
QUICKNODE_RPC_URL, optionalQUICKNODE_WSS_URL/QUICKNODE_API_KEY)? - If no API key exists, does the agent want pay-per-request access (x402, MPP) or a wallet-paid Quicknode account via [Agent Subscriptions](#agent-subscriptions)?
- Any constraints (latency, regions, throughput, destinations)?
Safety Defaults
- Default to testnet/devnet when a network is not specified.
- Prefer read-only operations and dry runs before creating resources.
- Never ask for or accept private keys or secret keys.
Confirm Before Write
- Require explicit confirmation before creating or modifying Streams, Webhooks, or IPFS uploads.
- Require explicit confirmation before creating an Agent Subscription, topping up credits, or any action that spends real funds via x402 or MPP.
- If confirmation is missing, return the exact API payload for review.
Quick Reference
| Product | Description | Use Case | |---------|-------------|----------| | RPC Endpoints | High-performance blockchain access | dApp backend, wallet interactions | | Streams | Real-time & historical blockchain data pipelines | Event monitoring, analytics, indexing | | Webhooks | Event-driven notifications | Alerts, transaction monitoring | | IPFS | Decentralized file storage | NFT metadata, asset hosting | | Add-ons | Enhanced blockchain APIs | Token balances, NFT data, DeFi | | DAS API | Solana Digital Asset Standard (add-on) | NFT/token queries, compressed NFTs, asset search | | Yellowstone gRPC | Solana Geyser streaming (add-on) | Real-time account, transaction, slot data | | Hypercore | Hyperliquid gRPC/JSON-RPC/WS (beta) | Trades, orders, book updates, blocks, TWAP, events, writer actions | | SQL Explorer | Direct SQL access to indexed blockchain data | Trading analytics, historical queries, market analysis | | Admin API | REST API for account management | Endpoint CRUD, usage monitoring, billing | | Key-Value Store | Serverless key-value and list storage (beta) | Persistent state for Streams, dynamic address lists | | x402 | Pay-per-request ($0.001/call) or credit drawdown ($10/1M) RPC via stablecoins | Keyless RPC access, AI agents, pay-as-you-go | | MPP | Pay-per-request RPC via IETF Payment Authentication headers | AI agents, multi-service payments, high-volume sessions | | Agent Subscriptions | Wallet-paid Quicknode account creation via x402 or MPP, returns a QN_* full platform API key | Autonomous agents that need full platform access without dashboard signup |
RPC Endpoints
Quicknode provides low-latency RPC endpoints for 80+ blockchain networks.
Endpoint Setup
// EVM chains (ethers.js)
import { JsonRpcProvider } from 'ethers';
const provider = new JsonRpcProvider(process.env.QUICKNODE_RPC_URL!);
// EVM chains (viem)
import { createPublicClient, http } from 'viem';
import { mainnet } from 'viem/chains';
const client = createPublicClient({
chain: mainnet,
transport: http(process.env.QUICKNODE_RPC_URL!),
});
// Solana
import { createSolanaRpc } from '@solana/kit';
const rpc = createSolanaRpc(process.env.QUICKNODE_RPC_URL!);Authentication
Quicknode endpoints include authentication in the URL:
https://{ENDPOINT_NAME}.{NETWORK}.quiknode.pro/{API_KEY}/For additional security, enable JWT authentication or IP allowlisting in the Quicknode dashboard.
Supported Networks
| Category | Networks | |----------|----------| | EVM | Ethereum, Polygon, Arbitrum, Optimism, Base, BSC, Avalanche, Fantom, zkSync, Scroll, Linea, Hyperliquid EVM (HyperEVM) | | Non-EVM | Solana, Bitcoin, NEAR, Stacks, Cosmos, Sei, Aptos, Sui, TON, Hyperliquid (HyperCore) |
Not exhaustive. Full list: https://www.quicknode.com/chains
Rate Limits & Plans
As of 2026-02-02. Verify current limits in Quicknode docs before sizing a production system.
| Plan | Requests/sec | Credits/month | |------|-------------|---------------| | Free Trial | 15 | 10M | | Build | 50 | 80M | | Accelerate | 125 | 450M | | Scale | 250 | 950M | | Business | 500 | 2B |
See [references/rpc-reference.md](references/rpc-reference.md) for complete RPC documentation including method tables for EVM, Solana, and Bitcoin chains, WebSocket patterns, and batch request examples.
Streams
Real-time & historical blockchain data pipelines that filter, transform, and deliver data to your destinations.
Stream Types
| Type | Data | Use Case | |------|------|----------| | Block | Full block data | Block explorers, analytics | | Transaction | Transaction details | Tx monitoring, indexing | | Logs | Contract events | DeFi tracking, NFT sales, token transfers | | Receipt | Transaction receipts | Gas analysis, status tracking |
Quick Setup
- Create stream in Quicknode dashboard
- Select network and data type
- Add filter function (JavaScript)
- Configure destination (webhook, S3, database)
Basic Filter Function
See [references/streams-reference.md](references/streams-reference.md) for filter examples and full Streams documentation.
Webhooks
Event-driven notifications for blockchain activity.
Webhooks vs Streams
| Feature | Webhooks | Streams | |---------|----------|---------| | Setup | Simple | More configuration | | Filtering | Address/event-based | Custom JavaScript | | Destinations | HTTP endpoint only | Webhook, S3, Postgres, Azure | | Processing | Basic | Full transformation | | Use Case | Simple alerts | Complex pipelines |
Webhook Setup
See [references/webhooks-reference.md](references/webhooks-reference.md) for API examples and full Webhooks documentation.
IPFS Storage
Decentralized file storage with Quicknode's IPFS gateway.
See [references/ipfs-reference.md](references/ipfs-reference.md) for upload examples, metadata examples, and complete IPFS documentation.
Marketplace Add-ons
Enhanced APIs available through Quicknode's marketplace.
Token API (Ethereum)
// Get all token balances for an address
const response = await fetch(process.env.QUICKNODE_RPC_URL!, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
method: 'qn_getWalletTokenBalance',
params: [{ wallet: '0x...', contracts: [] }]
})
});NFT API (Ethereum)
// Fetch NFTs owned by address
const response = await fetch(process.env.QUICKNODE_RPC_URL!, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
method: 'qn_fetchNFTs',
params: [{ wallet: '0x...', page: 1, perPage: 10 }]
})
});Solana Priority Fee API
// Get recommended priority fees
const response = await rpc.request('qn_estimatePriorityFees', {
last_n_blocks: 100,
account: 'YOUR_ACCOUNT'
}).send();Metis - Jupiter Swap API
// Using Metis - Jupiter Swap API
import { createJupiterApiClient } from '@jup-ag/api';
const jupiterApi = createJupiterApiClient({
basePath: `${process.env.QUICKNODE_METIS_URL}`
});
const quote = await jupiterApi.quoteGet({
inputMint: 'So11111111111111111111111111111111111111112',
outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
amount: 1000000000,
slippageBps: 50
});
const swapResult = await jupiterApi.swapPost({
swapRequest: {
quoteResponse: quote,
userPublicKey: 'YourPubkey...'
}
});See [references/marketplace-addons.md](references/marketplace-addons.md) for complete Add-ons documentation.
Solana DAS API (Digital Asset Standard)
Comprehensive API for querying Solana digital assets — standard NFTs, compressed NFTs (cNFTs), fungible tokens, MPL Cor