# Nodius

> Permissionless Solana RPC for trading bots and AI agents. Wallet-based auth, USDC credits, no signups. Frankfurt bare metal, direct Agave node, no CDN. JSON-RPC over HTTPS, WebSocket, and Yellowstone gRPC.

Endpoints:

- RPC: `POST https://rpc.nodius.xyz/`
- WebSocket: `wss://rpc.nodius.xyz/ws`
- Yellowstone gRPC: `grpc://rpc.nodius.xyz:10001`

Auth: Ed25519 wallet signature on canonical message `solana-nodius:v2:{METHOD}:{PATH}:{TIMESTAMP}:{NONCE}:{SHA256_BODY_HEX}`. API keys and session tokens also available. x402 auto-pay supported for zero-setup onboarding.

Billing: Prepaid USDC credits, per-method pricing. `getSlot` = 1 credit, `getAccountInfo` = 1, `simulateTransaction` = 5, `getTokenAccountsByOwner` = 25, `sendTransaction` = 2. Credits expire 10 days after deposit. Live rate: `GET https://rpc.nodius.xyz/pricing`.

SDKs: `npm install @nodius/sdk` (TypeScript) or `pip install nodius` (Python). Both support `generateApiKey()` for low-latency API key auth.

## Docs

- [Overview](https://nodius.xyz/docs/readme.html): Architecture, features, credit model, endpoints
- [Quickstart](https://nodius.xyz/docs/quickstart.html): Get from zero to first RPC call in 5 minutes
- [Bot & Agent Guide](https://nodius.xyz/docs/BOT_GUIDE.html): Onboarding flow, auth methods, hot-path tips
- [Authentication](https://nodius.xyz/docs/authentication.html): Wallet signatures, API keys, session tokens
- [API Reference](https://nodius.xyz/docs/api-reference.html): All endpoints, methods, credits, raw examples
- [Streaming Guide](https://nodius.xyz/docs/websocket.html): WebSocket subscriptions, Yellowstone gRPC, reconnect behavior
- [Credits & Pricing](https://nodius.xyz/docs/billing.html): How credits work, method costs, refund policy
- [Error Reference](https://nodius.xyz/docs/errors.html): Status codes, JSON-RPC error constants, troubleshooting
- [Customer Support](https://nodius.xyz/docs/CUSTOMER_SUPPORT.html): Support contact and what to include in a request

## Optional

- [Status Page](https://nodius.xyz/status.html): Live service health and incident history
- [Console](https://nodius.xyz/dashboard.html): Wallet-connected dashboard for account management