跳转到主要内容
POST
getTokenAccountsByOwner
curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getTokenAccountsByOwner",
  "params": [
    "A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd",
    {
      "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
    },
    {
      "encoding": "jsonParsed"
    }
  ]
}
'
{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "context": {
      "apiVersion": "2.0.15",
      "slot": 341197933
    },
    "value": [
      {
        "pubkey": "BGocb4GEpbTFm8UFV2VsDSaBXHELPfAXrvd4vtt8QWrA",
        "account": {
          "lamports": 2039280,
          "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "data": {
            "program": "spl-token",
            "parsed": {
              "info": {
                "isNative": false,
                "mint": "2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR",
                "owner": "A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd",
                "state": "initialized",
                "tokenAmount": {
                  "amount": "420000000000000",
                  "decimals": 6,
                  "uiAmount": 420000000,
                  "uiAmountString": "420000000"
                }
              }
            },
            "space": 165
          },
          "executable": false,
          "rentEpoch": 18446744073709552000,
          "space": 165
        }
      }
    ]
  }
}
新功能：getTokenAccountsByOwner 现在支持 changedSinceSlot 参数用于增量更新。指定时，该方法仅返回在给定 slot 编号或之后修改过的 token 账户。这对于跟踪 token 余额变化和投资组合更新非常理想。

​
请求参数

​
address
string
必填
查询 token 持有情况的账户所有者的 Solana 钱包地址（pubkey），为 base-58 编码字符串。
​
mint
string
特定的 Solana token mint 地址，仅检索特定 token 或 NFT 的账户。
​
programId
string
创建 token 账户的特定 Solana token 程序 ID（通常为 SPL Token 程序）。
​
commitment
string
请求的承诺级别。
  • confirmed
  • finalized
  • processed
​
minContextSlot
number
请求可以评估的最小 slot。
​
dataSlice
object
请求账户数据的一部分。
​
dataSlice.length
number
要返回的字节数。
​
dataSlice.offset
number
开始读取的字节偏移量。
​
encoding
string
账户数据的编码格式。
  • base58
  • base64
  • base64+zstd
  • jsonParsed
​
changedSinceSlot
number
仅返回在此 slot 编号或之后修改过的账户。用于增量更新非常有用。

授权

​
api-key
string
query
必填

您的Helius API密钥。您可以在仪表板中免费获取一个。

请求体

application/json
​
jsonrpc
enum<string>

JSON-RPC协议版本。

可用选项:
2.0
示例:

"2.0"

​
id
string

请求的唯一标识符。

示例:

"1"

​
method
enum<string>
默认值:getTokenAccountsByOwner

要调用的RPC方法名称。

可用选项:
getTokenAccountsByOwner
示例:

"getTokenAccountsByOwner"

​
params
string · object · object[]

用于查询由特定公钥拥有的代币账户的参数。

要查询代币持有的账户所有者的Solana钱包地址（公钥），以base-58编码的字符串形式。

示例:

"A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd"

响应

成功检索到所有者的代币账户。

​
jsonrpc
enum<string>

JSON-RPC协议版本。

可用选项:
2.0
示例:

"2.0"

​
id
string

与请求匹配的标识符。

示例:

"1"

​
result
object

上下文和账户详细信息。