Balance

Live native SOL balances of tracked KOL, smart-money and whale wallets on Solana. Refreshed on every transaction; snapshot on subscribe.

Balance — Live Native SOL Balances of Tracked Wallets (WebSocket)

get

Subscribe and receive an init snapshot of current balances, then live balance_update messages each time a tracked wallet's SOL balance changes.

• blockchain (required) — must be solana.

• wallet (optional, default *) — a wallet address to follow one wallet, or * for all tracked wallets.

• wallet_types (optional) — any subset of kol, smart, whale; defaults to all three.

Authorizations

bearerAuthapiKeyQuery

AuthorizationstringRequired

Authorization: Bearer YOUR_KEY

Body

application/json

Client -> server. Subscribe to tracked wallets' native SOL balances; filters persist until unsubscribe.

opstring · enumRequiredExample: subscribePossible values:

streamstring · enumRequiredExample: balancePossible values:

blockchainstring · enumOptional

Must be solana.

Possible values:

walletstringOptional

A wallet address, or "*" for all tracked wallets.

Example: *

channelstring · nullableOptional

Alternative to blockchain+wallet: balance.solana. or balance.solana for all.

Responses

200

init and balance_update messages. (The connection also delivers a connected welcome, a subscribed ack per subscribe, and error messages — see schemas.)

application/json

One balance message — init snapshot or balance_update.

successbooleanOptionalExample: true

channelstringOptionalExample: balance.solana

eventstring · enumOptionalPossible values:

get/balance

HTTPcURLJavaScriptPython

GET /balance HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 111

{
  "op": "subscribe",
  "stream": "balance",
  "blockchain": "solana",
  "wallet": "*",
  "wallet_types": [
    "kol",
    "smart",
    "whale"
  ]
}

All tracked wallets, all typesAll KOL wallets onlyFollow one specific walletChannel shorthand

200

init and balance_update messages. (The connection also delivers a connected welcome, a subscribed ack per subscribe, and error messages — see schemas.)

{
  "success": true,
  "channel": "balance.solana",
  "event": "init",
  "data": {
    "blockchain": "solana",
    "wallet_types": [
      "kol",
      "smart",
      "whale"
    ],
    "balances": [
      {
        "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
        "profile": {
          "name": "Loopierr",
          "image_url": "https://cabalspy.xyz/images/7xKX.png",
          "twitter": "https://x.com/loopierr",
          "telegram": "",
          "blockchain": "solana",
          "currency": "SOL",
          "type": "kol"
        },
        "balance": {
          "currency": "SOL",
          "amount": 4.3175,
          "amount_raw": "4317500000",
          "amount_usd": 348.6,
          "decimals": 9,
          "symbol": "SOL",
          "name": "Solana",
          "updated_at": 1782248245000
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_ab12cd34",
    "version": "2.0.0",
    "timestamp": "2026-07-02T15:24:01.000Z"
  }
}