跳转到主要内容
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.

授权

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.