Skip to main content
GET
Signals
Live trade signals derived from tracked wallet activity in a recent time window. The main mode, cluster, surfaces tokens where several tracked wallets are buying at once, a strong early signal. Two more modes, entry and exit, return individual buy and sell signals in the feed format. Use it to drive alerts, for example notify me when three or more KOLs buy the same token within an hour. Signals are derived live from the feed, so they reflect the current window every time.
Choose the mode with mode. cluster groups wallets buying the same token, entry and exit return single buy or sell events. Tune clusters with min_wallets, min_value and hours. An advanced gated mode is available by passing per type filters like kol=3 and smart=2, see the gated mode parameters below.

Query Parameters

string
required
Chain. One of solana, bnb, base, eth, rh (Robinhood Chain).
string
required
Wallet category kol, smart or whale.
string
required
Signal mode. One of cluster, entry, exit.
integer
default:"3"
cluster mode. Minimum number of wallets buying the same token to form a cluster.
number
default:"0"
Minimum trade value to consider (native).
number
default:"1"
Time window in hours to look back for signals.
integer
Maximum number of signals to return.
string
Gated mode. Comma separated KOL wallet counts at which a signal fires, up to 3 values, for example 3 or 2,3,5. Passing kol or any kol_ parameter turns on the gated mode. Default 3.
string
Gated mode. Same as kol for Smart Money wallets, for example 2.
number
Gated mode. Minimum amount a KOL wallet must have bought (native) to count. Use smart_min_buy for Smart Money.
number
Gated mode. Maximum amount a KOL wallet may have bought (native) to count. Use smart_max_buy for Smart Money.
string
Gated mode. Comma separated wallet counts, up to 2 values. An exit is flagged when the number of KOL wallets still holding drops to one of these counts or below. Use smart_exit for Smart Money.
string
Gated mode. Comma separated wallet addresses. Only these wallets count.
string
Gated mode. Comma separated wallet addresses that never count.
number
Gated mode. Minimum win rate in percent (0 to 100) a wallet needs to count.
number
Gated mode. Minimum token age in hours.
number
Gated mode. Maximum token age in hours.
string
Your API key, required on https://api.cabalspy.xyz. Alternatively pass it as an Authorization Bearer header. Not needed on the demo server https://demo-api.cabalspy.xyz.
Try it without an API key: Try it runs on the demo server https://demo-api.cabalspy.xyz (20 requests per IP per day, data delayed 15 minutes, at most 5 rows), so you can send a request without a key. For live data, switch the server to https://api.cabalspy.xyz and enter your API key. Your own integration always calls api.cabalspy.xyz with your API key, as in the usage examples below. Get a free key · About the demo

Usage Example

Response

The response shape depends on mode. Below is the cluster mode, the most detailed. entry and exit return individual transactions in the same shape as the transactions feed (with holdings_after).
boolean
True on success.
object

Errors