Skip to main content
GET
Signals History
The historical counterpart to Signals. Returns cluster signals that would have fired on past days, so you can backtest a strategy. Each entry marks the token, how many wallets clustered, how much they invested, and when the signal triggered. Use it to answer questions like how often did a three KOL cluster precede a move, or to replay signals for a given day.
Look back with days. Each signal carries would_have_fired and the day it belongs to, along with triggered_at, so you can line signals up against price history from your own source.

Query Parameters

string
required
Chain. One of solana, bnb, base, eth, rh (Robinhood Chain).
string
required
Wallet category kol, smart or whale.
string
default:"30"
How many past days to include. One of 7, 30, 90 or all.
integer
default:"3"
Minimum wallets that must have clustered for a historical signal.
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

boolean
True on success.
object

Errors