The SocialFi layer for your trading platform.
CabalSpy ID is a SocialFi API and SDK that gives a trading platform a social layer for its own customers. Add Sign in with CabalSpy ID and every user who signs in arrives with their social identity, X or Telegram, and their verified wallets. From that moment every trade those users make is tracked live across Solana, BNB Chain, Base, Ethereum and Robinhood Chain.
Your platform gets each user’s identity, KOL badge and full trading record, PnL, win rate, trades, holdings and a daily PnL calendar, through one API, a live trade stream and webhooks: one SocialFi integration instead of building identity, wallet verification and trade tracking yourself. Build leaderboards of your own users, show real positions next to every opinion, put your users’ trades on the chart, and turn trading into something people follow, copy and compete in.
Login
A drop-in login button and a standard OpenID Connect provider. Every user arrives with X and verified wallets.
Data API
Profiles, trading stats, PnL charts, holdings, calendars and leaderboards of your users.
Live
Every trade of your users pushed live, plus webhooks when a user verifies a wallet or becomes a KOL.
Choose your path
CabalSpy ID works in two ways. Pick one, or use both in the same instance.Login with CabalSpy ID
Your users sign in with CabalSpy ID and arrive with X, Telegram and verified wallets. For platforms without a login yet, or that want verified identities. Start with the Login quickstart.
White-Label
You keep your own login (Privy, Dynamic, your own) and brand. Your backend adds your users and their existing wallets by your own user id. Your users never see CabalSpy ID. Start with the White-Label quickstart.
Use cases
What platforms build with CabalSpy ID, and the endpoints that power each feature.
All trading numbers are computed exactly like the CabalSpy API, so a wallet shows the same figures everywhere.
Trust
The social layer is only worth something if it is real. CabalSpy ID makes sure that the person, the wallets and the badges are genuine.1
Identity from X or Telegram
Users sign in with X, with Telegram through the CabalSpy ID bot, or with Google as an alternative. With X, name, handle, avatar and follower counts come from X. Users without X can connect it later, and anyone can verify their Telegram account, which then shows on their public profile.
2
Verified wallets
A user proves a wallet by sending a tiny payment from it. No wallet connect and no signatures, the payment itself is the proof. Every verified wallet is tracked live from then on.
3
Reviewed KOL badge
Accounts with at least 5,000 followers, an X account older than 90 days and at least $25,000 on-chain volume in the last 7 days can apply. Every badge is reviewed and approved manually.
x set to null and a handle like tg.<name>, see Users without X.
Users stay in control. Every user has a public profile at https://id.cabalspy.xyz/u/<handle>, sees every app they signed in to and can remove access at any time. Your app then receives a consent.revoked webhook.
Getting started
Everything for developers lives in the API Dashboard, on the CabalSpy ID tab. No account yet? Create one and get your API key first. The Login quickstart and the White-Label quickstart walk through it.1
Create an instance
An instance is your app on CabalSpy ID. Its Instance ID is your
client_id and starts with csid_. Server-side apps also create a client secret, which starts with csid_sk_. Redirect URIs are only needed for Login with CabalSpy ID; leave them empty for White-Label.2
Add the login button, or your users
Login: switch on the scopes you ask for (Settings, Scopes), add yourself and your testers by X handle, then design the button or run the OpenID Connect flow yourself. White-Label: add your users with your API key.
3
Read your users' data
Call the Data API with the same API key you use for the CabalSpy API. On the API keys page every key has Works with: CabalSpy API / CabalSpy ID API; both are on by default.
Instance modes
Development and sandbox instances allow 1 request per second and 25 users; a live instance uses your plan. For White-Label, use development: your platform users have real wallets and real trades.
You verify a domain with a DNS TXT record at
_csid-verification.<domain> or with a file at https://<domain>/.well-known/csid-verification.txt. The dashboard shows the exact value.
White-Label
Platforms that keep their own login use CabalSpy ID as white-label technology. Your users never see a CabalSpy ID sign-in: you add them by your own user id (external_id) with the wallets they already have, one by one, in bulk or automatically from Privy, Dynamic or your backend through an inbound URL. Every trade of their wallets is tracked, and you read profiles, leaderboards and run trading competitions through the Data API. White-Label is available on every plan; the plan sets how many users you can have. See White-Label.
What platforms receive
At sign-in, what you receive depends on the scopes the user approves.
Through the Data API, the stream and webhooks you get the live trading record of every user who signed in.
Users who granted
trade_feed can follow traders in their Trade Feed and copy them: CabalSpy ID sends your app a ready-to-execute instruction for every trade of a copied trader, and your app executes it with the user’s wallet. CabalSpy ID never holds keys or executes trades.
On request, CabalSpy also switches on Callouts for your instance: your users publicly call tokens, and CabalSpy ID tracks each call like the CabalSpy call statistics, with stats, a leaderboard, a stream and callout competitions.
Your plan sets how many users you receive data for. Everyone can always sign in. Above the limit you receive an anonymous id and no data for the extra users until you upgrade. See Plans and limits.

