API Reference

All endpoints, methods, credit costs, and response formats.

Base URL: https://rpc.nodius.xyz
Auth: API key, session token, or per-request wallet signature. See Authentication.

JSON-RPC Endpoint

POST / — Standard Solana JSON-RPC. Send a JSON body with jsonrpc, method, params, and id.

curl
TypeScript
curl -X POST https://rpc.nodius.xyz/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getSlot"}'

# Response:
# {"jsonrpc":"2.0","result":123456789,"id":1}
const slot = await rpc.call("getSlot");
const balance = await rpc.call("getBalance", ["PUBKEY"]);

Batch Requests

Send up to 20 methods in a single request. Each method billed individually; the batch counts as 1 request for rate limits.

curl -X POST https://rpc.nodius.xyz/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '[
    {"jsonrpc":"2.0","id":1,"method":"getSlot"},
    {"jsonrpc":"2.0","id":2,"method":"getBalance","params":["PUBKEY"]}
  ]'

Supported Methods

All standard Solana JSON-RPC methods are supported. Credit cost shown per call.

Account Information

MethodCreditsDescription
getAccountInfo1Account data, owner, lamports, executable flag
getBalance1SOL balance in lamports
getMultipleAccounts1Batch account lookup (up to 100)
getProgramAccounts25All accounts owned by a program ⚡ Performance only
getMinimumBalanceForRentExemption1Minimum lamports for rent exemption

Block & Slot Data

MethodCreditsDescription
getSlot1Current slot number
getBlock25Full block with transactions
getBlockHeight1Current block height
getBlockTime1Estimated production time for a block
getBlocks1Confirmed blocks between two slots
getBlocksWithLimit1Confirmed blocks starting from a slot
getEpochInfo1Current epoch info
getEpochSchedule1Epoch schedule parameters
getLatestBlockhash1Latest blockhash and last valid block height
isBlockhashValid1Check if a blockhash is still valid

Transactions

MethodCreditsDescription
getTransaction5Transaction details by signature
getSignaturesForAddress5Signatures for an address
getSignatureStatuses1Status of transaction signatures
simulateTransaction5Simulate without submitting
sendTransaction2Submit a signed transaction (Jito dual-send included)

Token Information

MethodCreditsDescription
getTokenAccountBalance1Token balance for an account
getTokenAccountsByOwner1All token accounts for a wallet
getTokenLargestAccounts1Largest holders of a token
getTokenSupply1Total supply of a token

Network & System

MethodCreditsDescription
getHealth1Node health status
getVersion1Solana software version
getGenesisHash1Genesis hash
getIdentity1Node identity public key
getClusterNodes1All cluster nodes
getRecentPerformanceSamples1Recent slot performance
getRecentPrioritizationFees1Recent priority fee data
getPriorityFeeEstimate1Estimated priority fee for current conditions
getSupply1SOL supply breakdown
getVoteAccounts1Current and delinquent vote accounts
getInflationRate1Current inflation rate
getInflationReward1Inflation rewards for addresses
getStakeActivation1Stake activation state
Denied Method requestAirdrop is not supported and returns an error.

Jito & Bundles

MEV-protected transaction submission via Jito. sendTransaction includes automatic Jito dual-send at no extra cost.

EndpointCreditsTierDescription
POST /jito/sendBundle10PerformanceSubmit a Jito bundle
POST /jito/getBundleStatuses2AllCheck bundle landing status
GET /jito/getTipAccounts1AllCurrent tip accounts
GET /jito/tipFloor1AllCurrent tip floor
POST /jito/simulateBundle25PerformanceSimulate a bundle

Bulk Queries

Optimized batch lookups for common patterns.

EndpointDescription
POST /bulk/getBalancesBatch SOL balance lookup
POST /bulk/getTokenBalancesBatch token balance lookup
POST /bulk/getTransactionsBatch transaction lookup

Yellowstone gRPC

High-performance streaming via Geyser plugin.

DetailValue
Endpointgrpc://rpc.nodius.xyz:10001
Cost60 credits/minute per active connection
Authauthorization: Bearer TOKEN in gRPC metadata
SubscriptionsAccounts, transactions, slots, blocks, entries

See the Yellowstone gRPC documentation for proto definitions and client libraries.

Account Management

EndpointMethodDescription
/account/activatePOSTRegister or retrieve your account. Returns deposit wallet.
/account/infoGETBalance, tier, usage stats, rate limits
/account/ledgerGETDeposit and debit history
/account/historyGETDetailed RPC call log
/account/api-keyPOSTGenerate a persistent API key
/account/confirm-depositPOSTManually trigger deposit detection
/account/tierPOSTSwitch tier: {"tier": "performance"} or {"tier": "standard"}

Authentication Endpoints

EndpointMethodDescription
/auth/challengePOSTRequest a signing challenge
/auth/verifyPOSTSubmit signed challenge for a session token
/auth/logoutPOSTRevoke current session token

Webhooks

EndpointMethodDescription
/webhooksPOSTRegister a webhook for event notifications
/webhooksGETList your registered webhooks
/webhooks/{id}DELETERemove a webhook

Health Check

GET /health — public, no auth required. Returns node status, current slot, and software version.

curl https://rpc.nodius.xyz/health
# {"status":"ok","timestamp":1712000000}

Response Headers

HeaderDescription
X-Credits-RemainingCurrent credit balance
X-Credits-Lowtrue when balance < 1,000
X-Ratelimit-LimitYour rate limit (req/s)
X-Ratelimit-RemainingRemaining requests in current window
X-Ratelimit-ResetUnix timestamp when limit resets
X-Request-IdUnique request ID for debugging

Request Timeouts

CategoryTimeoutExamples
Read — Light5sgetSlot, getBalance
Read — Medium15sgetTransaction, simulateTransaction
Read — Heavy30sgetProgramAccounts, getBlock
Send10ssendTransaction, sendBundle