Skip to main content

Solana Balance Updates gRPC Stream

The balance gRPC Stream provides real-time balance update data for Solana accounts and token accounts.

Configuration​

To subscribe to balance updates, configure your stream as follows:

stream:
  type: "balance"

Available Data​

The balance updates stream provides comprehensive balance change information including:

  • Transaction details: Slot, signature, status, fees
  • Account information: Signers, token accounts, program IDs
  • Token context: Mint addresses, decimals, owners
  • Balance changes: Pre/post balances for accounts and token accounts
  • Currency details: Token metadata, symbols, mint addresses

Sample Data Structure​

Here's an example of the data structure you'll receive:

{
  "Block": {
    "Slot": 370025845
  },
  "Transaction": {
    "Index": 664,
    "Signature": "MgetT2Zi7PtLP867x2xioiCmimwe1H4rtTiDuqwE8eqjGuK4CTs4CBiKCKyfJHh8mXmQcK4hY9aMVsngg9v1mw5",
    "Header": {
        ...
      "Accounts": [
    ...
      ]
    }
  },
  "BalanceUpdate": {
    "BalanceUpdate": {
      "PreBalance": 412870875328,
      "PostBalance": 412392356516,
      "AccountIndex": 4
    },
    "Currency": {
      "Name": "Wrapped Solana",
        ...
    }
  }
}

Key Points​

  • Balance tracking: Monitor pre and post balances for any account changes
  • Token context: Each balance update includes full token metadata and currency information
  • Account indexing: Balance updates reference specific account indices within transactions
  • Comprehensive metadata: Currency details include mint addresses, symbols, decimals, and program IDs

Filtering Options​

The filter options are defined in the request.proto file. You can filter balance updates using the following filters:

message SubscribeBalanceUpdateRequest {
  AddressFilter address = 1;
  AddressFilter token = 2;
}

Available filters:

  • address: Filter by account address
  • token: Filter by token mint address (e.g., WSOL, USDC)

Schema Reference​

Python Installation​

For Python development, install the protobuf package:

pip install bitquery-corecast-proto

NPM Package​

npm install bitquery-corecast-proto

This package includes all necessary protobuf definitions without requiring manual downloads.