Endpoint
Connect towss://stream.cabalspy.xyz.
Pass your API key either as a query parameter or as a Bearer header.
Authentication
Provide your API key one of two ways when opening the connection. As a query parameter,wss://stream.cabalspy.xyz?apiKey=YOUR_KEY. Or as a header, Authorization: Bearer YOUR_KEY. A connection without a valid key is closed immediately with code 1008.
On connect you receive a welcome message listing the available streams and example subscriptions. After that you drive everything with subscribe messages.
Chains and wallet types
Each chain tracks a different set of wallet categories, and reports values in its own native currency.
Asking for a wallet type a chain does not track is rejected with an error naming the types it does track. On EVM chains, contract addresses are matched case-insensitively.
Subscribe
To start receiving trades, send a subscribe message after the connection opens. You choose a chain, a wallet type, and optionally one token to narrow to.Subscribe to all KOL trades on Solana
Subscribe to one token only
Wallet category. See the table above. Solana has kol, smart, whale. BNB, Base and Robinhood have kol, smart. ETH has kol.
Which token to watch. Either ”*” for all tokens, or a single token mint or contract address to narrow to one token. Defaults to all tokens.
Unsubscribe and other operations
To stop a subscription, send the same fields with op unsubscribe.Unsubscribe
List your subscriptions

