cabalspy-xyz Signals API
Live and historical cluster, entry and exit signals.
Live and historical cluster, entry and exit signals.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/cabalspy-xyz:cabalspy-xyz-signals-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: CabalSpy Signals API
version: 1.0.0
description: 'REST API for CabalSpy on-chain labeled wallet data: tracked KOL, Smart Money and Whale wallets on Solana, BNB Chain, Base, Ethereum and Robinhood Chain (blockchain values: solana, bnb, base, eth, rh), with wallet profiles, leaderboards, PnL, token holders and transactions, bundle detection (Solana only), live signals and analytics.
Wallet type availability per chain: Solana has kol, smart, whale. BNB, Base and Robinhood Chain have kol, smart. ETH has kol.
Authentication: every request needs an API key, passed either as the api_key query parameter or as an Authorization Bearer header (the two are equivalent). Get a free key at https://apidashboard.cabalspy.xyz/.
Credits: a REST request costs 10 credits on every plan. The free tier includes 10,000 credits per month; credits reset on the first of every month.
Rate limits: requests per second by plan are 5 (Free), 20 (Starter), 50 (Pro) and 100 (Business). Exceeding the limit returns 429 rate_limited; wait and retry.
Responses share an envelope: success, data, meta (request_id, cached, cache_age_seconds, version, timestamp) and, on some endpoints, pagination.
Real-time data is available separately over WebSocket at wss://stream.cabalspy.xyz (not described by this document; 1 credit per event received).'
termsOfService: https://www.cabalspy.xyz/terms/
contact:
name: CabalSpy
email: contact@cabalspy.xyz
servers:
- url: https://api.cabalspy.xyz/v1
security:
- ApiKeyQuery: []
- BearerAuth: []
tags:
- name: Signals
description: Live and historical cluster, entry and exit signals.
paths:
/signals:
get:
operationId: getSignals
summary: Live signals
description: Live trade signals derived from tracked wallet activity in a recent window. cluster mode surfaces tokens where several tracked wallets are buying at once; entry and exit return individual buy and sell events in the transactions feed shape (with holdings_after). The documented response schema describes cluster mode. Costs 10 credits per request.
tags:
- Signals
externalDocs:
url: https://docs.cabalspy.xyz/signals
parameters:
- name: blockchain
in: query
required: true
description: Chain. One of solana, bnb, base, eth.
schema:
type: string
enum:
- solana
- bnb
- base
- eth
- rh
- name: type
in: query
required: true
description: Wallet category kol, smart or whale.
schema:
type: string
enum:
- kol
- smart
- whale
- name: mode
in: query
required: true
description: Signal mode. One of cluster, entry, exit.
schema:
type: string
enum:
- cluster
- entry
- exit
- name: min_wallets
in: query
required: false
description: cluster mode. Minimum number of wallets buying the same token to form a cluster.
schema:
type: integer
- name: min_value
in: query
required: false
description: Minimum trade value to consider (native).
schema:
type: number
- name: hours
in: query
required: false
description: Time window in hours to look back for signals.
schema:
type: number
- name: limit
in: query
required: false
description: Maximum number of signals to return.
schema:
type: integer
responses:
'200':
description: Successful response.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
description: True on success.
data:
type: object
properties:
blockchain:
type: string
wallet_types:
type: array
items: {}
description: The wallet types included.
currency:
type: string
filters:
type: object
additionalProperties: true
description: The applied filters (min_win_rate, include_wallets, exclude_wallets, min_token_age_hours, max_token_age_hours).
signals:
type: array
description: Signals. Item shape shown is for cluster mode.
items:
type: object
properties:
token:
type: object
additionalProperties: true
description: Token block (mint, token_name, blockchain, currency, token_supply, token_decimals).
signal_type:
type: string
description: cluster.
signal_strength:
type: string
description: strong or medium, based on how many wallets qualified.
currency:
type: string
gate:
type: object
additionalProperties: true
description: Whether the gate was met and the thresholds used.
window:
type: object
properties:
hours:
type: number
wallet_count:
type: integer
by_type:
type: object
additionalProperties: true
description: Wallet counts split by type.
total_invested:
type: number
total_invested_usd:
type: number
first_buy_at:
type: string
latest_buy_at:
type: string
time_span_minutes:
type: number
additionalProperties: true
token_stats:
type: object
additionalProperties: true
description: Whole history token stats (total_buyers, still_holding_count, active_count, total_volume, total_volume_usd, net_flow, holders_by_type, first_entry_time).
wallets:
type: array
items:
type: object
properties:
profile:
$ref: '#/components/schemas/Profile'
wallet_type:
type: string
win_rate:
type:
- number
- 'null'
description: Lifetime win rate, only when min_win_rate was requested, otherwise null.
window_invested:
type: number
window_invested_usd:
type: number
window_buy_txn:
type: integer
window_sell_txn:
type: integer
sold_in_window:
type: boolean
bought_at:
type: string
realized_pnl:
type: number
realized_pnl_usd:
type: number
realized_pnl_percentage:
type: number
bag_pct:
type: number
supply_pct:
type: number
still_holding:
type: boolean
is_active:
type: boolean
description: True when bag_pct is above 1 percent.
additionalProperties: true
additionalProperties: true
pagination:
$ref: '#/components/schemas/Pagination'
additionalProperties: true
pagination:
$ref: '#/components/schemas/Pagination'
meta:
$ref: '#/components/schemas/Meta'
additionalProperties: true
example:
success: true
data:
blockchain: solana
wallet_types:
- kol
currency: SOL
filters:
min_win_rate: null
include_wallets: null
exclude_wallets: null
min_token_age_hours: null
max_token_age_hours: null
signals:
- token:
mint: 3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump
token_name: invisibull
blockchain: solana
currency: SOL
token_supply: 1000000000
token_decimals: 6
signal_type: cluster
signal_strength: strong
currency: SOL
gate:
met: true
wallet_types:
- kol
thresholds:
kol: 3
window:
hours: 1
wallet_count: 5
by_type:
kol: 5
total_invested: 12.4
total_invested_usd: 1021.4
first_buy_at: '2026-07-06T10:20:00Z'
latest_buy_at: '2026-07-06T10:52:00Z'
time_span_minutes: 32.0
token_stats:
total_buyers: 12
still_holding_count: 8
active_count: 7
total_volume: 44.6
total_volume_usd: 3673.2
net_flow: 30.1
holders_by_type:
kol_count: 5
smart_count: 0
whale_count: 0
first_entry_time: '2026-07-06T09:58:00Z'
wallets:
- profile:
name: Maze
image_url: https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png
twitter: https://x.com/MazeCCC
telegram: ''
blockchain: solana
currency: SOL
type: kol
wallet_type: kol
win_rate: null
window_invested: 3.2
window_invested_usd: 263.6
window_buy_txn: 1
window_sell_txn: 0
sold_in_window: false
bought_at: '2026-07-06T10:20:00Z'
realized_pnl: 0.0
realized_pnl_usd: 0.0
realized_pnl_percentage: 0.0
bag_pct: 100.0
supply_pct: 0.32
still_holding: true
is_active: true
pagination:
limit: 50
total: 1
has_more: false
next_cursor: null
meta:
request_id: req_5162c7cf7f87
cached: false
cache_age_seconds: 0
version: 1.0.0
timestamp: '2026-07-06T11:01:57Z'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/RateLimited'
/signals/history:
get:
operationId: getSignalsHistory
summary: Signals history
description: Historical cluster signals that would have fired on past days, for backtesting a cluster strategy. Each entry carries the token, how many wallets clustered, how much they invested, the day and triggered_at. Costs 10 credits per request.
tags:
- Signals
externalDocs:
url: https://docs.cabalspy.xyz/signals-history
parameters:
- name: blockchain
in: query
required: true
description: Chain. One of solana, bnb, base, eth.
schema:
type: string
enum:
- solana
- bnb
- base
- eth
- rh
- name: type
in: query
required: true
description: Wallet category kol, smart or whale.
schema:
type: string
enum:
- kol
- smart
- whale
- name: days
in: query
required: false
description: How many past days to include.
schema:
type: integer
- name: limit
in: query
required: false
description: Maximum number of signals to return.
schema:
type: integer
responses:
'200':
description: Successful response.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
description: True on success.
data:
type: object
properties:
blockchain:
type: string
wallet_types:
type: array
items: {}
description: The wallet types included.
days:
type: integer
description: The number of past days included.
filters:
type: object
additionalProperties: true
description: Applied filters (min_win_rate, include_wallets, exclude_wallets).
signals:
type: array
items:
type: object
properties:
mint:
type: string
token_name:
type: string
token_supply:
type: number
signal_type:
type: string
description: cluster.
signal_strength:
type: string
description: strong or medium.
wallet_count:
type: integer
by_type:
type: object
additionalProperties: true
description: Wallet counts split by type.
total_invested:
type: number
total_invested_usd:
type:
- number
- 'null'
description: Total invested in USD, or null if no price was available.
currency:
type: string
triggered_at:
type: string
description: When the first buy of the cluster happened.
day:
type: string
description: The day this signal belongs to.
window:
type: string
description: The aggregation window, 1d.
would_have_fired:
type: boolean
description: Whether the signal would have fired under the thresholds.
additionalProperties: true
additionalProperties: true
meta:
$ref: '#/components/schemas/Meta'
additionalProperties: true
example:
success: true
data:
blockchain: solana
wallet_types:
- kol
days: 7
filters:
min_win_rate: null
include_wallets: null
exclude_wallets: null
signals:
- mint: 3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump
token_name: invisibull
token_supply: 1000000000
signal_type: cluster
signal_strength: strong
wallet_count: 5
by_type:
kol: 5
total_invested: 12.4
total_invested_usd: 1021.4
currency: SOL
triggered_at: '2026-07-04T16:25:34Z'
day: '2026-07-04'
window: 1d
would_have_fired: true
meta:
request_id: req_5162c7cf7f87
cached: false
cache_age_seconds: 0
version: 1.0.0
timestamp: '2026-07-06T11:01:57Z'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/RateLimited'
components:
responses:
BadRequest:
description: Bad request. Code missing_parameter (a required parameter is missing) or invalid_parameter (a parameter is missing or has an invalid value, for example a chain and wallet type combination that does not exist such as eth with whale).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
RateLimited:
description: Code rate_limited. Rate limit exceeded (the plan's requests-per-second limit), wait and retry.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
Forbidden:
description: Code forbidden. API key invalid or credits exhausted.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
Unauthorized:
description: Code unauthorized. API key missing.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
schemas:
Error:
type: object
description: Error response. The documentation specifies the HTTP status and an error code (missing_parameter, invalid_parameter, unauthorized, forbidden, not_found, rate_limited) but not the exact body layout, so no fields are asserted here.
additionalProperties: true
Profile:
type: object
description: Wallet profile.
properties:
name:
type: string
description: Display name (may be empty).
image_url:
type: string
description: Avatar URL.
twitter:
type: string
description: Twitter or X link.
telegram:
type: string
description: Telegram link.
blockchain:
type: string
description: Chain.
currency:
type: string
description: Native currency.
type:
type:
- string
- 'null'
description: Wallet type kol, smart or whale.
additionalProperties: true
Meta:
type: object
description: Request metadata returned with every response.
properties:
request_id:
type: string
cached:
type: boolean
cache_age_seconds:
type: integer
version:
type: string
timestamp:
type: string
additionalProperties: true
Pagination:
type: object
description: Standard pagination object. Depending on the endpoint it appears inside data or next to data at the top level of the response.
properties:
limit:
type:
- integer
- 'null'
description: Requested page size (null means all).
total:
type: integer
description: Total number of items.
has_more:
type: boolean
description: Whether more pages follow.
next_cursor:
type:
- string
- 'null'
description: Cursor for the next page (null means end).
additionalProperties: true
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api_key
description: Your API key as the api_key query parameter.
BearerAuth:
type: http
scheme: bearer
description: Your API key as an Authorization Bearer header.
externalDocs:
description: CabalSpy API documentation
url: https://docs.cabalspy.xyz/