mirror of
https://github.com/GMGNAI/gmgn-skills.git
synced 2026-07-27 16:57:44 +00:00
gumponchain
c2799c73d1
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>
86 lines
3.8 KiB
Markdown
86 lines
3.8 KiB
Markdown
# 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
|