跳转到主要内容
POST
getTokenAccountsByOwner
只想跟踪新增代币?用 changedSince 获取某个 slot 之后修改过的账户,适合做增量资产更新。想过滤粉尘?excludeZero 参数会自动隐藏空代币账户,让结果更干净,也能减少带宽。
高负载注意事项此端点会把全部代币账户直接流式传给客户端。这对大多数钱包都没有问题,但在高负载下,或查询拥有数百万个代币账户的所有者(如协议拥有的账户)时,可能返回错误。需要更高的可靠性? 请改用 getTokenAccountsByOwnerV2。V2 方法支持分页,在大钱包和高流量场景下更高效、更可靠。
请求配置和错误处理见 RPC 快速入门。计费见积分与限制。

授权

api_key
string
query
必填

请求体

application/json
jsonrpc
enum<string>
必填

The JSON-RPC protocol version.

可用选项:
2.0
示例:

"2.0"

id
string
必填

A unique identifier for the request.

示例:

"1"

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

The name of the RPC method to invoke.

可用选项:
getTokenAccountsByOwner
示例:

"getTokenAccountsByOwner"

params
string · object · object[]
必填

Parameters for querying token accounts owned by a specific public key.

Solana wallet address (pubkey) of the account owner to query token holdings for, as a base-58 encoded string.

示例:

"A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd"

响应

Successfully retrieved token accounts by owner.

jsonrpc
enum<string>

The JSON-RPC protocol version.

可用选项:
2.0
示例:

"2.0"

id
string

Identifier matching the request.

示例:

"1"

result
object

Context and account details.