getLargestAccounts

getLargestAccounts returns the 20 Solana accounts holding the most native SOL, each as an { address, lamports } pair ranked by lamport balance (1 SOL = 1,000,000,000 lamports). It gives a quick top-of-the-book view of where SOL is concentrated across the network. Call it as a JSON-RPC 2.0 POST with positional params against https://solana.therpc.io/YOUR_API_KEY, and pass an optional filter of circulating or nonCirculating to look at just one class of holders.

Use cases

• List the biggest SOL holders for a network overview or analytics page.
• Separate the top circulating accounts from non-circulating ones (such as stake and reserve accounts) by passing filter: "circulating" or filter: "nonCirculating".
• Drive a "whale watch" dashboard widget that highlights the largest SOL balances on the network.

Parameters

Response

Example request

1curl https://solana.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5  "jsonrpc": "2.0",
6  "id": 1,
7  "method": "getLargestAccounts",
8  "params": [
9    {}
10  ]
11}'

Errors & troubleshooting

Common pitfalls

• The result is cached by the validator and refreshes slowly, so treat it as a periodic snapshot rather than a real-time, slot-accurate ranking.
• Only the top 20 accounts are ever returned; there is no offset or pagination to read positions 21 and beyond.

Supported networks

• Mainnet
• Devnet

See also

• getSupply
• getTokenLargestAccounts