Smart Money KOL Ranking

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

Ranks crypto KOLs by how well they actually trade.

Boards (`type`): - `composite` (default): trading skill blended with influence; every Smart KOL is included, plus KOLs with a composite score of at least 40. - `smart`: trading skill only. The skill score is computed from the last 90 days of on-chain spot and perp positions and validated out of sample — KOLs scoring 75+ were profitable in the following month more than twice as often as the average KOL. - `bigv`: large accounts (50k+ followers and $500k+ traded), regardless of skill.

Each row carries scores, 90-day PnL and volume (rounded) and the reasons a KOL is kept off the Smart board (`flags`). Use `smart-money-kol-detail` for per-market statistics.

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

Query Parameters

typeenum<string>

Board: composite (skill + influence), smart (trading skill only), bigv (large following and trading volume)

Available options:compositesmartbigv

Example: composite

sort_byenum<string>

Sort field. Defaults to the board's own order: rank for composite and smart (by unrounded scores), volume (spot + perp, unrounded) for bigv

Available options:composite_scoresmart_scoreinfluence_scorepnlfollowersvolume

Example: smart_score

orderenum<string>

Sort order

Available options:ascdesc

Example: desc

limitinteger

Results per page

Example: 20

offsetinteger

Pagination offset

Example: 0

Smart Money KOL Ranking

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/smart-money/kol/ranking?type=composite&sort_by=smart_score&order=desc&limit=20&offset=0', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseSmartMoneyKOLItem.json",
  "data": [
    {
      "avatar": "<string>",
      "flags": [],
      "followers_count": 123,
      "handle": "<string>",
      "is_bigv": true,
      "is_smart": true,
      "name": "<string>",
      "on_composite_board": true,
      "perp_notional_90d_usd": 123,
      "pnl_90d_usd": 123,
      "rank": 123,
      "risks": [],
      "scores": {
        "composite": 123,
        "followers_pct": 123,
        "influence": 123,
        "smart": 123,
        "smart_followers_pct": 123,
        "volume_pct": 123
      },
      "smart_followers_count": 123,
      "smart_since": 123,
      "spot_volume_90d_usd": 123,
      "suspected_bot_markets": [],
      "verified": true
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}