方法与演练场
获取代币账户
返回按所有者地址、铸币地址或两者过滤的代币账户列表。用于查找与钱包关联的所有代币账户或持有特定代币的所有账户。
必须提供 ownerAddress 或 mintAddress 中的至少一个。
参数
| 名称 | 必需 | 描述 |
|---|---|---|
ownerAddress | （仅在未提供 mintAddress 时必需） | 按所有者地址过滤。 |
mintAddress | （仅在未提供 ownerAddress 时必需） | 按铸币地址过滤。 |
cursor | 分页游标。 | |
page | 分页页码。 | |
limit | 返回的最大代币账户数量。 | |
before | 返回此游标之前的账户。 | |
after | 返回此游标之后的账户。 | |
options | 查询显示选项。也可使用 displayOptions。 | |
options.showZeroBalance | 是否在结果中包含零余额账户。 | |
options.showFungible | API 接受；在此方法上保留供将来使用。 | |
options.showCollectionMetadata | API 接受；在此方法上保留供将来使用。 | |
options.showUnverifiedCollections | API 接受；在此方法上保留供将来使用。 | |
options.showInscription | API 接受；在此方法上保留供将来使用。 |
响应
响应包括：
token_accounts- 代币账户对象数组，包含：address- 代币账户地址amount- 账户中的代币余额mint- 代币的铸币地址owner- 账户的所有者地址delegate- 委托地址（如果有）delegated_amount- 委托给委托人的数量frozen- 账户是否被冻结close_authority- 关闭权限地址（如果有）extensions- 代币扩展数据
errors- 处理过程中遇到的任何错误数组total- 当前页返回的代币账户数量- 分页字段：
cursor、page、limit、before、after
没有匹配账户的所有者或铸币会返回空的 token_accounts 数组，而不是错误。