
$0.01308per call
Every call costs the same.
You aren't charged for failed calls. A wallet payment for a failed call is refunded.
About this endpoint
Smart Money KOL Holdings: Returns KOLs' current portfolios in USD: total and DeFi value, the largest token holdings with their share of the total (stablecoins combined as STABLES), and open perp positions by notional. USD values only, never token amounts.
Pass up to 50 X handles in handles (comma-separated, @ optional, case-insensitive); a former handle is answered under the KOL's current one. min_usd (default 500) drops small holdings; limit caps holdings per KOL.
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: hourly
Query parameters
Response types
More from Surf API
- KOL rankingGET/gateway/v1/smart-money/kol/ranking$0.01308 per callFixed
- Liquidation chartGET/gateway/v1/market/liquidation/chart$0.01308 per callFixed
- Blockchain SQL queryPOST/gateway/v1/onchain/sql$0.02616 per callFixed
- KOL call historyGET/gateway/v1/smart-money/kol/history$0.01308 per callFixed
- Order book depthGET/gateway/v1/exchange/depth$0.00654 per callFixed
- Latest company financialsGET/gateway/v1/equity/latest-financialsUp to $0.03924 per callResponse-based
- Web page fetchGET/gateway/v1/web/fetch$0.00654 per callFixed
- Matched market pairsGET/gateway/v1/prediction-market/matching/pairs$0.02616 per callFixed
- Polymarket wallet positionsGET/gateway/v1/prediction-market/polymarket/positions$0.02616 per callFixed
- Hyperliquid trader leaderboardGET/gateway/v1/hyperliquid/leaderboard$0.02616 per callFixed
- Perpetual contract snapshotGET/gateway/v1/exchange/perp$0.00654 per callFixed
- KOL activityGET/gateway/v1/smart-money/kol/activity$0.01308 per callFixed