Signal History

Historical entry/exit cluster signals for backtesting.

Signals History — Backtest Cluster Signals

get

Replays cluster detection over history. Provide gated parameters for the full cluster model, or use the legacy type + days form for a compact summary.

Query parameters

blockchainstring · enumRequiredPossible values:

kolstringOptional

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

smartstringOptional

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

kol_min_buynumberOptional

kol_max_buynumberOptional

kol_exitstringOptional

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

smart_min_buynumberOptional

smart_max_buynumberOptional

smart_exitstringOptional

include_walletsstringOptional

exclude_walletsstringOptional

min_win_ratenumber · max: 100Optional

min_token_agenumberOptional

hours

max_token_agenumberOptional

hours

typestring · enumOptional

Legacy: wallet type.

Possible values:

daysstring · enumOptional

Legacy: lookback window.

Default: 30Possible values:

modestring · enumOptional

Legacy: filter by signal_type.

Possible values:

limitinteger · min: 1OptionalDefault: 200

api_keystringOptional

Responses

200

Gated mode → data.gated:true with data.signals[] in the full cluster model (same shape as /v1/signals gated, each carrying token market cap / on_curve / bonding_curve_progress). Legacy mode → compact per-day summary.

application/json

or

400

Bad request

application/json

401

Unauthorized

application/json

500

Server error

application/json

get/v1/signals/history

HTTPcURLJavaScriptPython

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

{
  "success": true,
  "data": {
    "blockchain": "solana",
    "type": "kol",
    "days": "30",
    "_total": 1,
    "signals": [
      {
        "token": {
          "mint": "4RuEBW7CzibKKKZekcD99ar3ZeLssq94whjfwruopump",
          "token_name": "MonkCoin",
          "blockchain": "solana",
          "currency": "SOL",
          "market_cap": 104.93,
          "market_cap_usd": 7240.48,
          "market_cap_currency": "SOL",
          "pool": "pump",
          "on_curve": true,
          "bonding_curve_progress": 33.08
        },
        "signal_type": "cluster",
        "signal_strength": "medium",
        "wallet_count": 3,
        "total_invested": 7.22456,
        "total_invested_usd": 498.49,
        "currency": "SOL",
        "triggered_at": "2026-06-23T21:01:49.000Z",
        "day": "2026-06-23",
        "window": "1d"
      }
    ]
  },
  "meta": {
    "request_id": "req_hist_001",
    "cached": true,
    "pagination": {
      "limit": 200,
      "total": 1,
      "returned": 1
    }
  }
}