Token key holders
get_token_key_holdersThe most significant holders of this token and how concentrated ownership is. High concentration is a risk signal worth stating explicitly to the user. ⚠️ These are OTHER people's wallets — this is NOT the user's position in the token. For that, use get_my_position. whale_count/trader_count/kol_count (and the claim's tag_count, when tag is set) are always TRUE totals; page/limit are echoed back. Each row carries the wallet's 30-day win_rate and realized_pnl_30d_usd, and days_since_prev_trade / prev_trade_at for its latest trade in this token (how long the wallet was quiet before it, any token). Rows and counts only include positions worth at least min_position_usd (default $100; each row's value_usd lets you filter further). position is the wallet's tracked buys / sells of THIS token: bought_usd, sold_usd, realized_pnl_usd, buys_count, sells_count, pct_of_peak_held (0-1 of its largest tracked bag still held), first_buy_at, entry_known. Only trades Moby tracked: sells can exceed buys (transfers in, or buys before tracking). When entry_known is false, realized_pnl_usd and pct_of_peak_held are null (unknown, not 0); position is null when Moby never saw the wallet trade the token. KOL platform is never null: unknown plus platform_reason (not_tagged = no platform on record); distinct_kol_platforms counts the known platforms across kols, unknown excluded. Wallet quality: use get_whale_wallet_track_record(wallet_address) for a wallet's win rate and PnL. Results are capped. Raise limit or step page only if the answer is genuinely not in the first page — a large result costs context that later steps of the same task need. This is public market data about the whole market — it is NOT about the user's own wallet or holdings. Tools whose names start with get_my_ are the ones that return the user's own data.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Claim filter behind the expanded Smart Money read: one of the four exclusive tags (holding / bought / trimming / closed) or one of the read's own claims (never_sold / exited_24h / new_24h / left_7d / sat_still). Omit for everyone. | |
| page | No | 1-based page number. | |
| sort | No | Row order: value (default, largest position first) / newest (most recent first tracked buy first) / oldest (earliest first buy first) / recent_trade (latest tracked buy or sell first). | value |
| limit | No | Holders per page, 1-100. Keep it small. | |
| network | No | solana | |
| token_address | Yes | ||
| min_position_usd | No | Minimum live USD position to list or count a holder (whales, traders and KOLs). Omit for the default $100; raise it (e.g. 500) for conviction-only counts. Ignored when `tag` is set. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||