GMGN Skill Track

track kol / track smartmoney Options

| Option | Description | |--------|-------------| | --chain | Required. Chain: sol / bsc / base / eth | | --limit | Page size (1–200, default 100) | | --side | Filter by trade direction: buy / sell (client-side filter — applied locally after fetching results) |

track follow-wallet Response Fields

Top-level fields:

| Field | Description | |-------|-------------| | next_page_token | Opaque token for fetching the next page of results | | list | Array of trade records |

Each item in list contains:

| Field | Description | |-------|-------------| | id | Record ID (base64-encoded, use as cursor) | | chain | Chain name (e.g. sol) | | transaction_hash | On-chain transaction hash | | maker | Wallet address of the followed wallet | | side | Trade direction: buy or sell | | base_address | Token contract address | | quote_address | Quote token address (SOL native address for buys/sells on SOL) | | base_amount | Token quantity in smallest unit | | quote_amount | Quote token amount spent / received (e.g. SOL) | | amount_usd | Trade value in USD | | cost_usd | Same as amount_usd — USD value of this transaction leg | | buy_cost_usd | Original buy cost in USD (0 if this record is the buy itself) | | price | Token price denominated in quote token at time of trade | | price_usd | Token price in USD at time of trade | | price_now | Token current price in USD | | price_change | Price change ratio since trade time (e.g. 6.66 = +666%) | | timestamp | Unix timestamp of the trade | | is_open_or_close | 1 = full position open or close; 0 = partial add or reduce | | launchpad | Launchpad display name (e.g. Pump.fun) | | launchpad_platform | Launchpad platform identifier (e.g. Pump.fun, pump_agent) | | migrated_pool_exchange | DEX the token migrated to, if any (e.g. pump_amm); empty if not migrated | | base_token.symbol | Token ticker symbol | | base_token.logo | Token logo image URL | | base_token.hot_level | Hotness level (0 = normal, higher = trending) | | base_token.total_supply | Total token supply (string) | | base_token.token_create_time | Unix timestamp when token was created | | base_token.token_open_time | Unix timestamp when trading opened (0 if not yet migrated/opened) | | maker_info.address | Followed wallet address | | maker_info.name | Wallet display name | | maker_info.twitter_username | Twitter / X username | | maker_info.twitter_name | Twitter / X display name | | maker_info.tags | Array of wallet tags (e.g. ["kol","gmgn"]) | | maker_info.tag_rank | Map of tag → rank within that category (e.g. {"kol": 854}) | | balance_info | Wallet token balance info; null if not available |

track kol / track smartmoney Response Fields

The response is an object with a list array. Each item in list contains:

| Field | Description | |-------|-------------| | transaction_hash | On-chain transaction hash | | maker | Wallet address of the trader (KOL / Smart Money) | | side | Trade direction: buy or sell | | base_address | Token contract address | | base_token.symbol | Token ticker symbol | | base_token.launchpad | Launchpad platform (e.g. pump) | | amount_usd | Trade value in USD | | token_amount | Token quantity traded | | price_usd | Token price in USD at time of trade | | buy_cost_usd | Original buy cost in USD (0 if this record is the buy) | | is_open_or_close | 0 = position opened / added, 1 = position closed / reduced | | timestamp | Unix timestamp of the trade | | maker_info.twitter_username | KOL's Twitter username | | maker_info.tags | Wallet tags (e.g. kol, smart_degen, photon) |

Smart Money Behavior Interpretation

After receiving trade data, interpret the signals using these frameworks before presenting results. Do not just list trades — analyze what they mean.

1. Signal Strength Levels

| Level | Criteria | |-------|----------| | Weak | 1 KOL buys | | Medium | 2–3 smart money buys in the same direction, OR 1 smart money full position open | | Strong | ≥ 3 smart money wallets same direction within 30 min (cluster signal) | | Very Strong | Cluster signal + full position opens + KOL joining the same trade |

2. Reading is_open_or_close — Conviction Signals

The field has opposite meanings by sub-command:

Full position events (full open or full close) carry much stronger conviction than partial adds. A wallet opening a full new position signals high confidence. A wallet doing a full close signals they are exiting completely — treat this as a potential exit signal for that token.

3. Using price_change to Evaluate Track Record

price_change is a ratio of current price vs price at trade time:

Use this to build a mental model of a wallet's past performance before acting on their current trades.

4. Cluster Signal Detection

When multiple trades hit the same base_address in a short time window, this is a convergence signal — stronger than any single trade. To identify:

Cluster signals from smartmoney are stronger than from kol alone.

5. Red Flags in Smart Money Data

Output Format

track follow-wallet / track kol / track smartmoney — Trade Feed

Present as a reverse-chronological trade feed. Do not dump raw JSON.

{timestamp}  {side}  {base_token.symbol}  ${amount_usd}  by {maker_info.name or short address}
             [{tags}]  Price: ${price_usd}  |  Price now: ${price_now}  ({price_change}x since trade)

Group by token if multiple trades hit the same token. Highlight tokens where several followed wallets traded in the same direction within a short window (cluster signal).

For follow-wallet, also show is_open_or_close: flag full position opens/closes distinctly from partial adds/reduces.

Cluster Signal Summary

After presenting the trade feed, check for convergence signals. If ≥ 2 distinct wallets traded the same token in the same direction, display a summary block:

⚡ Convergence Signals
──────────────────────────────────────────
TOKEN_X ({short_address})
  5 smart money wallets — all BUY — $42,300 total — within 15 min
  Signal strength: STRONG
TOKEN_Y ({short_address})
  2 KOL wallets — BUY (full open) — $8,100 total
  Signal strength: MEDIUM

For STRONG signals: proceed to full token research before acting — see docs/workflow-token-research.md For MEDIUM signals: monitor and wait for more wallets to confirm before acting.

If no convergence signals are detected: output "No cluster signals detected in this result set."

To research any token surfaced by smart money activity, follow docs/workflow-token-research.md

Smart money leaderboard / wallet profiling: When the user asks "which smart money wallets are best to follow", "rank wallets by win rate", or wants to compare wallet performance — use track smartmoney to collect active wallet addresses, then batch-query their stats via gmgn-portfolio stats. Full workflow: docs/workflow-smart-money-profile.md

Daily brief: When the user asks for a market overview ("what's the market like today", "what is smart money buying today", "give me a daily brief") — combine track smartmoney + track kol with gmgn-market trending. Full workflow: docs/workflow-daily-brief.md

Safety Constraints

Notes