Skip to main content
POST
Get token balances for multiple wallets in a single request with getTokenAccountsByOwners. Powered by Ridge DB, our custom-built client designed for high-performance token account queries. Instead of making hundreds of individual requests, query up to 250 wallets at once for any token mint. Query up to 250 wallet addresses in one request to reduce API calls and latency.
  • If a wallet has multiple accounts for the same mint, the response returns all of them.
  • If a wallet has no token account, the response returns a clean zero balance instead of an error.
  • Each account includes the slot when the balance was last updated, which helps with caching and change tracking.
Request setup and error handling: RPC quickstart. Billing: credits and limits.

Authorizations

api_key
string
query
required

Body

application/json
jsonrpc
enum<string>
default:2.0
required

The JSON-RPC protocol version.

Available options:
2.0
Example:

"2.0"

id
string
default:1
required

A unique identifier for the request.

Example:

"1"

method
enum<string>
default:getTokenAccountsByOwners
required

The name of the RPC method to invoke.

Available options:
getTokenAccountsByOwners
Example:

"getTokenAccountsByOwners"

params
(string[] | string)[]
required

Parameters for the batch token balance query.

Array of owner wallet public keys to query (1-250 wallets). All pubkeys must be valid base-58 encoded Solana addresses.

Required array length: 1 - 250 elements

Owner wallet public key as a base-58 encoded string.

Response

Successfully retrieved token account balances for all requested owners.

jsonrpc
enum<string>

The JSON-RPC protocol version.

Available options:
2.0
Example:

"2.0"

id
string

Identifier matching the request.

Example:

"1"

result
object

Token account balances with context information.