
$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 Activity: Lists what KOLs opened and closed, one row per KOL, day, market, chain, token and kind (open, close), newest first: size (perp: notional), realized PnL on closes, and the number of positions behind the row. Covers the last 90 days.
Pass up to 50 X handles in handles (comma-separated, @ optional, case-insensitive); a former handle is answered under the KOL's current one. since defaults to 7 days ago; min_usd (default 1000) drops small rows; market is spot, perp or all. The response also carries coverage for every requested handle.
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. Activity is aggregated per day.
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
- Token DEX tradesGET/gateway/v1/token/dex-trades$0.02616 per callFixed