Real-time WebSocket streams for trades, holder positions, wallet balances, cluster signals and KOL bundle detection across Solana, BNB Chain, Base, Ethereum and Robinhood Chain.
CabalSpy provides real-time WebSocket streams for tracked KOL, Smart Money and Whale activity, delivered the moment it happens. Where the REST API returns a snapshot when you ask, the streams push updates to you continuously, live trades, changing positions, moving balances, and freshly detected signals and bundles.Everything runs over a single connection. You open one WebSocket, authenticate once, then subscribe to as many channels as you need. Each channel is independent, and you can subscribe and unsubscribe at any time without reconnecting.
Connecting
Connect to the endpoint and pass your API key, either as a query parameter or as a Bearer header. A connection without a valid key is closed immediately.
On connect you receive a welcome message that lists the available streams and shows example subscriptions, so you can confirm the connection works before subscribing.
No key yet? Connect to wss://demo-api.cabalspy.xyz/ws (or use apiKey=demo) to try every stream on the public demo. Events arrive 15 minutes late, with 3 subscriptions per connection, one connection per IP and a 30-minute session.
How subscriptions work
You drive everything with small JSON messages. Every message has an op field that says what to do, and a stream field that says which stream it applies to.
string
required
The operation. One of subscribe, unsubscribe, subscriptions (list your active channels) or ping (check the connection, you get a pong back).
string
required
Which stream the message applies to. One of tx, count, holder, balance, signal, bundle, call.
A subscribe message adds a channel, an unsubscribe message removes it. Each stream page shows the exact fields for that stream, but the shape is always the same.
Most streams accept a token or wallet filter. Use a specific mint, contract or wallet address to follow one thing, or the value ”*” to follow everything of that kind. Following a single token or wallet usually also returns a starting snapshot.
Available streams
Transactions
Every buy and sell from tracked wallets, with the running position after each trade.
Count
The live KOL wallet count per token, a lightweight activity indicator.
Holder
All holders of a token with live position, bag percentage, unrealized PnL and remaining value.
Balance
The native SOL balance of tracked wallets, updated on every trade.
Signal
Entry and exit signals when clusters of KOL or Smart Money wallets buy or sell together.
Bundle
Coordinated KOL bundles on a token, the side wallets buying alongside a KOL, with proof.
Call
Our curated calls, the same ones posted in Discord, the moment they go out.
Stream categories
The seven streams fall into three groups by what they describe.Holdings and position, what wallets hold right now. The holder stream covers all holders of a token, the balance stream covers a wallet native SOL balance.Signals and detection, derived alerts rather than raw activity. The signal stream fires on buy and sell clusters, the bundle stream surfaces coordinated KOL bundles as they form, the call stream delivers our curated calls.Trades and activity, the raw event flow. The transactions stream carries individual trades, the count stream carries the live wallet count per token.
Modes and cost
Each delivered message counts against your plan, the same way a REST request does. A wildcard subscription on a busy chain can produce a lot of messages, so filter to a specific token or wallet when you can.The holder and bundle streams add a mode control. In full mode you also get live position updates every time the market cap moves, in events mode you get only real trades and detections. With full mode, an optional mc_interval caps those price updates to at most once every N seconds. Each of those pages explains the trade-off in detail.
Staying connected
The server sends periodic pings and expects your client to answer with pong, which browsers and standard WebSocket libraries do automatically. A connection that stops answering is dropped. You can also send op ping yourself at any time to confirm the connection is alive.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"CabalSpy","description":"KOL and Smart Money wallet API on Solana, BNB Chain, Base, Ethereum and Robinhood Chain: 3,000+ labeled KOL, Smart Money and Whale wallets via REST, WebSocket, SDKs and MCP.","colors":{"primary":"#01b400","light":"#161717","dark":"#d2d1d1"},"logo":{"light":"https://mintcdn.com/cabalspy-251c1bde/QiONC9M0RxuWdoHx/images/CabalSpy_logo_text_right_black.png?fit=max\u0026auto=format\u0026n=QiONC9M0RxuWdoHx\u0026q=85\u0026s=cac87add4e7b93608722200ea0bd2fd4","dark":"https://mintcdn.com/cabalspy-251c1bde/QiONC9M0RxuWdoHx/images/CabalSpy_logo_text_right_white.png?fit=max\u0026auto=format\u0026n=QiONC9M0RxuWdoHx\u0026q=85\u0026s=a14e2d279ad72b6025fe3f081f0d2aab","href":"https://www.cabalspy.xyz"},"favicon":{"light":"https://mintcdn.com/cabalspy-251c1bde/FyPz_ptScKHnJVNX/images/favicon.ico?fit=max\u0026auto=format\u0026n=FyPz_ptScKHnJVNX\u0026q=85\u0026s=8b5b7b95ced563536d8f7f1b86165035","dark":"https://mintcdn.com/cabalspy-251c1bde/FyPz_ptScKHnJVNX/images/favicon.ico?fit=max\u0026auto=format\u0026n=FyPz_ptScKHnJVNX\u0026q=85\u0026s=8b5b7b95ced563536d8f7f1b86165035"},"api":{"playground":{"display":"interactive","proxy":false},"mdx":{"server":["https://demo-api.cabalspy.xyz","https://api.cabalspy.xyz"]}},"background":{"decoration":"grid"},"navbar":{"links":[{"href":"https://www.cabalspy.xyz","label":"Website"},{"href":"https://app.cabalspy.xyz","label":"Terminal"},{"href":"https://apidashboard.cabalspy.xyz","label":"Dashboard"}],"primary":{"type":"button","label":"Get Free API Key","href":"https://apidashboard.cabalspy.xyz/register"}},"footer":{"socials":{"x":"https://x.com/CabalSpySol","telegram":"https://t.me/CabalSpyPortal","discord":"https://discord.gg/YgTPeZ2UYc","github":"https://github.com/CabalSpy"}},"fonts":{"family":"Geist"},"interaction":{"drilldown":true},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cabalspy-251c1bde","hasAudioNarration":false,"actualSubdomain":"cabalspy-251c1bde","customDomains":["docs.cabalspy.xyz"],"gitSource":{"type":"github","owner":"tokiogaijin","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afdf232d42d11d8af0d4a0f","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"CabalSpy ID","count":77},{"language":"default","tag":"Data","count":22},{"language":"default","tag":"Overview","count":20},{"language":"default","tag":"White-Label","count":16},{"language":"default","tag":"Theses","count":16},{"language":"default","tag":"Use cases","count":10},{"language":"default","tag":"Streams","count":9},{"language":"default","tag":"CookBooks","count":8},{"language":"default","tag":"Wallet data","count":8},{"language":"default","tag":"Introduction","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"get-started","slug":"/get-started","pageMetadata":{"title":"Get Started","sidebarTitle":"Get started","description":"Real-time WebSocket streams for trades, holder positions, wallet balances, cluster signals and KOL bundle detection across Solana, BNB Chain, Base, Ethereum and Robinhood Chain.","keywords":["KOL websocket api","realtime crypto streams","kol trade stream","live holder positions","wallet balance stream","signal stream","cabalspy websocket"],"og:title":"WebSocket Streams - Real-Time KOL and Smart Money Data - CabalSpy","og:description":"Real-time WebSocket streams for trades, holder positions, wallet balances, cluster signals and KOL bundle detection. One connection, many channels.","href":"/get-started"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Real-time WebSocket streams for trades, holder positions, wallet balances, cluster signals and KOL bundle detection across Solana, BNB Chain, Base, Ethereum and Robinhood Chain.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Heading,ParamField,Tip}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`CabalSpy provides real-time WebSocket streams for tracked KOL, Smart Money and Whale activity, delivered the moment it happens. Where the REST API returns a snapshot when you ask, the streams push updates to you continuously, live trades, changing positions, moving balances, and freshly detected signals and bundles.`}),`\n`,_jsx(_components.p,{children:`Everything runs over a single connection. You open one WebSocket, authenticate once, then subscribe to as many channels as you need. Each channel is independent, and you can subscribe and unsubscribe at any time without reconnecting.`}),`\n`,_jsx(Heading,{level:`2`,id:`connecting`,children:`Connecting`}),`\n`,_jsx(_components.p,{children:`Connect to the endpoint and pass your API key, either as a query parameter or as a Bearer header. A connection without a valid key is closed immediately.`}),`\n`,_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`12`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` ws`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` WebSocket`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"wss://stream.cabalspy.xyz?apiKey=YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ws`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`onopen`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` () `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`=>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ws`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`send`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` op:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"subscribe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`stream:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"tx\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`blockchain:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"solana\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`type:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"kol\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`token:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"*\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }));`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`};`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ws`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`onmessage`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`e`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`=>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` msg`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`parse`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`e`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`msg`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`event`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`msg`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`};`})}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:`Python`,numberOfLines:`16`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`16`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` json, websocket`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`def`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` on_open`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ws`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`):`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ws.send(json.dumps({`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"op\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"subscribe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"stream\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"tx\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"blockchain\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"solana\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"kol\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"token\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"*\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }))`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`def`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` on_message`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ws`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`message`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`):`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` msg `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` json.loads(message)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(msg.get(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"event\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`))`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`ws `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` websocket.WebSocketApp(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"wss://stream.cabalspy.xyz?apiKey=YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` on_open`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`on_open, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`on_message`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`on_message,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`ws.run_forever()`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`On connect you receive a welcome message that lists the available streams and shows example subscriptions, so you can confirm the connection works before subscribing.`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`No key yet? Connect to `,_jsx(_components.code,{children:`wss://demo-api.cabalspy.xyz/ws`}),` (or use `,_jsx(_components.code,{children:`apiKey=demo`}),`) to try every stream on the `,_jsx(_components.a,{href:`/demo`,children:`public demo`}),`. Events arrive 15 minutes late, with 3 subscriptions per connection, one connection per IP and a 30-minute session.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`how-subscriptions-work`,children:`How subscriptions work`}),`\n`,_jsx(_components.p,{children:`You drive everything with small JSON messages. Every message has an op field that says what to do, and a stream field that says which stream it applies to.`}),`\n`,_jsx(ParamField,{body:`op`,type:`string`,required:true,id:`param-op`,children:_jsx(_components.p,{children:`The operation. One of subscribe, unsubscribe, subscriptions (list your active channels) or ping (check the connection, you get a pong back).`})}),`\n`,_jsx(ParamField,{body:`stream`,type:`string`,required:true,id:`param-stream`,children:_jsx(_components.p,{children:`Which stream the message applies to. One of tx, count, holder, balance, signal, bundle, call.`})}),`\n`,_jsx(_components.p,{children:`A subscribe message adds a channel, an unsubscribe message removes it. Each stream page shows the exact fields for that stream, but the shape is always the same.`}),`\n`,_jsx(CodeBlock,{filename:`Subscribe`,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"op\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"subscribe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"stream\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"holder\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"token\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"3Pkrq...pump\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:`Unsubscribe`,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"op\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"unsubscribe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"stream\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"holder\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"token\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"3Pkrq...pump\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Most streams accept a token or wallet filter. Use a specific mint, contract or wallet address to follow one thing, or the value ”*” to follow everything of that kind. Following a single token or wallet usually also returns a starting snapshot.`}),`\n`,_jsx(Heading,{level:`2`,id:`available-streams`,children:`Available streams`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Transactions`,href:`https://docs.cabalspy.xyz/transactions-1`,children:_jsx(_components.p,{children:`Every buy and sell from tracked wallets, with the running position after each trade.`})}),_jsx(Card,{title:`Count`,href:`https://docs.cabalspy.xyz/Count`,children:_jsx(_components.p,{children:`The live KOL wallet count per token, a lightweight activity indicator.`})}),_jsx(Card,{title:`Holder`,href:`https://docs.cabalspy.xyz/holder`,children:_jsx(_components.p,{children:`All holders of a token with live position, bag percentage, unrealized PnL and remaining value.`})}),_jsx(Card,{title:`Balance`,href:`https://docs.cabalspy.xyz/balance-1`,children:_jsx(_components.p,{children:`The native SOL balance of tracked wallets, updated on every trade.`})}),_jsx(Card,{title:`Signal`,href:`https://docs.cabalspy.xyz/signal`,children:_jsx(_components.p,{children:`Entry and exit signals when clusters of KOL or Smart Money wallets buy or sell together.`})}),_jsx(Card,{title:`Bundle`,href:`https://docs.cabalspy.xyz/bundle-1`,children:_jsx(_components.p,{children:`Coordinated KOL bundles on a token, the side wallets buying alongside a KOL, with proof.`})}),_jsx(Card,{title:`Call`,href:`https://docs.cabalspy.xyz/call`,children:_jsx(_components.p,{children:`Our curated calls, the same ones posted in Discord, the moment they go out.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`stream-categories`,children:`Stream categories`}),`\n`,_jsx(_components.p,{children:`The seven streams fall into three groups by what they describe.`}),`\n`,_jsx(_components.p,{children:`Holdings and position, what wallets hold right now. The holder stream covers all holders of a token, the balance stream covers a wallet native SOL balance.`}),`\n`,_jsx(_components.p,{children:`Signals and detection, derived alerts rather than raw activity. The signal stream fires on buy and sell clusters, the bundle stream surfaces coordinated KOL bundles as they form, the call stream delivers our curated calls.`}),`\n`,_jsx(_components.p,{children:`Trades and activity, the raw event flow. The transactions stream carries individual trades, the count stream carries the live wallet count per token.`}),`\n`,_jsx(Heading,{level:`2`,id:`modes-and-cost`,children:`Modes and cost`}),`\n`,_jsx(_components.p,{children:`Each delivered message counts against your plan, the same way a REST request does. A wildcard subscription on a busy chain can produce a lot of messages, so filter to a specific token or wallet when you can.`}),`\n`,_jsx(_components.p,{children:`The holder and bundle streams add a mode control. In full mode you also get live position updates every time the market cap moves, in events mode you get only real trades and detections. With full mode, an optional mc_interval caps those price updates to at most once every N seconds. Each of those pages explains the trade-off in detail.`}),`\n`,_jsx(Heading,{level:`2`,id:`staying-connected`,children:`Staying connected`}),`\n`,_jsx(_components.p,{children:`The server sends periodic pings and expects your client to answer with pong, which browsers and standard WebSocket libraries do automatically. A connection that stops answering is dropped. You can also send op ping yourself at any time to confirm the connection is alive.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Started","sidebarTitle":"Get started","description":"Real-time WebSocket streams for trades, holder positions, wallet balances, cluster signals and KOL bundle detection across Solana, BNB Chain, Base, Ethereum and Robinhood Chain.","keywords":["KOL websocket api","realtime crypto streams","kol trade stream","live holder positions","wallet balance stream","signal stream","cabalspy websocket"],"og:title":"WebSocket Streams - Real-Time KOL and Smart Money Data - CabalSpy","og:description":"Real-time WebSocket streams for trades, holder positions, wallet balances, cluster signals and KOL bundle detection. One connection, many channels.","href":"/get-started"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Connecting","slug":"connecting","depth":2,"children":[]},{"title":"How subscriptions work","slug":"how-subscriptions-work","depth":2,"children":[]},{"title":"Available streams","slug":"available-streams","depth":2,"children":[]},{"title":"Stream categories","slug":"stream-categories","depth":2,"children":[]},{"title":"Modes and cost","slug":"modes-and-cost","depth":2,"children":[]},{"title":"Staying connected","slug":"staying-connected","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"cabalspy-251c1bde","siteName":"CabalSpy","title":"WebSocket Streams - Real-Time KOL and Smart Money Data - CabalSpy","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T10:36:36.104Z","originalFileLocation":"get-started.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Real-time WebSocket streams for trades, holder positions, wallet balances, cluster signals and KOL bundle detection across Solana, BNB Chain, Base, Ethereum and Robinhood Chain.\">\u003cmeta data-mint-head name=\"application-name\" content=\"CabalSpy\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cabalspy-251c1bde/ik4cWInJ2VumSXY5/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cabalspy-251c1bde/ik4cWInJ2VumSXY5/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cabalspy-251c1bde/ik4cWInJ2VumSXY5/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cabalspy-251c1bde/ik4cWInJ2VumSXY5/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cabalspy-251c1bde/ik4cWInJ2VumSXY5/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cabalspy-251c1bde/ik4cWInJ2VumSXY5/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cabalspy-251c1bde/ik4cWInJ2VumSXY5/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cabalspy-251c1bde/ik4cWInJ2VumSXY5/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cabalspy-251c1bde/ik4cWInJ2VumSXY5/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"WebSocket Streams - Real-Time KOL and Smart Money Data - CabalSpy\">\u003cmeta data-mint-head property=\"og:description\" content=\"Real-time WebSocket streams for trades, holder positions, wallet balances, cluster signals and KOL bundle detection. One connection, many channels.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CabalSpy\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cabalspy.xyz/get-started\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cabalspy-251c1bde.mintlify.site/_mintlify/api/og/v2?division=Introduction\u0026amp;title=Get+Started\u0026amp;description=Real-time+WebSocket+streams+for+trades%2C+holder+positions%2C+wallet+balances%2C+cluster+signals+and+KOL+bundle+detection+across+Solana%2C+BNB+Chain%2C+Base%2C+Ethereum+and\u0026amp;theme=0c2047c4f5074dbb3bb3bf85\u0026amp;signature=eceff28043fcad8a9e4fe00a3e3c8be4d443a236c5d4c0af9b69d406e40cc6b7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"WebSocket Streams - Real-Time KOL and Smart Money Data - CabalSpy\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Real-time WebSocket streams for trades, holder positions, wallet balances, cluster signals and KOL bundle detection. One connection, many channels.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cabalspy-251c1bde.mintlify.site/_mintlify/api/og/v2?division=Introduction\u0026amp;title=Get+Started\u0026amp;description=Real-time+WebSocket+streams+for+trades%2C+holder+positions%2C+wallet+balances%2C+cluster+signals+and+KOL+bundle+detection+across+Solana%2C+BNB+Chain%2C+Base%2C+Ethereum+and\u0026amp;theme=0c2047c4f5074dbb3bb3bf85\u0026amp;signature=eceff28043fcad8a9e4fe00a3e3c8be4d443a236c5d4c0af9b69d406e40cc6b7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cabalspy-251c1bde/ik4cWInJ2VumSXY5/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CabalSpy\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#01b400\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cabalspy.xyz/get-started\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/get-started.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cabalspy.xyz/#organization\",\"name\":\"CabalSpy\",\"url\":\"https://docs.cabalspy.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cabalspy-251c1bde/QiONC9M0RxuWdoHx/images/CabalSpy_logo_text_right_black.png?fit=max\u0026auto=format\u0026n=QiONC9M0RxuWdoHx\u0026q=85\u0026s=cac87add4e7b93608722200ea0bd2fd4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cabalspy.xyz#website\",\"name\":\"CabalSpy\",\"url\":\"https://docs.cabalspy.xyz\",\"publisher\":{\"@id\":\"https://docs.cabalspy.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cabalspy.xyz/get-started#webpage\",\"url\":\"https://docs.cabalspy.xyz/get-started\",\"name\":\"Get Started\",\"description\":\"Real-time WebSocket streams for trades, holder positions, wallet balances, cluster signals and KOL bundle detection across Solana, BNB Chain, Base, Ethereum and Robinhood Chain.\",\"dateModified\":\"2026-10-26T10:36:36.104Z\",\"isPartOf\":{\"@id\":\"https://docs.cabalspy.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cabalspy.xyz/get-started#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cabalspy.xyz/get-started#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"CabalSpy\",\"item\":\"https://docs.cabalspy.xyz\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Started\",\"item\":\"https://docs.cabalspy.xyz/get-started\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cabalspy.xyz/get-started#article\",\"headline\":\"Get Started\",\"name\":\"Get Started\",\"description\":\"Real-time WebSocket streams for trades, holder positions, wallet balances, cluster signals and KOL bundle detection across Solana, BNB Chain, Base, Ethereum and Robinhood Chain.\",\"url\":\"https://docs.cabalspy.xyz/get-started\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cabalspy.xyz/get-started#webpage\"},\"dateModified\":\"2026-10-26T10:36:36.104Z\",\"keywords\":\"KOL websocket api, realtime crypto streams, kol trade stream, live holder positions, wallet balance stream, signal stream, cabalspy websocket\",\"publisher\":{\"@id\":\"https://docs.cabalspy.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cabalspy.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CabalSpy\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"CabalSpy\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/get-started.md","siteName":"CabalSpy","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/get"}]},{"tab":"Data","pages":[{"title":"Data","href":"/Data-APIs"}]},{"tab":"Streams","groups":[{"group":"Introduction","icon":"info-circle","pages":[{"title":"Get Started","sidebarTitle":"Get started","href":"/get-started"}]},{"group":"Trades \u0026 Activity","icon":"arrows-repeat","pages":[{"title":"Transactions Stream","sidebarTitle":"Transactions","description":"Live WebSocket stream of KOL, Smart Money and Whale transactions with running position, bag percentage and supply percentage per wallet.","tag":"WSS","href":"/transactions-1"},{"title":"Count Stream","sidebarTitle":"KOL Count","tag":"WSS","href":"/Count"}]},{"group":"Signals \u0026 Detection","icon":"alarm-clock","pages":[{"title":"Signal Stream","sidebarTitle":"Signal","tag":"WSS","href":"/signal"},{"title":"Call Stream","sidebarTitle":"Call","tag":"WSS","href":"/call"},{"title":"Bundle Stream","sidebarTitle":"Bundle","tag":"WSS","href":"/bundle-1"}]},{"group":"Holdings \u0026 Position","icon":"money-bill","pages":[{"title":"Holder Stream","sidebarTitle":"Holder","tag":"WSS","href":"/holder"},{"title":"Balance Stream","sidebarTitle":"Balance","tag":"WSS","href":"/balance-1"}]}]},{"tab":"Widget","pages":[{"title":"Widget","href":"/get-started-1"}]},{"tab":"CabalSpy ID","pages":[{"title":"CabalSpy ID","href":"/cabalspy-id/overview"}]},{"tab":"CookBooks","pages":[{"title":"CookBooks","href":"/realtime-holder-table"}]}]},"basePath":"","title":"WebSocket Streams - Real-Time KOL and Smart Money Data - CabalSpy","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}