Signals

Live KOL and smart-money entry/exit cluster signals across Solana, BNB Chain, Base and Ethereum. One stream; pick the chain with blockchain and set per-type thresholds at subscribe time.

Signals — Live Entry & Exit Cluster Alerts (WebSocket)

get

Subscribe to the live signal stream and receive a signal message each time an entry or exit tier is reached for the configured wallet types.

• blockchain (required) — solana, bnb, base, eth. Change this to switch chain.

• token (optional, default *) — a mint/contract to watch one token, or * for all.

• kol / smart (optional) — per-type threshold blocks (min_buy, entry_at, exit_at, max_wallet_buy).

• include_wallets, exclude_wallets, min_win_rate, min_token_age, max_token_age (optional) — subscription-wide filters.

Authorizations

bearerAuthapiKeyQuery

AuthorizationstringRequired

Authorization: Bearer YOUR_KEY

Body

application/json

Client -> server. Start receiving entry/exit cluster signals; filters persist until unsubscribe.

opstring · enumRequiredExample: subscribePossible values:

streamstring · enumRequiredExample: signalPossible values:

blockchainstring · enumRequired

Change this to switch chain.

Example: solanaPossible values:

tokenstringOptional

A mint/contract, or "*" for all tokens.

Example: *

include_walletsstring[]Optional

Only these wallets count toward the cluster.

exclude_walletsstring[]Optional

These wallets never count.

min_win_ratenumber · max: 100Optional

Drop wallets below this lifetime win-rate. Warned + skipped if win-rate data is not yet warm.

min_token_agenumberOptional

Minimum token age in hours.

max_token_agenumberOptional

Maximum token age in hours.

Responses

200

A signal message pushed each time an entry or exit tier is reached. (The connection also delivers a connected welcome, a subscribed ack per subscribe, and error messages — see schemas.)

application/json

One cluster signal — an entry tier reached, or an exit tier reached.

successbooleanOptionalExample: true

channelstringOptional

Channel that produced this message — signal..

Example: signal.solana

eventstring · enumOptionalExample: signalPossible values:

get/signal

HTTPcURLJavaScriptPython

GET /signal HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 93

{
  "op": "subscribe",
  "stream": "signal",
  "blockchain": "solana",
  "token": "*",
  "kol": {
    "entry_at": [
      5
    ]
  }
}

Solana, one KOL entry tier at 5KOL entry tiers + exit ("only 2 still holding")AND-gate — fire only when 5 KOLs AND 2 smart wallets are inFull per-type config with filtersEthereum (KOL only)

200

A signal message pushed each time an entry or exit tier is reached. (The connection also delivers a connected welcome, a subscribed ack per subscribe, and error messages — see schemas.)

{
  "success": true,
  "channel": "signal.solana",
  "event": "signal",
  "data": {
    "signal_kind": "entry",
    "blockchain": "solana",
    "wallet_types": [
      "kol",
      "smart"
    ],
    "mint": "H7gHym8H2e8iy22NpU3MLWCt8jUcHYj5qfpqNCdtpump",
    "token": {
      "mint": "H7gHym8H2e8iy22NpU3MLWCt8jUcHYj5qfpqNCdtpump",
      "symbol": "LIFE",
      "name": "Solana Life",
      "supply": 1000000000,
      "decimals": 6,
      "market_cap": 520.41,
      "market_cap_usd": 35861.46,
      "market_cap_currency": "SOL",
      "pool": "pump-amm",
      "on_curve": false,
      "bonding_curve_progress": 100
    },
    "threshold": {
      "fired_on": "entry",
      "exit_type": null,
      "exit_remaining": null,
      "currency": "SOL",
      "kol": {
        "min_buy": 1,
        "entry_at": [
          5,
          10
        ],
        "exit_at": [
          2
        ],
        "max_wallet_buy": 50
      },
      "smart": {
        "min_buy": 0,
        "entry_at": [
          2
        ],
        "exit_at": [
          1
        ],
        "max_wallet_buy": null
      }
    },
    "cluster": {
      "kol": {
        "qualifying": 10,
        "sold": 6,
        "holding": 4
      },
      "smart": {
        "qualifying": 2,
        "sold": 0,
        "holding": 2
      },
      "qualifying_total": 12,
      "total_invested": 45.081683,
      "total_invested_usd": 3106.58,
      "unrealized_pnl_sol": -4.509439,
      "unrealized_pnl_usd": -310.75,
      "unrealized_pnl_pct": -23.08,
      "currency": "SOL"
    },
    "trigger": {
      "wallet": "AmhMcYkzxFGXjahgBrTbr1aw2tw1mCWSwyihnRMefBNa",
      "action": "buy",
      "value": 1.033444,
      "signature": "37N79WSP7FbaTX5pYNRbbbndjennqTj9Do7QpDWvF5PNw8UWHvZTttQPRNUZuzSJXCxGK1etCURRjNkaKVkekyKd",
      "created_at": 1782248245
    },
    "wallets": [
      {
        "wallet": "CEUA7zVoDRqRYoeHTP58UHU6TR8yvtVbeLrX1dppqoXJ",
        "wallet_type": "kol",
        "win_rate": 35.71,
        "profile": {
          "name": "Tom",
          "image_url": "https://cabalspy.xyz/images/CEUA7zVoDRqRYoeHTP58UHU6TR8yvtVbeLrX1dppqoXJ.png",
          "twitter": "https://x.com/tdmilky",
          "telegram": "",
          "blockchain": "solana",
          "currency": "SOL",
          "type": "kol",
          "active_hours": null
        },
        "invested": 7.674079,
        "invested_usd": 528.82,
        "max_single_buy": 7.674079,
        "buy_txn": 1,
        "sell_txn": 0,
        "sold_value": 0,
        "sold": false,
        "bag_pct": 100,
        "first_buy_at": "2026-06-23T20:56:13.000Z",
        "entry_market_cap": 621.283577,
        "entry_market_cap_usd": 42812.65,
        "unrealized_pnl_sol": -1.245987,
        "unrealized_pnl_pct": -16.24
      }
    ]
  },
  "meta": {
    "request_id": "req_04284629f465",
    "version": "2.0.0",
    "timestamp": "2026-06-23T20:57:30.893Z"
  }
}