Skip to main content
POST
⚡ Powered by Solana Ridge DBGet 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.What makes it different: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.

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.