BLIX
0% trading fees on every trade · every account, no code ›

AI-powered memecoin terminal

Solana RPC explained

An RPC endpoint is the door between your code and the Solana network. Every wallet, explorer, bot and trading terminal reads balances and sends transactions through one. This page explains what an RPC node is, shows the JSON-RPC API with requests you can paste into a terminal, lists the methods you will use most and what each costs you, and covers the limits and errors that catch people in their first week.

The BLIX memecoin trading terminalExplore the BLIX terminal ↗

By BLIX · Updated · Solana fundamentals and on-chain data

On this page
  1. What an RPC node is
  2. Your first call
  3. The methods that matter
  4. Commitment: how sure do you need to be?
  5. Rate limits on the public endpoint
  6. Errors you will meet
  7. What an RPC cannot tell you
  8. HTTP or WebSocket
  9. Where BLIX fits
  10. More on Solana and on-chain data
Protocol
JSON-RPC 2.0 over HTTPS (requests) and WebSocket (subscriptions)
Public endpoint
https://api.mainnet-beta.solana.com, rate-limited, not for production
Reads
Accounts, balances, token accounts, transactions, blocks, slots
Writes
sendTransaction and simulateTransaction
Freshness
You choose: processed, confirmed or finalized
History
Limited on ordinary nodes; old data needs an archive node

What an RPC node is

Solana validators produce blocks. An RPC node is a machine that follows the chain without voting, keeps the current state in memory, and answers questions about it over the network. "RPC" means remote procedure call: you send the name of a method and its parameters, the node runs it and sends back the result. An RPC endpoint is just the URL of such a node, usually with your API key in it.

Nothing about an RPC is special to one app. Your wallet uses one to show your balance; an explorer uses one (plus its own database) to show a transaction; a bot uses one to send a trade. When an app "is down" while the chain is fine, the app's RPC provider is usually what failed.

Your first call

Every request is an HTTP POST with a JSON body. This one reads the SOL balance of an address from the public endpoint, with no key and nothing to install:

curl https://api.mainnet-beta.solana.com -H 'content-type: application/json' -d '{
  "jsonrpc": "2.0", "id": 1,
  "method": "getBalance",
  "params": ["<a wallet address>"]
}'

The answer has the same shape for every method: a context.slot saying how fresh the answer is, and a value.

{"jsonrpc":"2.0","result":{"context":{"slot":470672956},"value":2500000000},"id":1}

Balances are in lamports: 1 SOL is 1,000,000,000 lamports, so the value above is 2.5 SOL. Several requests can be sent as one JSON array (a batch), which saves round trips; providers count each item in the batch against your limit.

The methods that matter

MethodWhat it answersWorth knowing
getBalanceSOL held by an addressLamports. Does not include tokens.
getAccountInfoThe raw contents of one accountAsk for jsonParsed encoding and token mints and token accounts come back readable.
getMultipleAccountsUp to 100 accounts in one callThe cheapest way to refresh many balances or pools.
getTokenAccountsByOwnerEvery token a wallet holdsHeavy. Several free plans refuse it.
getTokenSupplyTotal supply of a tokenUse with the mint address.
getTokenLargestAccountsThe 20 largest holders of a tokenOnly 20. A full holder list needs an indexer.
getSignaturesForAddressTransactions that touched an address, newest firstAt most 1,000 per call; page backwards with before.
getTransactionOne transaction in fullPass maxSupportedTransactionVersion: 0 or modern transactions are refused.
getProgramAccountsEvery account owned by a program, filteredThe heaviest read there is. Often blocked or priced high.
getLatestBlockhashA recent blockhash to put in a transactionA transaction built on it expires after about 150 blocks.
simulateTransactionWhat a transaction would do, without sending itReturns logs and compute units used.
sendTransactionSubmits a signed transactionReturns the signature at once; that is not confirmation.

The full list is in the Solana RPC reference.

Commitment: how sure do you need to be?

Almost every method takes a commitment. It trades speed for certainty:

