getCompressedTokenAccountsByOwner Solana RPC 方法

POST

cURL

curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getCompressedTokenAccountsByOwner",
  "params": {
    "owner": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9",
    "cursor": "3J98t1WpEZ73CNm",
    "limit": 1,
    "mint": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9"
  }
}
'

{
  "context": {
    "slot": 100
  },
  "value": {
    "items": [
      {
        "account": {
          "hash": "11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP",
          "lamports": 100,
          "leafIndex": 100,
          "owner": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9",
          "seq": 100,
          "slotCreated": 100,
          "tree": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9",
          "address": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9",
          "data": {
            "data": "SGVsbG8sIFdvcmxkIQ==",
            "dataHash": "11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP",
            "discriminator": 100
          }
        },
        "tokenData": {
          "amount": 100,
          "mint": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9",
          "owner": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9",
          "state": "initialized",
          "delegate": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9",
          "tlv": "SGVsbG8sIFdvcmxkIQ=="
        }
      }
    ],
    "cursor": "3J98t1WpEZ73CNm"
  }
}

Authorizations

api-key

string

query

required

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

Body

application/json

jsonrpc

enum<string>

default:2.0

required

JSON-RPC 协议的版本。

可用选项:

2.0

string

default:1

required

用于标识请求的 ID。

method

enum<string>

default:getCompressedTokenAccountsByOwner

required

要调用的方法名称。

可用选项:

getCompressedTokenAccountsByOwner

params

object

required

显示子属性

params.owner

string

default:11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9

required

拥有要检索的压缩代币账户的Solana钱包地址

Example:

"11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9"

params.cursor

string

default:3J98t1WpEZ73CNm

用于在Solana钱包中拥有大量持有的情况下检索后续压缩代币账户集的分页游标

Example:

"3J98t1WpEZ73CNm"

params.limit

integer<int64>

每个请求返回的压缩代币账户的最大数量（用于分页）

必填范围: x >= 0

params.mint

string

default:11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9

通过特定的Solana代币铸造地址过滤压缩代币账户

Example:

"11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9"

Response

成功从Solana区块链中检索到指定钱包所有者的压缩代币账户

context

object

required

显示子属性

context.slot

integer

default:100

required

此响应的当前 Solana 区块链插槽

Example:

100

value

object

required

显示子属性

value.items

object[]

required

由指定的Solana钱包地址拥有的压缩代币账户数组

显示子属性

value.items.account

object

required

Solana 上代币账户的压缩账户信息，包括树位置和验证数据

显示子属性

value.items.account.hash

string

required

用于验证的压缩账户数据的加密哈希

Example:

"11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP"

value.items.account.lamports

integer

default:100

required

与压缩账户关联的lamports余额

Example:

100

value.items.account.leafIndex

integer

default:100

required

存储压缩账户的merkle树中的索引位置

Example:

100

value.items.account.owner

string

default:11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9

required

拥有此压缩账户的Solana程序

Example:

"11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9"

value.items.account.seq

integer

default:100

required

用于跟踪压缩账户更新的序列号

Example:

100

value.items.account.slotCreated

integer

default:100

required

创建压缩账户时的Solana区块链插槽

Example:

100

value.items.account.tree

string

default:11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9

required

包含此压缩账户的默克尔树的地址

Example:

"11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9"

value.items.account.address

string

default:11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9

Solana上压缩账户的唯一地址

Example:

"11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9"

value.items.account.data

object

以压缩格式存储在Solana上的账户数据

显示子属性

value.items.account.data.data

string

default:SGVsbG8sIFdvcmxkIQ==

required

压缩Solana账户的Base64编码数据

Example:

"SGVsbG8sIFdvcmxkIQ=="

value.items.account.data.dataHash

string

required

用于完整性验证的压缩账户数据的哈希

Example:

"11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP"

value.items.account.data.discriminator

integer

default:100

required

Solana程序中账户类型的标识符

Example:

100

value.items.tokenData

object

required

特定的代币相关数据，包括余额、铸造、所有者和委托状态

显示子属性

value.items.tokenData.amount

integer

default:100

required

此压缩代币账户中持有的代币余额

Example:

100

value.items.tokenData.mint

string

default:11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9

required

此压缩代币账户所属的Solana SPL代币铸造地址

Example:

"11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9"

value.items.tokenData.owner

string

default:11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9

required

拥有此压缩代币账户的Solana钱包地址

Example:

"11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9"

value.items.tokenData.state

enum<string>

required

压缩代币账户的当前状态（已初始化或冻结）

可用选项:

initialized,

frozen

value.items.tokenData.delegate

string

default:11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9

授权在此压缩代币账户上执行操作的可选委托地址

Example:

"11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9"

value.items.tokenData.tlv

string

default:SGVsbG8sIFdvcmxkIQ==

用于扩展代币账户信息的可选类型-长度-值编码数据

Example:

"SGVsbG8sIFdvcmxkIQ=="

value.cursor

string

default:3J98t1WpEZ73CNm

分页游标，用于在后续请求中检索下一组压缩代币账户

Example:

"3J98t1WpEZ73CNm"

getCompressedTokenBalancesByOwner返回给定所有者的代币余额。

⌘I

cURL

curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getCompressedTokenAccountsByOwner",
  "params": {
    "owner": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9",
    "cursor": "3J98t1WpEZ73CNm",
    "limit": 1,
    "mint": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9"
  }
}
'

{
  "context": {
    "slot": 100
  },
  "value": {
    "items": [
      {
        "account": {
          "hash": "11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP",
          "lamports": 100,
          "leafIndex": 100,
          "owner": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9",
          "seq": 100,
          "slotCreated": 100,
          "tree": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9",
          "address": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9",
          "data": {
            "data": "SGVsbG8sIFdvcmxkIQ==",
            "dataHash": "11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP",
            "discriminator": 100
          }
        },
        "tokenData": {
          "amount": 100,
          "mint": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9",
          "owner": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9",
          "state": "initialized",
          "delegate": "11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9",
          "tlv": "SGVsbG8sIFdvcmxkIQ=="
        }
      }
    ],
    "cursor": "3J98t1WpEZ73CNm"
  }
}

API 参考

Solana RPC API

Solana API

数据流 API

事件监听 API

已弃用的 API

getCompressedTokenAccountsByOwner

Authorizations

Body

Response