Skip to main content
The Trade Feed is a person’s own timeline of traders. A user adds CabalSpy ID traders to it, and from then on sees every trade those traders make on their verified wallets, plus every thesis they post, newest first. Each trade is labeled (new position, added, sold x %, closed) and a sell carries its realized PnL when the entry is known. The Trade Feed is part of every CabalSpy ID account and works on every plan. Your platform can:
  • show and manage a user’s Trade Feed from your backend with the Data API,
  • get every new trade and thesis for your users as a webhook or on the Trade Feed stream, to send your own notifications,
  • drop a + Trade Feed button and the feed itself into your pages with the widgets,
  • let users copy the traders in their Trade Feed.

​
Who has a Trade Feed

Your app acts in the name of a user who:
  • signed in to your app with CabalSpy ID and granted the scope trade_feed, by csid_id,
  • or is one of your platform users, who always have the scope.
The user must be within your plan’s user limit. Others get 403 consent_required. Request the scope at sign-in, for example with data-scope="openid profile trade_feed" on the login button. The consent screen shows it as “Add traders to your Trade Feed and get their trades”.

​
Who can be added

  • Any CabalSpy ID user whose trading is public. Traders who keep their trading private cannot be added (trading_private).
  • Your own platform users, on your platform. With network sharing switched on in your settings, on other platforms too.
  • Not the user themselves (cannot_add_self).
A Trade Feed holds at most 300 traders (trade_feed_full). A user can make at most 120 changes to their Trade Feed per hour (rate_limited). When a trader switches their trading to private, they disappear from every Trade Feed (timeline, alerts, webhooks, copy trading) until they are public again. A trader’s verified wallet addresses are public, so every trade carries the wallet and links to the explorer. Traders never see who added them, only in how many Trade Feeds they are.

​
What appears in the feed

Trades on Solana, BNB Chain, Base, Ethereum and Robinhood Chain are included. The feed can be filtered to buys, sells or theses.

​
Alerts and filters

Every trade is delivered. Nothing is capped, sampled or merged away. Per trader, each user can narrow what they are alerted about: A newly added trader starts with the user’s default alert settings from their CabalSpy ID settings. You can pass other values when you add the trader. The filters decide which of your users are listed in a webhook or stream event, and what shows in notifications. The timeline itself always shows every trade. Copy trading ignores the filters. Telegram. Users who linked Telegram get their alerts from the CabalSpy ID bot. When several trades wait for the same chat, they go out together in one message listing every trade. Your platform users only get Telegram alerts when Telegram alerts for your users is on in your settings. With No CabalSpy ID branding on, the alerts carry no CabalSpy ID wording or links.

​
Endpoints