跳转到主要内容
POST
使用 getTokenAccountsByOwners 在一次请求中获取多个钱包的代币余额。该方法由 Ridge DB 驱动,这是我们自研的客户端,专为高性能代币账户查询设计。无需发送数百个单独请求,对任意代币 mint 一次最多可查询 250 个钱包。 一次请求最多查询 250 个钱包地址,减少 API 调用次数和延迟。
  • 如果钱包在同一 mint 下有多个账户,响应会全部返回。
  • 如果钱包没有代币账户,响应会返回零余额,而不是错误。
  • 每个账户都包含余额最后更新时的 slot,便于缓存和跟踪变化。
请求配置和错误处理见 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.