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.
请求配置和错误处理见 RPC 快速入门。计费见积分与限制。

授权

api_key
string
query
必填

请求体

application/json
jsonrpc
enum<string>
默认值:2.0
必填

The JSON-RPC protocol version.

可用选项:
2.0
示例:

"2.0"

id
string
默认值:1
必填

A unique identifier for the request.

示例:

"1"

method
enum<string>
默认值:getTokenAccountsByOwners
必填

The name of the RPC method to invoke.

可用选项:
getTokenAccountsByOwners
示例:

"getTokenAccountsByOwners"

params
(string[] | string)[]
必填

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.

响应

Successfully retrieved token account balances for all requested owners.

jsonrpc
enum<string>

The JSON-RPC protocol version.

可用选项:
2.0
示例:

"2.0"

id
string

Identifier matching the request.

示例:

"1"

result
object

Token account balances with context information.