Quickstart

Activate an account and make your first Solana RPC call. Under 5 minutes.

What you need A Solana keypair (any Ed25519 key) and USDC on Solana mainnet for credits. That's it — no signups, no email, no dashboards.

Step 1 — Activate Your Account

Your Solana public key is your account ID. Call /account/activate to register it. This is idempotent — safe to call multiple times.

TypeScript

Python

curl

import { NodiusClient } from "@nodius/sdk";
import { Keypair } from "@solana/web3.js";

const keypair = Keypair.fromSecretKey(/* your secret key bytes */);
const rpc = new NodiusClient({
  endpoint: "https://rpc.nodius.xyz",
  keypair,
});

const account = await rpc.activate();
console.log("Deposit wallet:", account.depositWallet);

from nodius import NodiusClient
from solders.keypair import Keypair

keypair = Keypair.from_bytes(your_secret_key_bytes)
rpc = NodiusClient(endpoint="https://rpc.nodius.xyz", keypair=keypair)

account = rpc.activate()
print("Deposit wallet:", account.deposit_wallet)

# Generate auth headers (timestamp, nonce, signature)
TIMESTAMP=$(date +%s)
NONCE=$(openssl rand -hex 8)
BODY='{}'
BODY_HASH=$(echo -n "$BODY" | sha256sum | cut -d' ' -f1)
PAYLOAD="${TIMESTAMP}:${NONCE}:${BODY_HASH}"

# Sign with your keypair (use solana-keygen or your preferred tool)
# Then make the request:
curl -X POST https://rpc.nodius.xyz/account/activate \
  -H "Content-Type: application/json" \
  -H "X-Pubkey: YOUR_PUBLIC_KEY" \
  -H "X-Signature: YOUR_SIGNATURE" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Nonce: $NONCE" \
  -d "$BODY"

The response includes your depositWallet address for funding.

Step 2 — Deposit USDC

Send USDC (SPL Token) to the deposit wallet from the same wallet you activated with. The system identifies your account by the sender address.

Detail	Value
Currency	USDC only (SPL Token on Solana)
Minimum	1 USDC
Rate	1 USDC = 10,000 credits
Speed	~30 seconds after finalization

Important Send from the same wallet you used to activate. Deposits from other wallets won't be credited to your account. Only USDC is supported — do not send SOL or other tokens.

Step 3 — Make RPC Calls

Standard Solana JSON-RPC. Every response includes an X-Credits-Remaining header so you can track your balance.

TypeScript

Python

curl

// Get current slot (1 credit)
const slot = await rpc.call("getSlot");

// Get account info (1 credit)
const info = await rpc.call("getAccountInfo", [
  "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
  { encoding: "base64" }
]);

// Send transaction (2 credits)
await rpc.call("sendTransaction", [signedTx]);

# Get current slot (1 credit)
slot = rpc.call("getSlot")

# Get account info (1 credit)
info = rpc.call("getAccountInfo", [
    "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
    {"encoding": "base64"}
])

# Using an API key (simplest method):
curl -X POST https://rpc.nodius.xyz/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer nod_YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getSlot"}' -v

# Look for X-Credits-Remaining in response headers

Monitor Your Balance

Two ways to track credits:

Response headers — every response includes X-Credits-Remaining. When balance drops below 1,000, X-Credits-Low: true appears.
Account info endpoint — GET /account/info returns your full balance, tier, and usage stats.

What's Next

Authentication — choose between API keys, session tokens, or per-request signatures
API Reference — all methods, credit costs, and batch requests
WebSocket — real-time streaming subscriptions
Credits & Pricing — full pricing table and deposit details

← Documentation Authentication →