{
  "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"
}

​
Authorizations

​
x-token
string
required

Your Helius API key. You can get one for free in the dashboard.

​
Message

The gRPC API supports multiple subscription types that can be combined in a single request:

​
accounts
object

Subscribe to account updates. Returns data when specified accounts are modified.

​
slots
object

Subscribe to slot updates.

​
transactions
object

Subscribe to transaction updates.

​
transactions_status
object

Subscribe to transaction status updates.

​
blocks
object

Subscribe to block updates.

​
blocks_meta
object

Subscribe to block metadata updates (lighter than full block updates).

​
entry
object

Subscribe to entry updates.

​
commitment
enum

The commitment level for the subscription:

​
accounts_data_slice
array

Specifies partial account data to receive:

​
ping
object

Enable ping-pong messages for connection health monitoring.

​
from_slot
integer

Starting slot to receive updates from. Updates for slots before this value will be excluded.

{
  "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
}

​
Commitment Levels

All subscriptions support the following commitment levels:

  • PROCESSED: Processed by the current node (0)
  • CONFIRMED: Confirmed by supermajority of the cluster (1)
  • FINALIZED: Finalized by the cluster (2)

​
Response Structure

Subscription responses include:

  • filters: The filter names that matched this update
  • One of the following update types:
    • account: Account data, owner, lamports, executable status, etc.
    • slot: Slot information and status updates
    • transaction: Full transaction details, signature, and metadata
    • transaction_status: Transaction execution status (success/error)
    • block: Complete block data with transactions, accounts, rewards, etc.
    • block_meta: Lightweight block metadata without full transaction details
    • entry: Entry details within a block
    • ping/pong: Connection health check messages
  • created_at: Timestamp when the update was created
{
  "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"
}