Nodius
Permissionless Solana RPC for trading bots and AI agents.
Nodius is a high-performance JSON-RPC proxy for the Solana blockchain, purpose-built for automated systems. No email signups, no subscriptions, no manual approval. Authenticate with your Solana wallet, deposit USDC, and start making calls.
Why Nodius?
Most RPC providers are designed for human developers building dApps. Nodius is designed for machines โ trading bots, MEV searchers, AI agents, and automated infrastructure that needs reliable, low-latency Solana access without the friction of traditional API services.
Autonomous agents and bots can't fill out KYC forms or wait for manual approval. Nodius provides permissionless access: authenticate with a Solana keypair, fund with USDC, start making calls. No human in the loop required.
Key Features
- Wallet-native signup โ Authenticate with your Solana keypair. Your public key is your identity. API keys and sessions available for low-latency automated traffic.
- Credit-based billing โ Deposit USDC (minimum $0.01). Credits are deducted per call based on method weight. No subscriptions, no invoices.
- Method-weighted pricing โ
getSlotcosts 1 credit. Heavier methods cost more per call. You pay for what you use, proportional to the computational cost. - WebSocket support โ Stream account changes, slot updates, and transaction signatures with metered WebSocket subscriptions.
- sendAndConfirm landing โ Multi-leg send (local RPC + Jito + TPU QUIC) with confirmation polling and auto-resend. Outcome-priced: the landing premium is refunded if the transaction doesn't confirm.
- Signals firehose โ
subscribeSignalstreams decoded new-pair events the moment a pool is created, classified rule-based from the Geyser feed with exact launch discriminators. Per-event billing, WebSocket or webhook push. - Jito integration โ Send bundles via
sendBundlefor MEV-protected transactions, billed by credits. - Yellowstone gRPC โ High-performance streaming via gRPC on port 10001. Subscribe to accounts, transactions, slots, and blocks.
- Bulk endpoints โ Batch balance lookups, token balance lookups, and transaction queries via dedicated bulk endpoints.
- Webhooks โ Register webhook endpoints for real-time event notifications.
Architecture
Client โ Nodius (Frankfurt) โ Agave Node (direct)
- Single server: High-performance bare metal in Frankfurt, Germany (EU-Central)
- Direct Agave node: No shared validator pools. Dedicated Agave client connected to Solana mainnet.
- No CDN, no edge: One hop. Minimal latency for EU-based infrastructure. Predictable routing for global clients.
This is not a distributed mesh of load-balanced nodes. It's a single, fast machine with a direct connection to the Solana cluster. Simple. Reliable. Fast.
Credit-Only Access
Nodius does not use subscriptions or account-plan upgrades. Customers deposit USDC, receive credits, and spend credits on requests. Heavy methods cost more credits. Some historical methods are not available and return -32004 at no charge.
| Item | Value |
|---|---|
| Credit rate | See GET /pricing |
| Credits expire | 10 days after deposit |
| Hot RPC + send | Credit-gated |
| WebSocket streams | Credit-gated |
| Yellowstone gRPC | Credit-gated |
| Heavy methods | Available (25 credits) |
| Historical methods | Not available (returns -32004, no charge) |
Quick Links
- Quickstart Guide โ Get running in 5 minutes
- Bot & Agent Guide โ Onboarding flow, auth methods, hot-path tips
- Authentication โ Wallet signatures, API keys, session tokens
- Credits & Pricing โ How billing works, method costs, refund policy
- API Reference โ All endpoints and methods
- Streaming Guide โ WebSocket subscriptions, Yellowstone gRPC, reconnect behavior
- Error Reference โ Status codes, error constants, and troubleshooting
- Customer Support โ support contact
SDK
# TypeScript / JavaScript
npm install @nodiusxyz/sdk
# Python
pip install nodiusxyz
Both SDKs provide simple factory methods โ no need to import @solana/web3.js or solders directly:
- TypeScript:
NodiusClient.fromSecretKey(endpoint, base58Key)โ create a client from a base58 secret key - Python:
NodiusClient.from_base58(endpoint, secret_key='...')โ handles base58 decode + optional 32-byte seed expansion
Both support generateApiKey() (TypeScript) / generate_api_key() (Python) which auto-stores the returned API key for future calls. Credits are tied to your pubkey โ deposit USDC to start making calls, or enable x402 auto-pay for zero-setup onboarding.
See the Quickstart for usage.
Endpoints
RPC (HTTP):
POST https://rpc.nodius.xyz/
POST https://rpc.nodius.xyz/rpc
WebSocket:
wss://rpc.nodius.xyz/ws
Yellowstone gRPC:
grpc://rpc.nodius.xyz:10001
Status
Service status and incident history: nodius.xyz/status