Bundles

Snapshot of KOL + side-wallet bundles detected for a Solana token, with live per-wallet positions (held, bag %, supply %, realized & unrealized PnL).

Bundle Snapshot — all bundles for one token

get

Returns a point-in-time snapshot of every bundle detected for the given mint, with each member wallet's live position. All bundles for the token are included on every call.

Required: blockchain (must be solana) and mint.

If no bundle has been detected for the token yet (or its snapshot has aged out of Redis), the response is still 200 with a populated token block and an empty bundles array — poll again once activity appears.

Authorizations

bearerAuthapiKeyQuery

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

blockchainstring · enumRequired

Must be solana (bundles are Solana-only).

Default: solanaPossible values:

mintstringRequired

Token mint address.

Example: 4e6hwqbdPRN9ovZqgSaoC2RfeYgmWfQiBsqDUSPTpump

api_keystringOptional

API key (alternative to the Authorization header).

Responses

200

Bundle snapshot for the token. data.bundles[] is empty when nothing has been detected yet.

application/json

successbooleanOptionalExample: true

400

Bad request (missing mint, or blockchain other than solana).

application/json

401

Unauthorized (missing or invalid API key).

application/json

403

Forbidden (invalid key or insufficient credits).

application/json

429

Rate limit exceeded.

application/json

500

Server error.

application/json

get/v1/bundle

HTTPcURLJavaScriptPython

GET /v1/bundle?blockchain=solana&mint=text HTTP/1.1
Host: api.cabalspy.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "data": {
    "blockchain": "solana",
    "token": {
      "mint": "4e6hwqbdPRN9ovZqgSaoC2RfeYgmWfQiBsqDUSPTpump",
      "symbol": "",
      "name": "",
      "supply": 999996649.9999999,
      "market_cap": 2726.6390999007554,
      "market_cap_usd": 224511.46,
      "market_cap_currency": "SOL",
      "price": 0.00000272664823417234,
      "price_usd": 0.000224512216,
      "sol_price_usd": 82.34,
      "pool": "pump-amm",
      "on_curve": false,
      "bonding_curve_progress": 100
    },
    "bundles": [
      {
        "bundle_id": null,
        "kol_wallet": "JAunzNqs3bVBcWDjDxfq9rgLzJMCadNXoaCgfzLGMtYs",
        "kol_profile": {
          "name": "Pengu",
          "image_url": "https://cabalspy.xyz/images/JAunzNqs3bVBcWDjDxfq9rgLzJMCadNXoaCgfzLGMtYs.png",
          "twitter": "https://x.com/Penguzxbt",
          "telegram": "",
          "blockchain": "solana",
          "currency": "SOL",
          "type": "kol"
        },
        "confidence": "high",
        "jito_confirmed": false,
        "proof_type": "on_chain_footprint",
        "slot": null,
        "wallet_count": 2,
        "proof": "Part of a CONNECTED consecutive block run of same-token buyers that share the KOL's fee, a similar SOL size and a similar token amount (a tip in between does not break the chain). Contiguity + matching size across several wallets is very unlikely by chance -> MEDIUM; recurrence of the same pair raises it. Not Jito-confirmed -> never exported to the customer table.",
        "verify_hint": null,
        "detected_at": "2026-07-04T16:25:34.986Z",
        "bundle_wallets": [
          {
            "address": "JAunzNqs3bVBcWDjDxfq9rgLzJMCadNXoaCgfzLGMtYs",
            "is_kol": true,
            "transaction_type": "buy",
            "signature": null,
            "entry_source": null,
            "position_source": "live",
            "profile": {
              "name": "Pengu",
              "image_url": "https://cabalspy.xyz/images/JAunzNqs3bVBcWDjDxfq9rgLzJMCadNXoaCgfzLGMtYs.png",
              "twitter": "https://x.com/Penguzxbt",
              "telegram": "",
              "blockchain": "solana",
              "currency": "SOL",
              "type": "kol"
            },
            "position": {
              "held": 0,
              "peak": 266294.303926,
              "bought_tokens": 266294.303926,
              "sold_tokens": 266294.303926,
              "bag_pct": 0,
              "supply_pct": 0,
              "invested": 1.481398,
              "invested_usd": 121.98,
              "max_single_buy": 1.481398,
              "buy_txn": 1,
              "sell_txn": 1,
              "sold_value": 1.159373,
              "sold_value_usd": 95.46,
              "realized_pnl_sol": -0.322025,
              "realized_pnl_usd": -26.52,
              "entry_market_cap": null,
              "entry_market_cap_usd": null,
              "unrealized_pnl_sol": -0.322025,
              "unrealized_pnl_usd": -26.52,
              "unrealized_pnl_pct": -50.99,
              "remaining_sol": 0,
              "remaining_usd": 0,
              "first_buy_at": "2026-07-04T16:25:33.000Z",
              "last_activity_at": "2026-07-04T16:25:34.987000Z"
            }
          },
          {
            "address": "8CvFWU1Hfmy7HkS7eWG2x8EMtQxAzCr7KcukKwspGFwB",
            "is_kol": false,
            "transaction_type": "buy",
            "signature": null,
            "entry_source": "at_bundle",
            "position_source": "live",
            "fee_lamports": 1595000,
            "block_index": 49,
            "adjacent_to_kol": null,
            "same_fee": null,
            "occurrences": 297,
            "profile": {
              "name": "",
              "image_url": "",
              "twitter": "",
              "telegram": "",
              "blockchain": "solana",
              "currency": "SOL",
              "type": null
            },
            "position": {
              "held": 305142.282665,
              "peak": 305142.282665,
              "bought_tokens": 305142.282665,
              "sold_tokens": 0,
              "bag_pct": 100,
              "supply_pct": 0.0305,
              "invested": 1.669166,
              "invested_usd": 137.44,
              "max_single_buy": 1.669166,
              "buy_txn": 1,
              "sell_txn": 0,
              "sold_value": 0,
              "sold_value_usd": 0,
              "realized_pnl_sol": -1.669166,
              "realized_pnl_usd": -137.44,
              "entry_market_cap": 4874.757056,
              "entry_market_cap_usd": 401387.5,
              "unrealized_pnl_sol": -0.83715,
              "unrealized_pnl_usd": -68.93,
              "unrealized_pnl_pct": -50.15,
              "remaining_sol": 0.832016,
              "remaining_usd": 68.51,
              "first_buy_at": "2026-07-04T16:25:34.986Z",
              "last_activity_at": "2026-07-04T16:25:34.987000Z"
            }
          }
        ]
      }
    ]
  },
  "meta": {
    "request_id": "req_9aa1917e433b",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2026-07-04T16:34:54Z"
  }
}