Credits meter RPC and REST usage. Each plan includes a monthly credit allowance that resets on your billing cycle.
Checking balance
curl "https://kwery-api.com/v1/limits" \
-H "X-API-Key: kwery_live_YOUR_KEY"
Response headers on each request:
| Header | Description |
|---|---|
X-Credits-Used | Credits charged for this request |
X-Credits-Remaining | Balance after this request |
X-Plan | Your plan tier (free, developer, business) |
Monthly allocation
| Plan | Monthly credits |
|---|---|
| Free | 1M |
| Developer | 10M |
| Business | 50M |
Credits reset monthly. On paid plans, additional usage is billed at $2 per million credits (autoscaling coming soon).
Standard RPC credits
Most Kaspa JSON-RPC calls cost 1 credit. Indexed, bulk, or write operations cost 5 credits.
Kwery supports all standard Kaspa wRPC methods (rusty-kaspa v2). See JSON-RPC reference for the full list.
| Tier | Credits | Methods |
|---|---|---|
| Light | 1 | ping, getServerInfo, getBlockDagInfo, getSink, getFeeEstimate, getSyncStatus, … |
| Heavy | 5 | getBlock, getBlocks, getUtxosByAddresses, getVirtualChainFromBlockV2, submitTransaction, … |
| Account | 0 | GET /v1/limits, GET /v1/status |
Blocked on shared nodes
Node-admin (addPeer, ban, shutdown) and raw wRPC subscriptions (subscribe, notify*) are not proxied — use Kwery WebSockets for events.
Enhanced APIs & webhooks (Developer+)
| Service | Credits | Notes |
|---|---|---|
| Enhanced REST APIs | 10 + per row | Address activity, parsed transactions (beta) |
| Webhook delivery | 1 | Per event delivered to your endpoint |
| Webhook management | 0 | Create and manage via dashboard |
Exhausted credits
When your monthly credits are used up, requests return 402 Payment Required until the next billing cycle or a plan upgrade. Paid plans will support purchasing additional credits at $2/M.
vs Helius (Solana)
Kwery mirrors Helius-style metering — monthly credits, per-call costs, rate limits — at prices tuned for Kaspa:
| Helius Developer | Kwery Developer | |
|---|---|---|
| Price | ~$25–49/mo | $12/mo |
| Credits | 10M | 10M |
| Standard RPC | 1 credit | 1 credit |
| Overage | $5 / 1M | $2 / 1M |