KOL, alpha and bundles

Lists of known wallets and how they trade. Every route on this page is free and reads data Scanner already holds.

12 routes. Every path below is served under https://api.scanner.net, and every request carries the key header, so those two are not repeated per route. Shared errors and limits are in Requests and errors. Keys need the Alpha, KOL and signals endpoint group for these routes.

KOL wallets

GET /kol/wallets

Every KOL wallet Scanner tracks, best ranked first.

curl "https://api.scanner.net/kol/wallets?limit=100" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: { "success": true, "wallets": [...], "count": 100 }. Each wallet has wallet_address, name, twitter_handle, profile_picture_url, kolscan_rank, is_featured, created_at and updated_at.

KOL wallet

GET /kol/wallets/{address}

One KOL wallet.

curl "https://api.scanner.net/kol/wallets/WALLET_ADDRESS" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: { "success": true, "wallet": { ... } }, with the fields listed under KOL wallets.

KOL wallets in bulk

POST /kol/wallets/batch

Which of up to 200 addresses are KOL wallets.

curl -X POST "https://api.scanner.net/kol/wallets/batch" \
  -H "x-api-key: $SCANNER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"addresses":["WALLET_1","WALLET_2"]}'

Response: { "success": true, "wallets": [...] }, the matching KOL wallets only, in no set order.

KOL wallet scan

GET /kol/wallets/{address}/scan

The saved wallet scan of a KOL wallet. It never starts a scan.

curl "https://api.scanner.net/kol/wallets/WALLET_ADDRESS/scan" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: { "success": true, "scanResult", "scannedAt", "scanDepth" }, where scanResult is a wallet scan result. When there is no saved scan, or the address isn't a KOL wallet, the response is 200 with { "success": false }.

KOL side wallets

GET /kol/wallets/{address}/bundles

Likely side wallets: the wallets most strongly bundled with this one, at high confidence only. Works for any Solana address, not only KOL wallets.

curl "https://api.scanner.net/kol/wallets/WALLET_ADDRESS/bundles" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: { "success": true, "sideWallets": [...] }, up to 50, most confident first. Each has address, co_appearances, confidence (80 to 96), first_seen_at and last_seen_at. For every link regardless of confidence, use Bundled wallets.

Featured KOL wallets

GET /kol/featured

Featured KOL wallets, in random order.

curl "https://api.scanner.net/kol/featured?limit=20" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: { "success": true, "wallets": [...], "count": 20 }.

KOL PnL

GET /kol/pnl

The latest profit and loss for every KOL wallet. No parameters and no paging.

curl "https://api.scanner.net/kol/pnl" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: { "success": true, "pnl": [...], "count" }. Each entry has wallet_address, pnl_1d, pnl_7d, pnl_30d, total_realized, total_unrealized, total_pnl, win_percentage and fetched_at.

KOL PnL history

GET /kol/pnl/history

Daily PnL snapshots for up to 5 KOL wallets, oldest first.

curl "https://api.scanner.net/kol/pnl/history?addresses=WALLET_1,WALLET_2&days=7" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: { "success": true, "snapshots": [...], "count" }. Each snapshot has wallet_address, realized, unrealized, total, pnl_1d and snapshot_at.

KOL wallet PnL

GET /kol/pnl/{address}

The latest PnL detail for one KOL wallet.

curl "https://api.scanner.net/kol/pnl/WALLET_ADDRESS" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: { "success": true, "pnl": { ... } }. pnl has wallet_address, pnl_1d, pnl_7d, pnl_30d, fetched_at and a summary with realized, unrealized, total, totalInvested, averageBuyAmount, totalWins, totalLosses, winPercentage and lossPercentage. When there is no PnL for the address, the response is 200 with { "success": false }.

Alpha traders

GET /alpha/traders

The alpha trader leaderboard: top Solana traders ranked over 1, 7 and 30 days. No parameters and no paging, so the response is large.

curl "https://api.scanner.net/alpha/traders" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: an AlphaTradersResponse: success, traders, count, periods (1d, 7d, 30d), generated_at and source. Each trader has wallet_address, display_name, twitter_handle, entity, tags, periods (stats per period), pnl_1d/pnl_7d/pnl_30d, roi_* and rank_* per period, win_rate, trades, volume, total_pnl, first_trade and last_trade. Rows are ordered by 1-day rank, then 7-day, then 30-day.

Wallets you saved in Scanner show your saved name, with is_saved: true.

Alpha PnL history

GET /alpha/pnl/history

Daily PnL for up to 5 alpha traders, oldest first.

curl "https://api.scanner.net/alpha/pnl/history?addresses=WALLET_1,WALLET_2&days=14" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: { "success": true, "snapshots": [...], "count" }. Each snapshot has wallet_address, realized, unrealized, total, pnl_1d, pnl_7d, pnl_30d and snapshot_at. Any of the PnL fields can be null.

Bundled wallets

GET /bundles/{address}

Every wallet Scanner has recorded as bundled with this address in its token scans.

curl "https://api.scanner.net/bundles/WALLET_ADDRESS" \
  -H "x-api-key: $SCANNER_API_KEY"

Response: { "address", "bundledWallets", "totalRelationships" }, with no success field. Each bundled wallet has address, coAppearances, firstSeen and lastSeen, most co-appearances first. totalRelationships counts the links read, up to 200 for a direct lookup.