Token Transactions

Live buys and sells from tracked smart money, KOL and whale wallets across Solana, BNB Chain and Base. One stream; pick the chain and wallet type with the blockchain and type fields.

Token Transactions — Live Smart Money / KOL / Whale Trades (WebSocket)

get

Subscribe to the live transactions stream and receive a position_update message for every matching trade. Select the data with the subscribe fields:

• blockchain (required) — solana, bnb, base. Change this to switch chain.

• type (required) — kol, smart, whale (whale is Solana-only)

• token (optional, default *) — a mint/contract to follow one token, or * for all

Subscribe message: { "op": "subscribe", "stream": "tx", "blockchain": "solana", "type": "kol", "token": "*" }. Each subscription corresponds to the channel tx.<blockchain>.<type>, returned in the channel field of every message.

Authorizations

bearerAuthapiKeyQuery

AuthorizationstringRequired

Authorization: Bearer YOUR_KEY

Body

application/json

Client → server. Start receiving the transactions stream for a chain + wallet type.

opstring · enumRequiredExample: subscribePossible values:

streamstring · enumOptionalExample: txPossible values:

blockchainstring · enumOptional

Change this to switch chain.

Example: solanaPossible values:

typestring · enumOptional

whale is Solana-only.

Example: kolPossible values:

tokenstringOptional

A mint/contract, or "*" for all tokens.

Example: *

channelstringOptional

Compact alternative to the fields above, e.g. tx.solana.kol.*

Example: tx.solana.kol.*

Responses

200

A position_update message pushed for each matching trade on the subscribed channel.

application/json

One trade (buy or sell) as a full position update.

successbooleanOptionalExample: true

channelstringOptional

Channel that produced this message — tx...

Example: tx.solana.kol

eventstring · enumOptionalExample: position_updatePossible values:

get/tx

HTTPcURLJavaScriptPython

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

{
  "op": "subscribe",
  "stream": "tx",
  "blockchain": "solana",
  "type": "kol",
  "token": "*"
}

Solana KOL, all tokensBNB smart money, one contractBase KOL, compact channel form

200

A position_update message pushed for each matching trade on the subscribed channel.

{
  "success": true,
  "channel": "tx.solana.kol",
  "event": "position_update",
  "data": {
    "wallet": "EjtQrPTbcMevStBkpnjsH23NfUCMhGHusTYsHuGVQZp2",
    "profile": {
      "name": "Zef",
      "image_url": "https://cabalspy.xyz/images/xWZz6OAg_400x400.jpg",
      "twitter": "https://x.com/zefwashere",
      "telegram": "https://t.me/SefaPVP",
      "blockchain": "solana",
      "currency": "SOL",
      "type": "kol",
      "active_hours": null
    },
    "transaction": {
      "signature": "R9mP8pfa1p3vjjwkpSKzeFVfH4qeuhmruvmtno73LA75g4kM5Dd99rRU5BHjBRdC6jU6HjoqsjWBbceDZr6ownV",
      "slot": 424747143,
      "action": "buy",
      "transaction_type": "buy",
      "created_at": 1780776862,
      "fee": 8005000,
      "fee_native": 0.008005,
      "fee_payer": "EjtQrPTbcMevStBkpnjsH23NfUCMhGHusTYsHuGVQZp2"
    },
    "token": {
      "mint": "3e2srvwMeVaoNgQGiE5tT4WNPGV2ZYD3ekRPuPTHpump",
      "symbol": "ちくわ",
      "name": "The Chill Dog",
      "decimals": 6,
      "supply": 998801410.647555,
      "logo": "https://metadata.j7tracker.io/images/osaMnSipjU"
    },
    "value": {
      "currency": "SOL",
      "amount": 1.081555,
      "amount_usd": 66.69,
      "price_usd": 61.66,
      "peak": 1.0816,
      "current": 1.0816
    },
    "position": {
      "token_amount": 24907484.868264,
      "held": 24907484.868264,
      "peak": 24907484.868264,
      "supply_pct": 2.4937,
      "bag_pct": 100,
      "prev_supply_pct": 0,
      "prev_bag_pct": 0,
      "delta_supply_pct": 2.4937,
      "delta_bag_pct": 100,
      "delta_held": 24907485,
      "used_fallback": false
    }
  },
  "meta": {
    "request_id": "req_d3296bb7de18",
    "version": "2.0.0",
    "timestamp": "2026-06-06T20:14:28.169Z"
  }
}