{
  "slots": {
      "slots": {}
  },
  "accounts": {
      "user-defined-label": {
          "account": [
              "DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu",
              "5U3bH5b6XtG99aVCE9ycvDgBKQx3fVT8WwTNbMToFuEr"
          ],
          "owner": [
              "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
          ],
          "filter": {
              "memcmp": {
                  "offset": 0,
                  "bytes": "0102030405"
              },
              "datasize": 165,
              "token_account_state": true,
              "lamports": {
                  "gt": 100000000
              }
          },
          "nonempty_txn_signature": true
      }
  },
  "transactions": {},
  "blocks": {},
  "blocks_meta": {},
  "accounts_data_slice": [],
  "commitment": 1
}
{
  "filters": ["accounts"],
  "account": {
    "account": {
      "pubkey": "BASE58_ENCODED_PUBKEY",
      "lamports": 12345678,
      "owner": "BASE58_ENCODED_OWNER",
      "executable": false,
      "rent_epoch": 361,
      "data": "BASE64_ENCODED_DATA",
      "write_version": 123,
      "txn_signature": "BASE58_ENCODED_SIGNATURE"
    },
    "slot": 189554321,
    "is_startup": false
  },
  "created_at": "2023-04-28T12:34:56.789Z"
}

授权

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

消息

gRPC API 支持多种订阅类型,可以在单个请求中组合:
accounts
object
订阅账户更新。当指定账户被修改时返回数据。
slots
object
订阅槽位更新。
transactions
object
订阅交易更新。
transactions_status
object
订阅交易状态更新。
blocks
object
订阅区块更新。
blocks_meta
object
订阅区块元数据更新(比完整区块更新更轻量)。
entry
object
订阅条目更新。
commitment
enum
订阅的承诺级别:
accounts_data_slice
array
指定要接收的部分账户数据:
ping
object
启用乒乓消息以监控连接健康状况。
from_slot
integer
开始接收更新的槽位。此值之前的槽位更新将被排除。
{
  "slots": {
      "slots": {}
  },
  "accounts": {
      "user-defined-label": {
          "account": [
              "DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu",
              "5U3bH5b6XtG99aVCE9ycvDgBKQx3fVT8WwTNbMToFuEr"
          ],
          "owner": [
              "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
          ],
          "filter": {
              "memcmp": {
                  "offset": 0,
                  "bytes": "0102030405"
              },
              "datasize": 165,
              "token_account_state": true,
              "lamports": {
                  "gt": 100000000
              }
          },
          "nonempty_txn_signature": true
      }
  },
  "transactions": {},
  "blocks": {},
  "blocks_meta": {},
  "accounts_data_slice": [],
  "commitment": 1
}

承诺级别

所有订阅支持以下承诺级别:
  • PROCESSED: 由当前节点处理 (0)
  • CONFIRMED: 由集群的超级多数确认 (1)
  • FINALIZED: 由集群最终确定 (2)

响应结构

订阅响应包括:
  • filters: 匹配此更新的过滤器名称
  • 以下更新类型之一:
    • account: 账户数据、所有者、lamports、可执行状态等。
    • slot: 插槽信息和状态更新
    • transaction: 完整的交易详情、签名和元数据
    • transaction_status: 交易执行状态(成功/错误)
    • block: 包含交易、账户、奖励等的完整区块数据
    • block_meta: 不含完整交易详情的轻量级区块元数据
    • entry: 区块内的条目详情
    • ping/pong: 连接健康检查消息
  • created_at: 更新创建的时间戳
{
  "filters": ["accounts"],
  "account": {
    "account": {
      "pubkey": "BASE58_ENCODED_PUBKEY",
      "lamports": 12345678,
      "owner": "BASE58_ENCODED_OWNER",
      "executable": false,
      "rent_epoch": 361,
      "data": "BASE64_ENCODED_DATA",
      "write_version": 123,
      "txn_signature": "BASE58_ENCODED_SIGNATURE"
    },
    "slot": 189554321,
    "is_startup": false
  },
  "created_at": "2023-04-28T12:34:56.789Z"
}