Smart Money KOL Detail

GET/gateway/v1/smart-money/kol/detail

Returns one KOL's smart-money profile: scores, board membership, per-market (spot / perp) statistics with weekly PnL, whether they hold what they call on X (big-account KOLs), and the KOLs they most often call the same tokens with.

Look up by X handle. Returns 404 when the KOL is not tracked.

Privacy: responses never include wallet addresses or transaction identifiers. Per-KOL amounts are rounded to 2 significant figures, and per-token KOL lists carry names only.

Data refresh: daily

Smart Money KOL Detail

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/smart-money/kol/detail', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataObjectResponseSmartMoneyKOLDetail.json",
  "data": {
    "avatar": "<string>",
    "call_audit": {
      "consistency_rate": 123,
      "handle": "<string>",
      "n_bought_after": 123,
      "n_holding": 123,
      "n_no_position": 123,
      "n_opposite": 123,
      "n_sold_before": 123,
      "n_tokens": 123,
      "tokens": [
        {
          "consistent": true,
          "direction": "<string>",
          "first_call_day": 123,
          "is_major": true,
          "last_call_day": 123,
          "n_calls": 123,
          "symbol": "<string>",
          "verdict": "<string>"
        }
      ]
    },
    "co_callers": [
      {
        "handle": "<string>",
        "n_shared_tokens": 123,
        "shared_symbols": []
      }
    ],
    "composite_rank": 123,
    "flags": [],
    "followers_count": 123,
    "handle": "<string>",
    "is_bigv": true,
    "is_smart": true,
    "markets": {
      "perp": {
        "active_weeks": 123,
        "mean_return": 123,
        "n_positions": 123,
        "payoff_ratio": 123,
        "pnl_usd": 123,
        "positions_30d": 123,
        "profitable_weeks": 123,
        "sample_full": true,
        "score": 123,
        "volume_usd": 123,
        "weekly_pnl": [
          {
            "pnl_usd": 123,
            "week_start": 123
          }
        ],
        "win_rate": 123
      },
      "spot": {
        "active_weeks": 123,
        "mean_return": 123,
        "n_positions": 123,
        "payoff_ratio": 123,
        "pnl_usd": 123,
        "positions_30d": 123,
        "profitable_weeks": 123,
        "sample_full": true,
        "score": 123,
        "volume_usd": 123,
        "weekly_pnl": [
          {
            "pnl_usd": 123,
            "week_start": 123
          }
        ],
        "win_rate": 123
      }
    },
    "name": "<string>",
    "on_composite_board": true,
    "perp_notional_90d_usd": 123,
    "pnl_90d_usd": 123,
    "risks": [],
    "scores": {
      "composite": 123,
      "followers_pct": 123,
      "influence": 123,
      "smart": 123,
      "smart_followers_pct": 123,
      "volume_pct": 123
    },
    "smart_followers_count": 123,
    "smart_rank": 123,
    "smart_since": 123,
    "spot_volume_90d_usd": 123,
    "suspected_bot_markets": [],
    "verified": true
  },
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>"
  }
}