Signals

Real-time cluster, entry and exit signals from tracked KOL, smart-money and whale wallets on Solana, BNB Chain, Base and Ethereum.

Live Signals — Cluster, Entry & Exit (per-type gate)

get

Returns live signals for one chain within a time window.

Gated parameters (presence of any one switches to gated mode):

• kol, smart — entry tiers as a CSV of up to 3 ascending ints (kol=5 or kol=5,10,20). The smallest is the gate.

• kol_min_buy, kol_max_buy, smart_min_buy, smart_max_buy — per-type cumulative-buy bounds (native units).

• kol_exit, smart_exit — exit tiers as a CSV of up to 2 "still holding" counts (kol_exit=3,1).

• include_wallets, exclude_wallets — comma-separated wallet lists.

• min_win_rate (0–100), min_token_age, max_token_age (hours).

Legacy parameters (when no gated parameter is present):

• type (kol/smart/whale), mode (cluster/entry/exit), min_wallets, min_value.

Common: blockchain (required), hours, limit, api_key.

Unknown parameters are ignored and reported in data.warnings.

Query parameters

blockchainstring · enumRequired

solana | bnb | base | eth

Possible values:

kolstringOptional

Gated: KOL entry tiers, CSV up to 3 ascending ints (e.g. 5 or 5,10,20).

Example: 5,10,20

smartstringOptional

Gated: smart-money entry tiers, CSV up to 3 ints.

Example: 2

kol_min_buynumberOptional

Gated: min cumulative KOL buy (native).

kol_max_buynumberOptional

Gated: max cumulative KOL buy (native).

kol_exitstringOptional

Gated: KOL exit tiers, CSV up to 2 "still holding" counts (e.g. 3,1).

Example: 3,1

smart_min_buynumberOptional

smart_max_buynumberOptional

smart_exitstringOptional

Gated: smart-money exit tiers, CSV up to 2.

include_walletsstringOptional

Gated: comma-separated wallets that alone count.

exclude_walletsstringOptional

Gated: comma-separated wallets to drop.

min_win_ratenumber · max: 100Optional

Gated: drop wallets below this lifetime win-rate (0–100).

min_token_agenumberOptional

Gated: min token age (hours).

max_token_agenumberOptional

Gated: max token age (hours).

typestring · enumOptional

Legacy: wallet type.

Possible values:

modestring · enumOptional

Legacy: cluster | entry | exit.

Possible values:

min_walletsinteger · min: 1Optional

Legacy: min wallets for a cluster.

Default: 3

min_valuenumberOptional

Legacy: ignore trades below this (native).

Default: 0

hoursnumberOptional

Window size in hours.

Default: 1

limitinteger · min: 1Optional

api_keystringOptional

Responses

200

Signals payload. In gated mode, data.gated is true and data.signals[] use the cluster model below.

application/json

successbooleanOptionalExample: true

400

Bad request

application/json

401

Unauthorized

application/json

404

Not found

application/json

500

Server error

application/json

get/v1/signals

HTTPcURLJavaScriptPython

GET /v1/signals?blockchain=solana HTTP/1.1
Host: api.cabalspy.xyz
Accept: */*

{
  "success": true,
  "data": {
    "blockchain": "solana",
    "wallet_types": [
      "kol",
      "smart"
    ],
    "currency": "SOL",
    "gated": true,
    "filters": {
      "min_win_rate": 60,
      "include_wallets": null,
      "exclude_wallets": null,
      "min_token_age_hours": null,
      "max_token_age_hours": 48
    },
    "_total": 1,
    "signals": [
      {
        "token": {
          "mint": "4RuEBW7CzibKKKZekcD99ar3ZeLssq94whjfwruopump",
          "token_name": "MonkCoin",
          "blockchain": "solana",
          "currency": "SOL",
          "token_supply": 1000000000,
          "token_decimals": 6,
          "market_cap": 104.934531,
          "market_cap_usd": 7240.48,
          "market_cap_currency": "SOL",
          "pool": "pump",
          "on_curve": true,
          "bonding_curve_progress": 33.08,
          "market_cap_updated_at": "2026-06-23T21:02:09.000Z"
        },
        "signal_type": "cluster",
        "signal_strength": "medium",
        "currency": "SOL",
        "gate": {
          "met": true,
          "wallet_types": [
            "kol",
            "smart"
          ],
          "thresholds": {
            "kol": {
              "min_buy": 1,
              "entry_at": [
                5,
                10
              ],
              "gate": 5,
              "tier_reached": 5,
              "max_wallet_buy": 50,
              "exit_at": [
                2
              ],
              "exit_at_met": []
            },
            "smart": {
              "min_buy": 0,
              "entry_at": [
                2
              ],
              "gate": 2,
              "tier_reached": 2,
              "max_wallet_buy": null,
              "exit_at": [],
              "exit_at_met": []
            }
          }
        },
        "window": {
          "hours": 1,
          "wallet_count": 7,
          "by_type": {
            "kol": {
              "wallet_count": 5,
              "sold": 0,
              "holding": 5,
              "invested": 6.52,
              "invested_usd": 449.9,
              "tier_reached": 5
            },
            "smart": {
              "wallet_count": 2,
              "sold": 0,
              "holding": 2,
              "invested": 0.7,
              "invested_usd": 48.6,
              "tier_reached": 2
            }
          },
          "total_invested": 7.22456,
          "total_invested_usd": 498.49,
          "first_buy_at": "2026-06-23 21:01:49",
          "latest_buy_at": "2026-06-23 21:02:09",
          "time_span_minutes": 0.33
        },
        "token_stats": {
          "total_buyers": 41,
          "still_holding_count": 18,
          "active_count": 12,
          "total_volume": 312.5,
          "total_volume_usd": 21562.5,
          "net_flow": 44.1,
          "holders_by_type": {
            "kol_count": 9,
            "smart_count": 4,
            "whale_count": 0
          },
          "first_entry_time": "2026-06-23T20:55:00.000Z"
        },
        "wallets": [
          {
            "profile": {
              "name": "Stigman",
              "image_url": "https://cabalspy.xyz/images/8fsKLLtvKNanL4ginCaiRS6UfeemY11rSf8U8fN1dJw4.png",
              "twitter": "https://x.com/Stigman__",
              "telegram": "https://t.me/StigmanPlayGround",
              "blockchain": "solana",
              "currency": "SOL",
              "type": "kol",
              "active_hours": null
            },
            "wallet_type": "kol",
            "win_rate": 21.26,
            "window_invested": 3.015007,
            "window_invested_usd": 208.04,
            "window_buy_txn": 2,
            "window_sell_txn": 0,
            "sold_in_window": false,
            "bought_at": "2026-06-23 21:01:50",
            "realized_pnl": 0,
            "realized_pnl_usd": 0,
            "realized_pnl_percentage": 0,
            "bag_pct": 100,
            "supply_pct": 0.3,
            "still_holding": true,
            "is_active": true
          }
        ]
      }
    ]
  },
  "meta": {
    "request_id": "req_9246bcdeac74",
    "cached": false,
    "pagination": {
      "limit": 50,
      "total": 1,
      "returned": 1
    }
  }
}