Solana Balance Updates gRPC Stream

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

---

Overview

Subscribe to live balance changes for accounts and token accounts. Each event includes pre/post balances, currency details, and account context. Data is in protobuf format — use bitquery-corecast-proto to parse.

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 (in native and USD)
• 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;
  AddressFilter token;
}

Available filters:

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

Schema Reference

• Protobuf Schema: balance_block_message.proto
• Sample Data: solana_balance.json

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.

---

Related

• CoreCast Introduction — Topics and concepts
• Transfers gRPC — Token transfers
• Solana Balance Updates (GraphQL) — WebSocket subscriptions
• Authorization — Token setup