mirror of
https://github.com/GMGNAI/gmgn-skills.git
synced 2026-07-27 16:57:44 +00:00
docs: add 7 workflow docs and update skill/readme cross-references
New workflow docs: - workflow-token-research.md — pre-buy token due diligence - workflow-wallet-analysis.md — wallet quality assessment - workflow-smart-money-profile.md — trading style analysis and copy-trade ROI estimate - workflow-risk-warning.md — active risk monitoring (whale exit, liquidity, dev dump) - workflow-early-project-screening.md — new launchpad token screening - workflow-daily-brief.md — daily market overview - workflow-project-deep-report.md — comprehensive token analysis with scored dimensions Renamed docs for consistent workflow- prefix naming: - market-discover-opportunities.md → workflow-market-opportunities.md - token-due-diligence.md → workflow-token-due-diligence.md Updated SKILL.md files (portfolio, track, token, market, swap) with workflow cross-reference links at relevant trigger points. Updated CLAUDE.md quick decision table and workflow docs index. Added Workflow Docs section to Readme.md and Readme.zh.md. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
gumponchain
@@ -0,0 +1,162 @@
|
||||
# Daily Market Brief — Workflow
|
||||
|
||||
Use this workflow to generate a structured morning/daily overview of market conditions, smart money activity, and risk signals — without needing a specific token or wallet in mind.
|
||||
|
||||
Use this workflow when:
|
||||
- "what's the market like today?"
|
||||
- "what is smart money buying today?"
|
||||
- "daily brief" / "give me a market overview"
|
||||
- "any opportunities worth watching?"
|
||||
- "any risks I should be aware of today?"
|
||||
- User wants a broad market situational awareness update
|
||||
|
||||
---
|
||||
|
||||
## Step 1 — Market Pulse (Trending Tokens)
|
||||
|
||||
Fetch trending tokens across multiple time windows to gauge market momentum:
|
||||
|
||||
```bash
|
||||
# Short-term heat (last 1h)
|
||||
gmgn-cli market trending --chain <chain> --interval 1h \
|
||||
--order-by volume --limit 20
|
||||
|
||||
# Medium-term momentum (last 6h)
|
||||
gmgn-cli market trending --chain <chain> --interval 6h \
|
||||
--order-by volume --limit 20
|
||||
```
|
||||
|
||||
From the results, assess:
|
||||
- **Market phase:** Are top tokens mostly meme/speculation (risk-on) or utility/DeFi (risk-off)?
|
||||
- **Breadth:** Are many tokens trending or just 1–2? Broad trends = healthier market.
|
||||
- **Smart money confirmation:** Do trending tokens have non-zero `smart_degen_count`? Trending without smart money = retail-driven pump.
|
||||
- **Volume quality:** Compare `volume` vs `swaps`. High volume with low swap count = whale activity. High swaps with low volume = retail noise.
|
||||
|
||||
Key signal summary from this step:
|
||||
```
|
||||
Market Phase: Risk-on (meme dominated) / Risk-off (utility) / Mixed
|
||||
Breadth: Broad ({N} tokens trending) / Narrow (1–2 tokens dominate)
|
||||
Smart Money: Confirmed in trending / Absent (retail-driven)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Step 2 — Smart Money Activity (What Are They Buying/Selling?)
|
||||
|
||||
```bash
|
||||
# What smart money traded in the last few hours
|
||||
gmgn-cli track smartmoney --chain <chain>
|
||||
|
||||
# What KOLs are doing
|
||||
gmgn-cli track kol --chain <chain>
|
||||
```
|
||||
|
||||
From the results:
|
||||
- Group trades by direction: **net buying** vs **net selling** per token
|
||||
- Identify tokens where **multiple** smart money wallets traded the same direction (cluster signal)
|
||||
- Note `price_change` on each trade — positive = their past entries aged well (good track record lately)
|
||||
- Flag any token appearing in both smart money AND trending data — double confirmation
|
||||
|
||||
Output for this step:
|
||||
```
|
||||
Smart Money Moves (last ~2h):
|
||||
Buying: TOKEN_A ({N} wallets), TOKEN_B ({N} wallets)
|
||||
Selling: TOKEN_C ({N} wallets)
|
||||
Notable: TOKEN_A appears in both trending AND smart money buys → strong signal
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Step 3 — New Token Watch (Early Opportunities)
|
||||
|
||||
```bash
|
||||
# Tokens near graduation — imminent DEX listing
|
||||
gmgn-cli market trenches --chain <chain> --type near_completion
|
||||
|
||||
# Recently graduated tokens — fresh DEX liquidity
|
||||
gmgn-cli market trenches --chain <chain> --type completed
|
||||
```
|
||||
|
||||
Quick filter: from results, surface tokens with:
|
||||
- `smart_degen_count` ≥ 1
|
||||
- `rug_ratio` < 0.2
|
||||
- Non-zero `volume` and `swaps`
|
||||
|
||||
List up to 3 tokens that pass this quick filter as "early watch" candidates.
|
||||
|
||||
---
|
||||
|
||||
## Step 4 — Risk Scan (Anything to Avoid Today?)
|
||||
|
||||
For any tokens the user currently holds (if known), or for the top tokens from steps 1–2:
|
||||
|
||||
```bash
|
||||
gmgn-cli token security --chain <chain> --address <token_address>
|
||||
```
|
||||
|
||||
Flag immediately if any held/watched token shows:
|
||||
- `rug_ratio` increase (compare to prior knowledge)
|
||||
- `top_10_holder_rate` > 0.5
|
||||
- `creator_token_status` = `creator_hold` (dev still in)
|
||||
- `is_wash_trading` = `true`
|
||||
|
||||
If no specific tokens to check, skip this step and note it in the brief.
|
||||
|
||||
---
|
||||
|
||||
## Daily Brief Output
|
||||
|
||||
```
|
||||
═══════════════════════════════════════════
|
||||
DAILY MARKET BRIEF — {chain} — {date}
|
||||
═══════════════════════════════════════════
|
||||
|
||||
📊 MARKET PULSE
|
||||
Phase: Risk-on / Risk-off / Mixed
|
||||
Breadth: {N} tokens trending (broad/narrow)
|
||||
Top movers: TOKEN_A (+X%), TOKEN_B (+X%), TOKEN_C (+X%)
|
||||
Smart money: Present in trending ✅ / Absent (retail-driven) ⚠️
|
||||
|
||||
🧠 SMART MONEY MOVES
|
||||
Buying:
|
||||
• TOKEN_A — {N} wallets accumulating, avg price_change +{X}%
|
||||
• TOKEN_B — {N} wallets, fresh entry
|
||||
Selling:
|
||||
• TOKEN_C — {N} wallets reducing positions
|
||||
Cluster signal: TOKEN_A (trending + smart money overlap) 🔥
|
||||
|
||||
🌱 EARLY WATCH
|
||||
• TOKEN_X — near graduation, {N} smart degens in, rug_ratio {X}
|
||||
• TOKEN_Y — just graduated, strong volume, clean security
|
||||
(Run /gmgn-token → workflow-early-project-screening for deeper check)
|
||||
|
||||
⚠️ RISK SIGNALS
|
||||
• No active warnings detected
|
||||
OR
|
||||
• TOKEN_Z: whale concentration rising (top_10 = {X}%), monitor closely
|
||||
|
||||
─── SUGGESTED ACTIONS ─────────────────────
|
||||
Opportunity: TOKEN_A worth researching → run full token research
|
||||
Caution: TOKEN_C seeing smart money exits → tighten stop
|
||||
New entry: TOKEN_X early screening recommended
|
||||
═══════════════════════════════════════════
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Follow-Up Actions
|
||||
|
||||
From the brief, typical next steps:
|
||||
- **Deep dive on an opportunity** → [`workflow-token-research.md`](workflow-token-research.md)
|
||||
- **Screen early tokens further** → [`workflow-early-project-screening.md`](workflow-early-project-screening.md)
|
||||
- **Check a specific wallet that showed up** → [`workflow-smart-money-profile.md`](workflow-smart-money-profile.md)
|
||||
- **Risk check on a held position** → [`workflow-risk-warning.md`](workflow-risk-warning.md)
|
||||
- **Execute a trade** → use `gmgn-swap` skill
|
||||
|
||||
---
|
||||
|
||||
## Related Workflows
|
||||
|
||||
- [`workflow-market-opportunities.md`](workflow-market-opportunities.md) — focused opportunity discovery from trending
|
||||
- [`workflow-early-project-screening.md`](workflow-early-project-screening.md) — detailed new token screening
|
||||
- [`workflow-risk-warning.md`](workflow-risk-warning.md) — active risk monitoring
|
||||
@@ -0,0 +1,155 @@
|
||||
# Early Project Screening — Workflow
|
||||
|
||||
Use this workflow to rapidly screen newly launched tokens from launchpads and identify whether any are worth a closer look, before committing to a full token research deep dive.
|
||||
|
||||
Use this workflow when:
|
||||
- "early project screening" / "are any new tokens worth accumulating?"
|
||||
- "screen the latest launched tokens for me"
|
||||
- "which new tokens have smart money entering early?"
|
||||
- "any new tokens on pump.fun worth watching?"
|
||||
- User wants to filter new launchpad tokens for quality signals before buying
|
||||
|
||||
---
|
||||
|
||||
## Step 1 — Fetch Newly Launched Tokens
|
||||
|
||||
```bash
|
||||
# Tokens just created, still on bonding curve
|
||||
gmgn-cli market trenches --chain <chain> --type new_creation
|
||||
|
||||
# Tokens near bonding curve completion (about to graduate to DEX)
|
||||
gmgn-cli market trenches --chain <chain> --type near_completion
|
||||
|
||||
# Tokens that have already graduated to open market
|
||||
gmgn-cli market trenches --chain <chain> --type completed
|
||||
```
|
||||
|
||||
**Which type to use:**
|
||||
- `new_creation` — highest upside potential, highest risk. Many will fail.
|
||||
- `near_completion` — approaching graduation, momentum building. Tighter window.
|
||||
- `completed` — already trading on DEX, more liquidity but earlier gains may be gone.
|
||||
|
||||
From the results, note each token's `address`, `symbol`, `smart_degen_count`, `renowned_count`, `volume`, `swaps`, and `rug_ratio`.
|
||||
|
||||
---
|
||||
|
||||
## Step 2 — First-Pass Filter (In-Response Scan)
|
||||
|
||||
Before running any CLI commands per token, apply a quick in-response filter on the trenches results:
|
||||
|
||||
**Discard immediately if:**
|
||||
- `rug_ratio` > 0.3
|
||||
- `is_wash_trading` = `true`
|
||||
- `bundler_rate` > 0.3
|
||||
- `rat_trader_amount_rate` > 0.3
|
||||
- Zero `smart_degen_count` AND zero `renowned_count` AND volume < $10k
|
||||
|
||||
**Keep for deeper screening if any of:**
|
||||
- `smart_degen_count` ≥ 1 (smart money has entered)
|
||||
- `renowned_count` ≥ 1 (KOL has entered)
|
||||
- `bluechip_owner_percentage` > 0 (quality wallet base)
|
||||
- `volume` is strong relative to token age
|
||||
|
||||
Select up to **5 tokens** that pass this filter.
|
||||
|
||||
---
|
||||
|
||||
## Step 3 — Security Check (Per Token)
|
||||
|
||||
For each shortlisted token:
|
||||
|
||||
```bash
|
||||
gmgn-cli token security --chain <chain> --address <token_address>
|
||||
```
|
||||
|
||||
Hard stops — discard token immediately if:
|
||||
|
||||
| Field | Hard Stop |
|
||||
|-------|-----------|
|
||||
| `is_honeypot` | `"yes"` (BSC/Base) |
|
||||
| `renounced_mint` (SOL) | `false` |
|
||||
| `renounced_freeze_account` (SOL) | `false` |
|
||||
| `rug_ratio` | `> 0.3` |
|
||||
| `sell_tax` | `> 0.10` |
|
||||
| `top_10_holder_rate` | `> 0.6` |
|
||||
|
||||
Proceed with tokens that pass all hard stops.
|
||||
|
||||
---
|
||||
|
||||
## Step 4 — Smart Money Early Entry Check
|
||||
|
||||
```bash
|
||||
# Who's already in? (smart money holders)
|
||||
gmgn-cli token holders --chain <chain> --address <token_address> \
|
||||
--tag smart_degen --order-by buy_volume_cur --direction desc --limit 10
|
||||
|
||||
# Top traders — any known wallets?
|
||||
gmgn-cli token traders --chain <chain> --address <token_address> \
|
||||
--order-by profit --direction desc --limit 10
|
||||
```
|
||||
|
||||
Strong signal:
|
||||
- Smart money wallets entered **early** (check `buy_30m` / `buy_1h` counts on the holder — or cross-reference `last_active_timestamp` being recent)
|
||||
- Multiple distinct smart money wallets (not one large wallet — that's concentration risk)
|
||||
- Top traders show profit (token has already rewarded early holders, positive momentum)
|
||||
|
||||
Weak signal:
|
||||
- Only one smart money wallet in
|
||||
- Smart money wallet entered but `profit` is negative (they're underwater)
|
||||
|
||||
---
|
||||
|
||||
## Step 5 — Token Info Spot Check
|
||||
|
||||
```bash
|
||||
gmgn-cli token info --chain <chain> --address <token_address>
|
||||
```
|
||||
|
||||
Check:
|
||||
- Social presence: `link.twitter_username`, `link.telegram`, `link.website` — at least one should exist
|
||||
- `holder_count` — growing is a positive sign
|
||||
- `wallet_tags_stat.smart_wallets` — confirms smart money count
|
||||
- `cto_flag` — if `1`, community has taken over, dev is gone (neutral to positive, evaluate context)
|
||||
- `creator_token_status` — `creator_close` means dev has sold (mixed: reduces dump risk, but also less team commitment for very new tokens)
|
||||
|
||||
---
|
||||
|
||||
## Screening Output
|
||||
|
||||
Present results as a table, then a per-token verdict:
|
||||
|
||||
```
|
||||
Early Project Screening — {chain} / {type}
|
||||
Screened: {N} tokens from trenches → {M} passed filter
|
||||
|
||||
# | Symbol | Address (short) | Smart Degens | Rug Risk | Security | Verdict
|
||||
1 | ... | ... | {N} wallets | {X} | ✅/⚠️/🚫 | Watch / Small position / Skip
|
||||
...
|
||||
|
||||
─── Top Pick ───────────────────────────────
|
||||
{SYMBOL}: Smart money in early, security clean, social present
|
||||
→ Suggested action: Small exploratory position / Watch for 1h / Skip
|
||||
```
|
||||
|
||||
**Verdict scale:**
|
||||
- 🟢 **Small position** — clean security + smart money early entry + social presence
|
||||
- 🟡 **Watch** — some positive signals but missing key indicators; monitor for 30–60 min
|
||||
- 🔴 **Skip** — any hard stop triggered, or no smart money interest at all
|
||||
|
||||
---
|
||||
|
||||
## Follow-Up Actions
|
||||
|
||||
For any token rated 🟢:
|
||||
- Run full due diligence: [`workflow-token-research.md`](workflow-token-research.md)
|
||||
- Check risk warnings before sizing up: [`workflow-risk-warning.md`](workflow-risk-warning.md)
|
||||
- Execute swap if satisfied: use `gmgn-swap` skill
|
||||
|
||||
---
|
||||
|
||||
## Related Workflows
|
||||
|
||||
- [`workflow-token-research.md`](workflow-token-research.md) — full 5-step token analysis
|
||||
- [`workflow-risk-warning.md`](workflow-risk-warning.md) — ongoing risk monitoring for held positions
|
||||
- [`workflow-market-opportunities.md`](workflow-market-opportunities.md) — trending token discovery (graduated tokens with volume)
|
||||
@@ -44,5 +44,5 @@ Top 5 Trending Tokens — SOL / 1h
|
||||
## Step 4 — Follow-up actions
|
||||
|
||||
For each token, offer:
|
||||
- **Deep dive**: `token info` + `token security` for full due diligence (see [token-due-diligence.md](token-due-diligence.md))
|
||||
- **Deep dive**: run full token research workflow — see [workflow-token-research.md](workflow-token-research.md)
|
||||
- **Swap**: execute directly if the user is satisfied with the trending data alone
|
||||
@@ -0,0 +1,224 @@
|
||||
# Project Deep Report — Comprehensive Token Analysis Workflow
|
||||
|
||||
Use this workflow when the user wants a thorough, multi-dimensional project analysis — going beyond basic due diligence to cover smart money conviction, holder quality, market positioning, and a final investment verdict.
|
||||
|
||||
Use this workflow when:
|
||||
- "give me a full analysis of this project"
|
||||
- "deep report" / "is this project worth a large position?"
|
||||
- "give me a complete investment research report"
|
||||
- User wants more than a quick check — they want a structured report before making a significant position decision
|
||||
|
||||
> For a quick pre-buy check, use [`workflow-token-research.md`](workflow-token-research.md) instead. This workflow is more comprehensive and produces a full written report.
|
||||
|
||||
---
|
||||
|
||||
## Step 1 — Fundamentals
|
||||
|
||||
```bash
|
||||
gmgn-cli token info --chain <chain> --address <token_address>
|
||||
```
|
||||
|
||||
Extract and assess:
|
||||
|
||||
| Field | What to Note |
|
||||
|-------|-------------|
|
||||
| `price` | Current price |
|
||||
| Market cap | `price × circulating_supply` — compute this manually |
|
||||
| `liquidity` | USD in pool — < $50k is thin for a "serious" position |
|
||||
| `holder_count` | Total wallets holding. Growing = organic adoption |
|
||||
| `wallet_tags_stat.smart_wallets` | Smart money holders count |
|
||||
| `wallet_tags_stat.renowned_wallets` | KOL holders count |
|
||||
| `link.*` | Social presence: Twitter, Telegram, website |
|
||||
| `cto_flag` | Community takeover? |
|
||||
| `creator_token_status` | Dev still holding or has sold? |
|
||||
|
||||
**Fundamental score (0–3):**
|
||||
- +1 if market cap reasonable for the chain/category
|
||||
- +1 if strong social presence (2+ active channels)
|
||||
- +1 if `smart_wallets` ≥ 3 AND `holder_count` growing
|
||||
|
||||
---
|
||||
|
||||
## Step 2 — Security Assessment
|
||||
|
||||
```bash
|
||||
gmgn-cli token security --chain <chain> --address <token_address>
|
||||
```
|
||||
|
||||
**Hard stops (any one = do not proceed):**
|
||||
- `is_honeypot = "yes"` (BSC/Base)
|
||||
- `rug_ratio > 0.5`
|
||||
- `renounced_mint = false` AND `renounced_freeze_account = false` (SOL) — both unrenounced
|
||||
- `sell_tax > 0.15`
|
||||
|
||||
**Security score (0–4):**
|
||||
- +1 if contract open source / renounced
|
||||
- +1 if `rug_ratio < 0.1`
|
||||
- +1 if `top_10_holder_rate < 0.3`
|
||||
- +1 if no snipers (`sniper_count < 5`) and no wash trading
|
||||
|
||||
---
|
||||
|
||||
## Step 3 — Liquidity and Pool Health
|
||||
|
||||
```bash
|
||||
gmgn-cli token pool --chain <chain> --address <token_address>
|
||||
```
|
||||
|
||||
Assess:
|
||||
- **Liquidity depth:** > $100k = healthy; $10k–$100k = thin; < $10k = high exit slippage
|
||||
- **Pool age:** older pool = more stable price history
|
||||
- **DEX:** recognized exchange (Raydium, Uniswap v3, PancakeSwap) = better
|
||||
- **Bonding curve status** (`is_on_curve`): if still on curve, token has not graduated — higher volatility window
|
||||
|
||||
**Liquidity score (0–2):**
|
||||
- +1 if liquidity > $50k
|
||||
- +1 if DEX is major and pool age > 24h
|
||||
|
||||
---
|
||||
|
||||
## Step 4 — Smart Money Conviction Analysis
|
||||
|
||||
This is the key differentiator from basic token research.
|
||||
|
||||
```bash
|
||||
# Smart money holders — are they accumulating or distributing?
|
||||
gmgn-cli token holders --chain <chain> --address <token_address> \
|
||||
--tag smart_degen --order-by buy_volume_cur --direction desc --limit 20
|
||||
|
||||
# KOL holders
|
||||
gmgn-cli token traders --chain <chain> --address <token_address> \
|
||||
--tag renowned --order-by profit --direction desc --limit 10
|
||||
|
||||
# Top holders overall — check concentration
|
||||
gmgn-cli token holders --chain <chain> --address <token_address> \
|
||||
--order-by amount_percentage --direction desc --limit 20
|
||||
```
|
||||
|
||||
Assess smart money conviction:
|
||||
|
||||
| Signal | Bullish | Bearish |
|
||||
|--------|---------|---------|
|
||||
| Smart money count | ≥ 3 distinct wallets | 0 or 1 |
|
||||
| Net direction | `buy_volume_cur` > `sell_volume_cur` | Selling exceeds buying |
|
||||
| Unrealized profit | Large (still holding, not selling) | Small or negative |
|
||||
| Realized profit | Moderate (some took profit, healthy) | Very large (majority already exited) |
|
||||
| KOL involvement | ≥ 1 KOL with active position | None |
|
||||
| Wallet diversity | Multiple different wallets | One whale dominating |
|
||||
|
||||
**Smart money score (0–4):**
|
||||
- +1 if `smart_wallets` ≥ 3
|
||||
- +1 if net buy direction (buy_volume_cur > sell_volume_cur across smart wallets)
|
||||
- +1 if average `unrealized_profit` is positive (they're still in profit, still holding)
|
||||
- +1 if at least 1 KOL has an active position
|
||||
|
||||
---
|
||||
|
||||
## Step 5 — Price Action Context
|
||||
|
||||
```bash
|
||||
# Recent price action — 4h candles, last 3 days
|
||||
gmgn-cli market kline --chain <chain> --address <token_address> \
|
||||
--resolution 4h
|
||||
|
||||
# Is it currently trending?
|
||||
gmgn-cli market trending --chain <chain> --interval 1h \
|
||||
--order-by volume --limit 100 --raw | jq '.data.rank[] | select(.address == "<token_address>")'
|
||||
```
|
||||
|
||||
Look for:
|
||||
- **Entry context:** Is price near a local bottom (potential value) or after a run-up (chasing)?
|
||||
- **Volume confirmation:** Do bullish candles have higher volume than bearish candles?
|
||||
- **Trending:** If it appears in trending with `smart_degen_count > 0`, momentum + conviction overlap
|
||||
|
||||
**Price action score (0–2):**
|
||||
- +1 if price is not parabolic (< 5x from recent low) — not chasing
|
||||
- +1 if volume is rising on up-candles (healthy accumulation pattern)
|
||||
|
||||
---
|
||||
|
||||
## Step 6 — Risk Factors Summary
|
||||
|
||||
Aggregate all warning signals from Steps 1–5:
|
||||
|
||||
| Category | Risk Level | Key Signals |
|
||||
|----------|-----------|-------------|
|
||||
| Security | ✅/⚠️/🚫 | honeypot, rug_ratio, concentration |
|
||||
| Liquidity | ✅/⚠️/🚫 | pool size, pool age |
|
||||
| Smart Money | ✅/⚠️/🚫 | count, direction, conviction |
|
||||
| Holder Quality | ✅/⚠️/🚫 | bundler_rate, rat_trader_rate, wash_trading |
|
||||
| Price Action | ✅/⚠️/🚫 | entry timing, momentum |
|
||||
|
||||
---
|
||||
|
||||
## Deep Report Output
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════╗
|
||||
║ PROJECT DEEP REPORT — {SYMBOL} ║
|
||||
║ {chain} | {short_address} | {date} ║
|
||||
╚══════════════════════════════════════════════════════╝
|
||||
|
||||
📋 FUNDAMENTALS
|
||||
Price: ${price}
|
||||
Market Cap: ~${market_cap}
|
||||
Liquidity: ${liquidity} on {exchange}
|
||||
Holders: {holder_count}
|
||||
Social: Twitter ✅/❌ | Telegram ✅/❌ | Website ✅/❌
|
||||
Dev Status: {creator_close = sold ✅ / creator_hold = still in ⚠️}
|
||||
Fundamental Score: {X}/3
|
||||
|
||||
🔒 SECURITY
|
||||
Honeypot: ✅ No / 🚫 YES
|
||||
Contract: {open_source} | {renounced}
|
||||
Rug Risk: {rug_ratio} → ✅/⚠️/🚫
|
||||
Concentration: Top-10 hold {top_10_holder_rate%} → ✅/⚠️/🚫
|
||||
Wash Trading: ✅ None / ⚠️ Detected
|
||||
Security Score: {X}/4
|
||||
|
||||
💧 LIQUIDITY
|
||||
Pool: ${liquidity} | {exchange} | Age: {pool_age}
|
||||
Bonding Curve: Graduated ✅ / Still on curve ⚠️
|
||||
Liquidity Score: {X}/2
|
||||
|
||||
🧠 SMART MONEY CONVICTION
|
||||
SM Holders: {N} wallets
|
||||
Net Direction: Accumulating ✅ / Distributing ⚠️ / Mixed
|
||||
SM Unrealized: +{X}% avg (still holding) ✅ / Underwater ⚠️
|
||||
KOL Presence: {N} KOL wallets active
|
||||
Smart Money Score: {X}/4
|
||||
|
||||
📈 PRICE ACTION
|
||||
Recent trend: Healthy accumulation / Parabolic (avoid chasing) / Declining
|
||||
Trending now: Yes (rank #{rank}) ✅ / Not trending
|
||||
Price Action Score: {X}/2
|
||||
|
||||
─── RISK FLAGS ──────────────────────────────────────
|
||||
{List any ⚠️ or 🚫 signals here, or "No major risk flags"}
|
||||
|
||||
─── TOTAL SCORE ─────────────────────────────────────
|
||||
{X} / 15
|
||||
|
||||
─── VERDICT ─────────────────────────────────────────
|
||||
🟢 STRONG BUY CANDIDATE (score ≥ 11, no hard stops)
|
||||
Smart money confirmed, clean security, healthy liquidity
|
||||
→ Suggested: research position sizing, use gmgn-swap
|
||||
|
||||
🟡 WATCHLIST (score 7–10, no hard stops)
|
||||
Some positive signals but missing key conviction indicators
|
||||
→ Suggested: monitor for 24–48h, re-assess if SM increases
|
||||
|
||||
🔴 SKIP (any hard stop OR score < 7)
|
||||
Risk factors outweigh opportunity
|
||||
→ Reason: {specific flag}
|
||||
╚══════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Related Workflows
|
||||
|
||||
- [`workflow-token-research.md`](workflow-token-research.md) — faster pre-buy check (use when time-sensitive)
|
||||
- [`workflow-risk-warning.md`](workflow-risk-warning.md) — ongoing monitoring after entering a position
|
||||
- [`workflow-smart-money-profile.md`](workflow-smart-money-profile.md) — deep dive on specific smart money wallets holding this token
|
||||
- [`workflow-market-opportunities.md`](workflow-market-opportunities.md) — find tokens to run this report on
|
||||
@@ -0,0 +1,142 @@
|
||||
# Risk Warning — Structured Checklist Workflow
|
||||
|
||||
Use this workflow to assess whether a token currently held or being considered shows active risk signals: whale exit, liquidity drain, or developer dump.
|
||||
|
||||
Use this workflow when:
|
||||
- "are any whales dumping this token?"
|
||||
- "is the liquidity still healthy?"
|
||||
- "are there any signs the developer is exiting?"
|
||||
- "risk warning" / "is this project still safe to hold?"
|
||||
- User wants to check if a held position is turning dangerous
|
||||
|
||||
---
|
||||
|
||||
## Step 1 — Token Security Snapshot
|
||||
|
||||
```bash
|
||||
gmgn-cli token security --chain <chain> --address <token_address>
|
||||
```
|
||||
|
||||
Immediate red flags (any one triggers danger):
|
||||
|
||||
| Field | Danger Signal |
|
||||
|-------|--------------|
|
||||
| `is_honeypot` | `"yes"` → sells are blocked, exit impossible (BSC/Base only) |
|
||||
| `rug_ratio` | `> 0.3` → high rug pull probability |
|
||||
| `top_10_holder_rate` | `> 0.5` → extreme concentration, whale exit risk |
|
||||
| `creator_token_status` | `creator_hold` → dev still holds, dump risk active |
|
||||
| `renounced_mint` (SOL) | `false` → dev can inflate supply at any time |
|
||||
| `renounced_freeze_account` (SOL) | `false` → dev can freeze wallets |
|
||||
| `sell_tax` | `> 0.10` → exit penalty is severe |
|
||||
| `bundler_rate` | `> 0.3` → heavily bot-bundled at launch, artificial price support |
|
||||
| `rat_trader_amount_rate` | `> 0.3` → insider trading detected |
|
||||
| `is_wash_trading` | `true` → volume is fake |
|
||||
|
||||
---
|
||||
|
||||
## Step 2 — Liquidity Check
|
||||
|
||||
```bash
|
||||
gmgn-cli token pool --chain <chain> --address <token_address>
|
||||
```
|
||||
|
||||
Check for liquidity drain:
|
||||
|
||||
- **Current liquidity (USD):** < $10k = extreme exit slippage risk
|
||||
- **Liquidity vs earlier baseline:** if you have a prior reading, compare. A drop of > 30% in a short period is a warning signal.
|
||||
- **Pool age (`creation_timestamp`):** very new pools (< 1h) combined with other risk signals = high risk.
|
||||
- **DEX (`exchange`):** verify it's a known DEX (Raydium, Uniswap, PancakeSwap). Unknown or single-sided pools are suspicious.
|
||||
|
||||
---
|
||||
|
||||
## Step 3 — Whale Holder Analysis
|
||||
|
||||
```bash
|
||||
# Top holders by supply percentage
|
||||
gmgn-cli token holders --chain <chain> --address <token_address> \
|
||||
--order-by amount_percentage --direction desc --limit 20
|
||||
|
||||
# Smart money holders — are they still in?
|
||||
gmgn-cli token holders --chain <chain> --address <token_address> \
|
||||
--tag smart_degen --order-by amount_percentage --direction desc --limit 20
|
||||
```
|
||||
|
||||
Warning signals:
|
||||
|
||||
- **Concentration:** top 1–3 wallets hold > 20% combined → single exit can crash price
|
||||
- **Smart money exodus:** zero or declining `smart_degen` holders = conviction leaving
|
||||
- **Wallet tags:** wallets tagged `bundler` or `rat_trader` in top holders = insider concentration risk
|
||||
|
||||
---
|
||||
|
||||
## Step 4 — Recent Trade Flow (Smart Money Direction)
|
||||
|
||||
```bash
|
||||
gmgn-cli track smartmoney --chain <chain>
|
||||
```
|
||||
|
||||
Filter results for the token address in question. Check:
|
||||
|
||||
- Are smart money wallets **selling** this token recently? (`is_open_or_close` = 1 on sell side for kol/smartmoney)
|
||||
- Is `price_change` on recent smart money buys negative? (their entry is underwater — they may exit)
|
||||
- Cluster of sells from multiple tracked wallets = strong exit signal
|
||||
|
||||
---
|
||||
|
||||
## Step 5 — Price and Volume Anomaly (K-line)
|
||||
|
||||
```bash
|
||||
gmgn-cli market kline --chain <chain> --address <token_address> \
|
||||
--resolution 1h
|
||||
```
|
||||
|
||||
Look for:
|
||||
|
||||
- **Volume spike without price increase** — selling pressure absorbing buy volume
|
||||
- **Price drop with volume spike** — active dump in progress
|
||||
- **Volume collapse** — liquidity evaporating, exit windows closing
|
||||
- **Consecutive red candles after ATH** — distribution phase
|
||||
|
||||
---
|
||||
|
||||
## Risk Summary Output
|
||||
|
||||
After running all steps, output a structured risk verdict:
|
||||
|
||||
```
|
||||
Risk Assessment: {TOKEN_SYMBOL} ({short_address})
|
||||
Chain: {chain} | Checked: {timestamp}
|
||||
|
||||
─── Security ───────────────────────────────
|
||||
Honeypot: ✅ No / 🚫 YES — exit blocked
|
||||
Rug ratio: ✅ {X} / ⚠️ {X} / 🚫 {X} (> 0.3 danger)
|
||||
Mint renounced: ✅ Yes / 🚫 No
|
||||
Dev holding: ✅ Sold / 🚫 Still holding — dump risk
|
||||
|
||||
─── Liquidity ──────────────────────────────
|
||||
Current liquidity: ${X} [✅ healthy / ⚠️ low / 🚫 critical]
|
||||
Pool age: {X} hours/days
|
||||
|
||||
─── Whale Concentration ────────────────────
|
||||
Top 10 hold rate: {X}% [✅ < 20% / ⚠️ 20–50% / 🚫 > 50%]
|
||||
Smart money holders: {N} wallets still in
|
||||
|
||||
─── Smart Money Flow ───────────────────────
|
||||
Recent smart money: Buying ✅ / Mixed ⚠️ / Selling 🚫
|
||||
|
||||
─── Price Action ───────────────────────────
|
||||
1h volume trend: Normal / Spike (selling pressure) / Collapsing
|
||||
Recent candles: Accumulation / Distribution / Neutral
|
||||
|
||||
─── Overall Verdict ────────────────────────
|
||||
🟢 No active risk signals — position appears stable
|
||||
🟡 Watch closely — 1–2 warning signals present, monitor daily
|
||||
🔴 HIGH RISK — multiple danger signals, consider exiting
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Related Workflows
|
||||
|
||||
- [`workflow-token-research.md`](workflow-token-research.md) — full pre-buy due diligence
|
||||
- [`workflow-project-deep-report.md`](workflow-project-deep-report.md) — comprehensive project analysis
|
||||
@@ -0,0 +1,169 @@
|
||||
# Smart Money Profile — Behavior Analysis Workflow
|
||||
|
||||
When a user wants to understand a wallet's trading behavior in depth: what style they trade, when they take profit, when they cut losses, and whether copying them would be profitable.
|
||||
|
||||
Use this workflow when:
|
||||
- "is this wallet a long-term holder or a short-term trader?"
|
||||
- "what is this wallet's win rate, when does it take profit or cut losses?"
|
||||
- "if I copied this wallet, what would my return be?"
|
||||
- "smart money leaderboard, which wallets are most worth following?"
|
||||
- User provides a wallet address and asks about trading style or copy-trade potential
|
||||
|
||||
> For basic "is this wallet worth following" analysis, see [`workflow-wallet-analysis.md`](workflow-wallet-analysis.md). This workflow goes deeper into behavior patterns and copy-trade estimation.
|
||||
|
||||
---
|
||||
|
||||
## Step 1 — Trading Stats (Both Periods)
|
||||
|
||||
Run stats for both 7d and 30d to detect performance trends:
|
||||
|
||||
```bash
|
||||
gmgn-cli portfolio stats --chain <chain> --wallet <address> --period 7d
|
||||
gmgn-cli portfolio stats --chain <chain> --wallet <address> --period 30d
|
||||
```
|
||||
|
||||
Key metrics:
|
||||
|
||||
| Field | Meaning | Threshold |
|
||||
|-------|---------|-----------|
|
||||
| `winrate` | % of profitable trades (0–1) | > 0.6 strong, > 0.5 acceptable |
|
||||
| `pnl` | realized_profit / total_cost multiplier | > 1.0 = net positive |
|
||||
| `realized_profit` | USD profit locked in | context-dependent |
|
||||
| `buy_count` / `sell_count` | trading frequency | high = active trader |
|
||||
| `token_num` | number of distinct tokens traded | high = diversified |
|
||||
|
||||
**Trend signal:** If 7d `winrate` is significantly higher than 30d, performance is improving. If lower, recent form is declining.
|
||||
|
||||
---
|
||||
|
||||
## Step 2 — Activity Analysis (Style Inference)
|
||||
|
||||
```bash
|
||||
gmgn-cli portfolio activity --chain <chain> --wallet <address> --limit 100
|
||||
```
|
||||
|
||||
For each token that appears in both a buy and a sell event, compute holding duration:
|
||||
- `sell.timestamp - buy.timestamp` in hours
|
||||
|
||||
**Style classification:**
|
||||
|
||||
| Holding Duration | Style Label |
|
||||
|-----------------|-------------|
|
||||
| < 1 hour | Scalper |
|
||||
| 1h – 24h | Day trader |
|
||||
| 1d – 7d | Swing trader |
|
||||
| > 7d | Position / long-term holder |
|
||||
|
||||
Also check:
|
||||
- **Position sizing consistency** — are buy amounts roughly similar (disciplined) or highly variable?
|
||||
- **Token concentration** — does the wallet repeatedly trade the same tokens (specialist) or always new ones (trend chaser)?
|
||||
- **Sell behavior** — do sells follow a pattern (e.g., always sells after 2–3x, or cuts at -30%)?
|
||||
|
||||
---
|
||||
|
||||
## Step 3 — Take-Profit and Stop-Loss Pattern
|
||||
|
||||
From `portfolio activity`, cross-reference buy price vs sell price for completed round trips:
|
||||
|
||||
- For each token: find a `buy` event followed by a `sell` event
|
||||
- Compute approximate return: `(sell_total_usd - buy_total_usd) / buy_total_usd`
|
||||
- Group outcomes: wins vs losses
|
||||
|
||||
Look for:
|
||||
- **Typical gain at exit** — does the wallet consistently take profit at ~2x, ~5x, or higher?
|
||||
- **Typical loss at cut** — does the wallet cut quickly at -20% or hold through large drawdowns?
|
||||
- **Asymmetry** — wins larger than losses = positive expected value. Reverse = risk.
|
||||
|
||||
---
|
||||
|
||||
## Step 4 — Copy-Trade ROI Estimation (Approximate)
|
||||
|
||||
> **Note:** This is an approximation based on historical activity data, not a precise backtest.
|
||||
|
||||
For the wallet's last 20–30 completed trades (round-trip buys + sells):
|
||||
|
||||
1. List all buy events: token, amount_usd, timestamp
|
||||
2. List all sell events for the same tokens
|
||||
3. Compute per-trade return: `(sell_usd - buy_usd) / buy_usd`
|
||||
4. Average the returns
|
||||
|
||||
**If you want to estimate "if I had followed today":**
|
||||
For still-open positions (buy with no matching sell), use `portfolio holdings` to get current `usd_value` vs `cost`, computing unrealized return.
|
||||
|
||||
Present as:
|
||||
```
|
||||
Copy-trade estimate (last 30d completed trades):
|
||||
Avg return per trade: +X%
|
||||
Win rate: X / Y trades profitable
|
||||
Best trade: +X% on TOKEN
|
||||
Worst trade: -X% on TOKEN
|
||||
Approximate 30d return if equal-weight copy: ~X%
|
||||
⚠️ This is an approximation. Actual results depend on entry timing, slippage, and fees.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Step 5 — Smart Money Leaderboard (Multi-Wallet Comparison)
|
||||
|
||||
When the user wants to compare multiple smart money wallets:
|
||||
|
||||
```bash
|
||||
# Batch stats — compare up to 10 wallets at once
|
||||
gmgn-cli portfolio stats --chain <chain> \
|
||||
--wallet <addr1> --wallet <addr2> --wallet <addr3> \
|
||||
--period 30d
|
||||
```
|
||||
|
||||
Rank wallets by composite score. Suggested weights:
|
||||
- `winrate` × 40%
|
||||
- `pnl` × 40%
|
||||
- `token_num` (diversity) × 10%
|
||||
- Recency (7d winrate vs 30d winrate improvement) × 10%
|
||||
|
||||
To discover active smart money wallets to compare, first run:
|
||||
```bash
|
||||
gmgn-cli track smartmoney --chain <chain>
|
||||
```
|
||||
Extract unique wallet addresses from the results, then batch-query their stats.
|
||||
|
||||
---
|
||||
|
||||
## Output Template
|
||||
|
||||
```
|
||||
Smart Money Profile: {short_address}
|
||||
Chain: {chain} | Data: 7d + 30d
|
||||
|
||||
─── Performance ────────────────────────────
|
||||
Win Rate (7d / 30d): {X}% / {X}% [trend: ↑ improving / ↓ declining / → stable]
|
||||
PnL Ratio (30d): {X}x
|
||||
Realized Profit (30d): ${X}
|
||||
|
||||
─── Trading Style ──────────────────────────
|
||||
Style: Scalper / Day trader / Swing trader / Long-term holder
|
||||
Avg Hold Time: ~{X} hours / days
|
||||
Position Size: Consistent (disciplined) / Variable (opportunistic)
|
||||
Token Focus: Specialist (repeats tokens) / Trend chaser (always new)
|
||||
|
||||
─── Exit Behavior ──────────────────────────
|
||||
Typical take-profit: ~+{X}% gain
|
||||
Typical stop-loss: ~-{X}% loss
|
||||
Win/loss ratio: {avg_win}x / {avg_loss}x
|
||||
|
||||
─── Copy-Trade Estimate ────────────────────
|
||||
Approx. 30d return if copied: ~{X}%
|
||||
Based on {N} completed trades
|
||||
⚠️ Approximation only
|
||||
|
||||
─── Verdict ────────────────────────────────
|
||||
🟢 High-conviction follow — strong stats, consistent style, favorable exit pattern
|
||||
🟡 Selective follow — good stats but inconsistent or high-risk behavior
|
||||
🔴 Avoid copying — low win rate, poor exit discipline, or declining form
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Related Workflows
|
||||
|
||||
- [`workflow-wallet-analysis.md`](workflow-wallet-analysis.md) — general wallet quality assessment
|
||||
- [`workflow-token-research.md`](workflow-token-research.md) — deep dive on tokens this wallet holds
|
||||
@@ -0,0 +1,109 @@
|
||||
# New Token Research — Full Workflow
|
||||
|
||||
When a user provides a token address or name and wants to know if it's worth researching or buying, run this full workflow in sequence.
|
||||
|
||||
## Step 1 — Basic Info
|
||||
|
||||
```bash
|
||||
gmgn-cli token info --chain <chain> --address <token_address>
|
||||
```
|
||||
|
||||
Check: `price`, `market_cap` (= `price × circulating_supply`), `liquidity`, `holder_count`, `wallet_tags_stat.smart_wallets`, `wallet_tags_stat.renowned_wallets`, `link.website` / `link.twitter_username` / `link.telegram`.
|
||||
|
||||
**Red flags**: all `link.*` social fields empty, liquidity < $10k, zero `wallet_tags_stat.smart_wallets` and `renowned_wallets`.
|
||||
|
||||
## Step 2 — Security Check
|
||||
|
||||
```bash
|
||||
gmgn-cli token security --chain <chain> --address <token_address>
|
||||
```
|
||||
|
||||
Check each field against the thresholds below:
|
||||
|
||||
| Field | Safe ✅ | Warning ⚠️ | Danger 🚫 |
|
||||
|-------|---------|-----------|---------|
|
||||
| `is_honeypot` | `"no"` | — | `"yes"` → **Stop immediately. Do not buy.** BSC/Base only — empty string on SOL (not applicable). |
|
||||
| `open_source` | `"yes"` | `"unknown"` | `"no"` |
|
||||
| `owner_renounced` | `"yes"` | `"unknown"` | `"no"` |
|
||||
| `renounced_mint` (SOL) | `true` | — | `false` → mint risk |
|
||||
| `renounced_freeze_account` (SOL) | `true` | — | `false` → freeze risk |
|
||||
| `buy_tax` / `sell_tax` | `0` | `0.01–0.05` | `>0.10` |
|
||||
| `top_10_holder_rate` | `<0.20` | `0.20–0.50` | `>0.50` |
|
||||
| `rug_ratio` | `<0.10` | `0.10–0.30` | `>0.30` |
|
||||
| `creator_token_status` | `creator_close` | — | `creator_hold` |
|
||||
| `sniper_count` | `<5` | `5–20` | `>20` |
|
||||
|
||||
**If `is_honeypot = "yes"` → stop immediately and display: "🚫 HONEYPOT DETECTED — Do not buy this token." Do NOT proceed.**
|
||||
|
||||
## Step 3 — Liquidity Pool
|
||||
|
||||
```bash
|
||||
gmgn-cli token pool --chain <chain> --address <token_address>
|
||||
```
|
||||
|
||||
Check: liquidity amount, which DEX (`exchange`), pool age (`creation_timestamp`). Low liquidity means high slippage risk when buying or selling.
|
||||
|
||||
## Step 4 — Market Heat (Check if Currently Trending)
|
||||
|
||||
Check if this token appears in current trending data:
|
||||
|
||||
```bash
|
||||
gmgn-cli market trending --chain <chain> --interval 1h --order-by volume --limit 100 --raw | jq '.data.rank[] | select(.address == "<token_address>")'
|
||||
```
|
||||
|
||||
- **If found**: note its `rank`, `smart_degen_count`, `volume`, `price_change_percent1h` — this confirms active market interest.
|
||||
- **If not found**: token is not currently trending (neutral signal — not necessarily bad, just no active buzz).
|
||||
|
||||
## Step 5 — Smart Money Signals
|
||||
|
||||
```bash
|
||||
# Is smart money accumulating?
|
||||
gmgn-cli token holders --chain <chain> --address <token_address> \
|
||||
--tag smart_degen --order-by buy_volume_cur --direction desc --limit 20
|
||||
|
||||
# What are KOL traders doing?
|
||||
gmgn-cli token traders --chain <chain> --address <token_address> \
|
||||
--tag renowned --order-by profit --direction desc --limit 20
|
||||
```
|
||||
|
||||
**Bullish signals**: smart_degen wallets buying heavily, unrealized_profit is large (still holding), low sell_volume_cur.
|
||||
|
||||
**Bearish signals**: sell_volume_cur > buy_volume_cur for smart money, large realized profits already taken (may be exiting), top holders with very high amount_percentage starting to sell.
|
||||
|
||||
## Decision Framework
|
||||
|
||||
After completing all steps, present a structured conclusion:
|
||||
|
||||
```
|
||||
Token Research Summary: {symbol} ({chain})
|
||||
Address: {short_address}
|
||||
─── Security ──────────────────────────────
|
||||
Honeypot: ✅ no / 🚫 YES — STOP
|
||||
Contract verified:✅ yes / 🚫 no / ⚠️ unknown
|
||||
Owner renounced: ✅ yes / 🚫 no / ⚠️ unknown
|
||||
Rug risk: {rug_ratio} → ✅ low / ⚠️ medium / 🚫 high
|
||||
Top-10 holders: {top_10_holder_rate%} → ✅ <20% / ⚠️ 20–50% / 🚫 >50%
|
||||
─── Liquidity ─────────────────────────────
|
||||
Pool liquidity: ${liquidity} on {exchange}
|
||||
─── Market Heat ───────────────────────────
|
||||
Trending: yes (rank #{rank}) / not trending
|
||||
─── Smart Money ───────────────────────────
|
||||
SM holders: {smart_wallets} | KOL holders: {renowned_wallets}
|
||||
SM activity: accumulating / distributing / absent
|
||||
─── Verdict ───────────────────────────────
|
||||
🟢 Buy — strong signals across all dimensions
|
||||
🟡 Watch — mixed signals, monitor for confirmation
|
||||
🔴 Skip — red flags present (specify which)
|
||||
```
|
||||
|
||||
**Scoring logic:**
|
||||
- If any 🚫 → skip (hard stop, especially if honeypot)
|
||||
- If 3+ ⚠️ with no 🚫 → needs more research / watch
|
||||
- If mostly ✅ with smart money accumulating → worth researching / buying
|
||||
|
||||
---
|
||||
|
||||
## Related Workflows
|
||||
|
||||
- [`workflow-market-opportunities.md`](workflow-market-opportunities.md) — find tokens from trending first, then deep dive here
|
||||
- [`workflow-project-deep-report.md`](workflow-project-deep-report.md) — more comprehensive analysis with scored dimensions and a full written report
|
||||
@@ -0,0 +1,85 @@
|
||||
# Wallet Analysis — Full Workflow
|
||||
|
||||
When a user provides a wallet address and wants to know the wallet's investment style, track record, and whether it's worth following.
|
||||
|
||||
## Step 1 — Current Holdings
|
||||
|
||||
```bash
|
||||
gmgn-cli portfolio holdings --chain <chain> --wallet <address> \
|
||||
--order-by usd_value --direction desc --limit 50
|
||||
```
|
||||
|
||||
Check: what tokens they hold, position sizes, `usd_value`, `unrealized_profit` distribution, `profit_change` per position. A wallet holding many positions with strong unrealized gains is still in accumulation mode.
|
||||
|
||||
## Step 2 — Trading Stats
|
||||
|
||||
```bash
|
||||
gmgn-cli portfolio stats --chain <chain> --wallet <address> --period 30d
|
||||
```
|
||||
|
||||
Key metrics:
|
||||
- `winrate` — ratio of profitable trades (0–1); > 0.6 is strong
|
||||
- `realized_profit` — total USD profit locked in over 30 days
|
||||
- `pnl` — profit/loss ratio = `realized_profit / total_cost`; `2.0` = doubled money
|
||||
- `buy_count` / `sell_count` — trading frequency and style
|
||||
|
||||
## Step 3 — Recent Activity
|
||||
|
||||
```bash
|
||||
gmgn-cli portfolio activity --chain <chain> --wallet <address> --limit 50
|
||||
```
|
||||
|
||||
Look for:
|
||||
- Trading frequency (multiple trades per day = active trader)
|
||||
- Average holding duration: compare `last_active_timestamp` of buy vs sell events for the same token
|
||||
- Token diversity: does the wallet trade many different tokens or focus on a few?
|
||||
- Position sizing patterns: are buys consistent size or highly variable?
|
||||
|
||||
## Step 4 — If Wallet Is Followed on GMGN
|
||||
|
||||
If the user has followed this wallet on the GMGN platform:
|
||||
|
||||
> **Requires `GMGN_PRIVATE_KEY`** in `.env` — `track follow-wallet` uses signature auth. If the key is not configured, skip this step and note it in the conclusion.
|
||||
|
||||
```bash
|
||||
gmgn-cli track follow-wallet --chain <chain> --wallet <address>
|
||||
```
|
||||
|
||||
Shows real-time trade feed for this wallet. Check `is_open_or_close` (1 = full position open/close, 0 = partial) and `price_change` (how well past trades aged).
|
||||
|
||||
## Step 5 — Deep Dive: Evaluate Their Top Holdings
|
||||
|
||||
For the top 3–5 holdings by `usd_value`, run the full token research workflow to verify the quality of what this wallet holds.
|
||||
|
||||
→ See [`docs/workflow-token-research.md`](workflow-token-research.md) for the full 5-step token analysis.
|
||||
|
||||
## Conclusion Framework
|
||||
|
||||
After completing all steps, output a wallet profile:
|
||||
|
||||
```
|
||||
Wallet Analysis: {short_address}
|
||||
Chain: {chain} | Period: 30d
|
||||
─── Performance ────────────────────────────
|
||||
Win Rate: {winrate × 100}%
|
||||
Realized P&L: ${realized_profit}
|
||||
PnL Ratio: {pnl}x
|
||||
Trades: {buy_count} buys / {sell_count} sells
|
||||
─── Style ──────────────────────────────────
|
||||
Trading Style: Day trader / Swing trader / Holder
|
||||
(Day trader: many trades/day; Swing: holds days–weeks; Holder: few sells)
|
||||
Token Focus: Meme / DeFi / Mixed / Specific sector
|
||||
─── Current Positions ──────────────────────
|
||||
Top holdings by value: {token1}, {token2}, {token3}
|
||||
Open unrealized P&L: ${total_unrealized}
|
||||
─── Smart Money Score ──────────────────────
|
||||
Are their picks confirmed by other smart money? (check smart_degen_count on top holdings)
|
||||
─── Verdict ────────────────────────────────
|
||||
🟢 Worth following — strong win rate + consistent P&L + smart money overlap
|
||||
🟡 Watch first — promising stats but limited data or inconsistent style
|
||||
🔴 Not recommended — low win rate, losses, or high-risk behavior patterns
|
||||
```
|
||||
|
||||
## Related Workflows
|
||||
|
||||
- [`workflow-smart-money-profile.md`](workflow-smart-money-profile.md) — deeper behavior analysis: trading style, take-profit/stop-loss patterns, copy-trade ROI estimate, and leaderboard comparison
|
||||
Reference in New Issue
Block a user