LevelMeaningUse it for
processedThe node has seen the block. It can still be dropped.Live prices and feeds where a rare correction is fine
confirmedTwo thirds of stake voted on the block. Reverting is very unlikely.Most apps; showing a trade as done
finalized31 or more confirmed blocks sit on top. It will not change.Deposits, withdrawals, accounting

The gap between processed and finalized is roughly thirteen seconds. Reading at finalized and wondering why your own transaction "is not there yet" is the most common beginner confusion.

Rate limits on the public endpoint

The public mainnet endpoint is run for testing, and its limits are per IP address. Solana's cluster page lists them, and they can change:

LimitValue
Requests per 10 seconds, all methods100
Requests per 10 seconds, one method40
Concurrent connections40
New connections per 10 seconds40
Data per 30 seconds100 MB

Heavy methods are throttled much harder than that table suggests. While writing this page, one getTokenLargestAccounts call on the public endpoint came straight back as 429 Too many requests for a specific RPC call. For anything beyond a script, use a provider key: the free Solana RPC comparison lists what each free plan really serves.

Errors you will meet

You seeIt meansDo this
HTTP 429Rate limit: too many requests, or one heavy methodSlow down, batch, cache, or spread reads over providers
Transaction version (0) is not supportedYou asked for a versioned transaction the old wayAdd maxSupportedTransactionVersion: 0
Node is behind / minimum context slot not reachedThis node has not caught up to the slot you needRetry, or try another endpoint
Blockhash not found / expiredThe transaction was built on a blockhash that is too oldFetch a new blockhash, sign again, resend
null from getTransactionNot confirmed at your commitment yet, or older than the node keepsRetry at confirmed; for old history use an archive-capable provider
Method not available / requires a paid planThe provider blocks that method on your planRoute that method to a provider that serves it

What an RPC cannot tell you

An RPC node answers questions about one account or one transaction quickly. It does not answer questions across the chain: "every wallet that bought this token in its first minute", "this wallet's profit on every coin", "all holders, sorted". Those need someone to have read every transaction as it happened and stored the result in a database. That job is called indexing, and it is the difference between an RPC provider and an analytics product. On-chain analytics explained walks through it.

HTTP or WebSocket

HTTP is ask-and-answer. To be told the moment something changes (an account's balance, a program's logs, a transaction's confirmation), open a WebSocket to the same host and subscribe. The Solana WebSocket tutorial has a complete working example.

Where BLIX fits

BLIX is not an RPC provider. It is a trading terminal that does the indexing for Solana memecoins and gives the result back as screens, and as JSON to accounts that want it: the BLIX API has 69 endpoints for launches, trades, holders, candles and wallets, which are exactly the across-the-chain questions a raw RPC cannot answer. If you need raw chain access, use an RPC. If you need "who holds this coin and who sold", that is a different tool.

More on Solana and on-chain data

This page is education about how the technology works. It is not financial advice, and nothing here recommends buying or selling anything.

Frequently asked questions

What is an RPC in crypto?

A remote procedure call endpoint: a server that follows a blockchain and answers requests about it. Wallets and apps use it to read balances and send transactions. On Solana it speaks JSON-RPC over HTTPS and WebSocket.

Is there a free Solana RPC?

Yes. The public endpoint needs no key but is tightly rate-limited, and several providers have free plans with a monthly allowance. The free Solana RPC comparison lists them with their real limits.

What is the Solana RPC URL for mainnet?

The public one is https://api.mainnet-beta.solana.com. Providers give you your own URL with a key in it, which is what an app should use.

Why does getTransaction return null?

Usually the transaction is not confirmed at the commitment you asked for yet, or the node no longer keeps a transaction that old. Retry at confirmed, and use an archive-capable provider for old history.

Do I need my own Solana node?

Almost never. Running one needs serious hardware and upkeep. A provider plan is cheaper until you are sending a very large number of requests or need custom streaming.

Your next move starts here.

Create your BLIX account to access the trading terminal. Join the Discord community to stay connected.