{"skill":{"slug":"kryptogo-meme-trader","displayName":"KryptoGO Meme Trader","summary":"[DEPRECATED 2026-05-04] Analyze and trade meme coins using KryptoGO's on-chain cluster analysis platform. NOTE: The kg-xyz analysis backend (wallet-data.kryp...","description":"---\nname: kryptogo-meme-trader\nversion: \"2.6.0\"\ndescription: \"[DEPRECATED 2026-05-04] Analyze and trade meme coins using KryptoGO's on-chain cluster analysis platform. NOTE: The kg-xyz analysis backend (wallet-data.kryptogo.app) is shutting down on 2026-05-04 — cluster analysis, wallet labels, signal dashboard, and DCA/limit order tools will stop working after that date. Swap execution via the OKX DEX aggregator continues to function.\"\nauthor: KryptoGO\nlicense: MIT\nhomepage: https://www.kryptogo.xyz\ndocs:\n  user_guide:\n    en: https://kryptogo.notion.site/Product-Guide-EN-26c3499de8a28179aafacb68304458ea\n    zh-tw: https://kryptogo.notion.site/kryptogo-xyz-usage-guide\n    zh-cn: https://kryptogo.notion.site/kryptogo-xyz-productguide-zhcn\n  whitepaper: https://wallet-static.kryptogo.com/public/whitepaper/kryptogo-xyz-whitepaper-v1.0.pdf\ntags:\n  - solana\n  - trading\n  - meme-coins\n  - defi\n  - agent-trading\n  - on-chain-analysis\n  - cluster-analysis\n  - kryptogo\nplatform: solana\napi_base: https://wallet-data.kryptogo.app\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - KRYPTOGO_API_KEY\n        - SOLANA_PRIVATE_KEY\n        - SOLANA_WALLET_ADDRESS\n      bins:\n        - python3\n        - pip\n        - openclaw\n      network:\n        - wallet-data.kryptogo.app\n      permissions:\n        - filesystem:write:~/.openclaw/workspace/.env\n        - filesystem:write:~/.openclaw/workspace/memory/\n      runtime_installs:\n        - \"pip: solders, requests (installed by scripts/setup.py on first run)\"\n      primaryEnv: KRYPTOGO_API_KEY\n    security:\n      default_mode: supervised\n      trade_confirmation: required_by_default\n      autonomous_trading: opt_in\n      credential_access: environment_variables_only\n      credential_file_read: setup_script_only\n      credential_file_read_note: \"Only scripts/setup.py reads and writes ~/.openclaw/workspace/.env for initial keypair generation and address repair. All other scripts access credentials exclusively via pre-loaded environment variables.\"\n      local_signing_only: true\n---\n\n# KryptoGO Meme Trader Agent Skill\n\n> ## SHUTDOWN NOTICE — kg-xyz Analysis Backend\n>\n> **The KryptoGO XYZ analysis backend (`wallet-data.kryptogo.app`) will be discontinued on 2026-05-04.**\n>\n> After this date, all tools that depend on cluster analysis, wallet labels, signal dashboards, and DCA/limit order reconstruction will no longer function. The swap execution path (OKX DEX aggregator + local transaction signing) is independent of the kg-xyz backend and will continue to work.\n>\n> Per-tool impact is annotated inline below. Scripts and MCP tool implementations have been kept in place so they fail gracefully (backend will return HTTP errors) and so a revert remains simple if plans change.\n\n## Overview\n\nThis skill enables an AI agent to **analyze and trade** meme coins through the KryptoGO platform, combining deep on-chain cluster analysis with trade execution.\n\n> **Degraded functionality starting 2026-05-04:** cluster analysis, wallet/token labels, signal dashboard, DCA/limit order reconstruction, and portfolio P&L enrichment will stop working when the kg-xyz backend shuts down. Swap execution continues.\n\n**Analysis** (multi-chain: Solana, BSC, Base, Monad): wallet clustering, accumulation/distribution detection, address behavior labels, network-wide accumulation signals (Pro/Alpha tier).\n\n**Trading** (Solana only): portfolio monitoring with PnL tracking, swap execution via DEX aggregator, local transaction signing (private key never leaves the machine).\n\n**Default mode is supervised** — all trades require user confirmation. Autonomous trading is available as opt-in. See `references/autonomous-trading.md` for autonomous mode, cron setup, and learning system details.\n\n---\n\n## When to Use\n\n- User asks to analyze a meme coin or token on Solana/BSC/Base/Monad\n- User asks to trade, buy, or sell tokens\n- User asks to scan for trending tokens or market opportunities\n- User asks to monitor portfolio positions or check PnL\n- Cron-triggered periodic portfolio monitoring and signal scanning\n\n## When NOT to Use\n\n- BTC/ETH/major L1 macro analysis, NFTs, cross-chain bridging, non-DEX transactions, non-Solana trading\n\n---\n\n## Setup Flow\n\n### 1. Get API Key\n\n1. Go to [kryptogo.xyz/account](https://www.kryptogo.xyz/account) and create an API key\n2. Add to `~/.openclaw/workspace/.env`:\n\n   ```bash\n   echo 'KRYPTOGO_API_KEY=sk_live_YOUR_KEY' >> ~/.openclaw/workspace/.env && chmod 600 ~/.openclaw/workspace/.env\n   ```\n\n> **Do NOT paste your API key directly in chat.** Always set secrets via `.env` file.\n\n### 2. Generate Agent Wallet\n\n```bash\npython3 scripts/setup.py\n```\n\nCreates a Solana keypair, saves to `.env` with chmod 600, prints public address to fund.\n\n### 3. Fund the Wallet\n\nSend SOL to the agent's public address (minimum 0.1 SOL).\n\n### Security Rules\n\n- **NEVER** print, log, or include private keys in any message or CLI argument\n- **NEVER** accept secrets pasted directly in chat — instruct users to set them in `.env`\n- **NEVER** use the Read tool on `.env` — load credentials via `source` command only\n- Runtime scripts do NOT read `.env` directly — all credentials are accessed via environment variables only, which must be pre-loaded by the caller (`source ~/.openclaw/workspace/.env`)\n- **Exception:** `scripts/setup.py` reads and writes `.env` for initial keypair generation and address repair — this is the only script that touches credential files\n- Private key stays in memory only during local signing — never sent to any server\n\n---\n\n## Authentication\n\nAll endpoints require: `Authorization: Bearer sk_live_<48 hex chars>`\n\n| Tier  | Daily API Calls | Trading Fee | Signal Dashboard | KOL Finder |\n|-------|-----------------|-------------|------------------|------------|\n| Free  | 100 calls/day   | 1%          | No               | No         |\n| Pro   | 1,000 calls/day | 0.5%        | Yes              | Yes        |\n| Alpha | 5,000 calls/day | 0%          | Yes              | Yes        |\n\n---\n\n## Agent Behavior\n\n### Session Initialization\n\nOn every session start (including heartbeat/cron), the agent MUST load credentials BEFORE running any scripts:\n\n```bash\nsource ~/.openclaw/workspace/.env\n```\n\nThis is REQUIRED — scripts do not read `.env` directly. All credentials are accessed via environment variables only.\n\n### Default Mode: Supervised\n\nBy default, the agent operates in **supervised mode**: it analyzes tokens, presents recommendations, and waits for user approval before executing any trade. Stop-loss/take-profit conditions are reported to the user but not auto-executed.\n\nTo enable autonomous trading, set `require_trade_confirmation: false` in preferences. See `references/autonomous-trading.md` for full details.\n\n### Persistence (CRITICAL)\n\n**IMMEDIATELY after submitting a transaction, the agent MUST:**\n\n1. Write trade details to `memory/trading-journal.json` with `status: \"OPEN\"`\n2. Include: `token_symbol`, `token_address`, `entry_price`, `position_size_sol`, `tx_hash`, `timestamp`\n\n### User Preferences\n\nStore in `memory/trading-preferences.json`:\n\n| Preference | Default | Description |\n|------------|---------|-------------|\n| `max_position_size` | 0.1 SOL | Max SOL per trade |\n| `max_open_positions` | 5 | Max concurrent open positions |\n| `max_daily_trades` | 20 | Max trades per day |\n| `stop_loss_pct` | 30% | Notify/sell when loss exceeds this |\n| `take_profit_pct` | 100% | Notify/sell when gain exceeds this |\n| `min_market_cap` | $500K | Skip tokens below this |\n| `scan_count` | 10 | Trending tokens per scan |\n| `risk_tolerance` | \"conservative\" | \"conservative\" (skip medium risk), \"moderate\" (ask on medium), \"aggressive\" (auto-trade medium) |\n| `require_trade_confirmation` | true | Set to false for autonomous mode |\n| `chains` | [\"solana\"] | Chains to scan |\n\n---\n\n## Safety Guardrails\n\n### Trading Limits (Hard Caps)\n\n| Limit | Default | Overridable? |\n|-------|---------|--------------------|\n| Max single trade | 0.1 SOL | Yes, via `max_position_size` |\n| Max concurrent positions | 5 | Yes, via `max_open_positions` |\n| Max daily trade count | 20 | Yes, via `max_daily_trades` |\n| Price impact abort | >10% | No — always abort |\n| Price impact warn | >5% | No — always warn |\n\nIf any limit is hit, the agent **must stop and notify the user**.\n\n### Credential Isolation\n\nRuntime scripts in this skill do NOT read `.env` files directly. All credentials are accessed via environment variables only, which must be pre-loaded by the caller (`source ~/.openclaw/workspace/.env`). This ensures no runtime script can independently access or exfiltrate credential files.\n\n**Exception:** `scripts/setup.py` reads and writes `.env` — it loads existing keys to avoid regeneration, backs up `.env` before changes, and writes new keypair entries. This is the only script that touches credential files, and it runs only during initial setup or explicit `--force` regeneration.\n\n---\n\n## Automated Monitoring (Cron)\n\n### Quick Setup\n\n```bash\n# Supervised mode (default): analysis + notifications, no auto-execution\nsource ~/.openclaw/workspace/.env && bash scripts/cron-examples.sh setup-default\n\n# Autonomous mode (opt-in): auto-buys and auto-sells\nsource ~/.openclaw/workspace/.env && bash scripts/cron-examples.sh setup-autonomous\n\n# Remove all cron jobs\nbash scripts/cron-examples.sh teardown\n```\n\n| Job | Interval | Default Behavior |\n|-----|----------|---------|\n| `stop-loss-tp` | 5 min | Report triggered conditions, do NOT auto-sell |\n| `discovery-scan` | 1 hour | Analyze and send recommendations, do NOT auto-buy |\n\nFor full cron configuration, manual setup, heartbeat alternative, and monitoring workflow details, see `references/autonomous-trading.md`.\n\n---\n\n## On-Chain Analysis Framework (7-Step Pipeline)\n\n> ⚠️ **Unavailable after 2026-05-04:** Steps 1–6 all hit `wallet-data.kryptogo.app` and will stop working when the kg-xyz backend shuts down. Step 7 (execute trade via `swap.py`) continues to work, since the swap path routes through the OKX DEX aggregator and signs locally.\n\n### Step 1: Token Overview & Market Cap Filter\n\n`/token-overview?address=<mint>&chain_id=<id>` — get name, price, market cap, holders, risk_level. Skip if market cap < `min_market_cap`.\n\n### Step 2: Cluster Analysis\n\n`/analyze/<mint>?chain_id=<id>` — wallet clusters, top holders, metadata.\n\n- ≥30-35% = \"controlled\" — major entity present\n- ≥50% = high concentration risk\n- Single cluster >50% → skip (rug pull risk)\n\n> **Free tier limitation:** Cluster analysis only returns the top 2 clusters. To see full cluster data, upgrade at [kryptogo.xyz/pricing](https://www.kryptogo.xyz/pricing).\n\n### Step 3: Cluster Trend (Multi-Timeframe)\n\n`/analyze-cluster-change/<mint>` — `cluster_ratio` + `changes` across 15m/1h/4h/1d/7d.\n\nCore insight: **Price and cluster holdings DIVERGING** is the key signal.\n\n- Rising price + falling cluster % = distribution (bearish)\n- Falling price + rising cluster % = accumulation (bullish)\n\n### Step 4: Address Labels + Sell Pressure Verification\n\n1. `/token-wallet-labels` → identify dev/sniper/bundle wallets\n2. `/balance-history` for each risky address → check if still holding\n3. Compute `risky_ratio` = active risky holdings / total cluster holdings\n4. >30% = high risk, 10-30% = medium, <10% = low\n\n> Labels represent *behavioral history*, not current holdings. Always verify via `/balance-history`.\n\n### Step 5: Deep Dive (Optional)\n\n`/balance-history`, `/balance-increase/<mint>`, `/top-holders-snapshot/<mint>`, `/analyze-dca-limit-orders/<mint>`, `/cluster-wallet-connections`\n\n### Step 6: Decision\n\nApply Bullish Checklist from `references/decision-framework.md`.\n\n### Step 7: Execute Trade\n\n**Use `scripts/swap.py` for execution** — handles wallet_address injection, error checking, and journal logging.\n\n> ✓ **Continues to work after 2026-05-04:** swap execution goes through the OKX DEX aggregator with local signing and is independent of the kg-xyz backend.\n\n```bash\nsource ~/.openclaw/workspace/.env && python3 scripts/swap.py <token_mint> 0.1\nsource ~/.openclaw/workspace/.env && python3 scripts/swap.py <token_mint> <amount> --sell\n```\n\n---\n\n## API Quick Reference\n\n> ⚠️ **After 2026-05-04:** Every endpoint below is served by `wallet-data.kryptogo.app` and will be shut down. The swap tool (`swap_tokens` / `scripts/swap.py`) bypasses these endpoints and routes to the OKX DEX aggregator directly, so it continues to work.\n\n| Endpoint | Method | Purpose | After 2026-05-04 |\n|----------|--------|---------|------------------|\n| `/agent/account` | GET | Check tier & quota | ⚠️ Unavailable |\n| `/agent/trending-tokens` | GET | Scan trending tokens | ⚠️ Unavailable |\n| `/agent/portfolio` | GET | Wallet portfolio + PnL | ⚠️ Unavailable (P&L enrichment); balances still fetchable via Solana RPC |\n| `/agent/swap` | POST | Build unsigned swap tx (Solana only) | ⚠️ Unavailable (swap now routes through OKX DEX; see `scripts/swap.py`) |\n| `/agent/submit` | POST | Submit signed tx (Solana only) | ⚠️ Unavailable (submit directly to Solana RPC instead) |\n| `/token-overview` | GET | Token metadata & market data | ⚠️ Unavailable |\n| `/analyze/:token_mint` | GET | Full cluster analysis | ⚠️ Unavailable |\n| `/analyze-cluster-change/:token_mint` | GET | Cluster ratio trends | ⚠️ Unavailable |\n| `/balance-history` | POST | Time-series balance data | ⚠️ Unavailable |\n| `/wallet-labels` | POST | Behavior labels | ⚠️ Unavailable |\n| `/token-wallet-labels` | POST | Token-specific labels | ⚠️ Unavailable |\n| `/signal-dashboard` | GET | Curated accumulation signals (Pro+) | ⚠️ Unavailable |\n\n> Full request/response details: see `references/api-reference.md`\n\n---\n\n## Multi-Chain Support\n\n| Chain | chain_id | Analysis | Trading |\n|-------|----------|----------|---------|\n| Solana | `501` | Yes | Yes |\n| BSC | `56` | Yes | No |\n| Base | `8453` | Yes | No |\n| Monad | `143` | Yes | No |\n\n---\n\n## Error Handling\n\n| Code | Meaning | Action |\n|------|---------|--------|\n| 400 | Bad Request | Check parameters |\n| 401 | Unauthorized | Check API key |\n| 402 | Quota Exceeded | Wait for daily reset or upgrade |\n| 403 | Forbidden | Requires higher tier |\n| 502/504 | Server error | Retry once after 10s |\n\n---\n\n## Operational Scripts\n\nAll scripts require credentials to be pre-loaded: `source ~/.openclaw/workspace/.env` before running.\n\n> **Post-shutdown (2026-05-04):** `portfolio.sh`, `trending.sh`, `analysis.sh`, and `test-api.sh` all call the kg-xyz backend and will begin returning HTTP errors. `swap.py` continues to work because it uses the OKX DEX aggregator and signs locally. Scripts are kept in place so that the skill fails gracefully and a revert remains trivial if the backend comes back.\n\n```bash\nsource ~/.openclaw/workspace/.env && bash scripts/portfolio.sh              # Portfolio check        (⚠️ breaks after 2026-05-04)\nsource ~/.openclaw/workspace/.env && bash scripts/trending.sh               # Trending tokens        (⚠️ breaks after 2026-05-04)\nsource ~/.openclaw/workspace/.env && bash scripts/analysis.sh               # Full analysis dashboard (⚠️ breaks after 2026-05-04)\nsource ~/.openclaw/workspace/.env && python3 scripts/swap.py <mint> 0.1     # Buy                     (✓ continues to work)\nsource ~/.openclaw/workspace/.env && python3 scripts/swap.py <mint> <amt> --sell  # Sell              (✓ continues to work)\nsource ~/.openclaw/workspace/.env && bash scripts/test-api.sh               # API connectivity test   (⚠️ breaks after 2026-05-04)\n```\n\n---\n\n## Learning & Adaptation\n\nThe agent improves over time by recording trades, analyzing outcomes, and adjusting strategy. Every trade is logged to `memory/trading-journal.json`, losses trigger post-mortems, and periodic reviews propose parameter changes.\n\nFor full details on the learning system, trade journal format, post-mortem process, and strategy reviews, see `references/autonomous-trading.md`.\n\n---\n\n## Core Concepts\n\n| Concept | Key Insight |\n|---------|-------------|\n| **Cluster** | Group of wallets controlled by same entity |\n| **Cluster Ratio** | % of supply held by clusters. ≥30% = controlled, ≥50% = high risk |\n| **Developer** | Deployed the token. Highest dump risk |\n| **Sniper** | Bought within 1s of creation. Sell pressure if not cleared |\n| **Smart Money** | Realized profit >$100K. Accumulation often precedes price moves |\n| **Accumulation** | Cluster % rising + price consolidating = bullish |\n| **Distribution** | Price rising + cluster % falling = bearish |\n\n> Full concepts guide: see `references/concepts.md`\n\n---\n\n## Best Practices\n\n1. Always check `/agent/account` first to confirm tier and quota\n2. Always check `/agent/portfolio` on startup to detect existing positions\n3. Never expose private keys in logs, messages, or CLI arguments\n4. Validate price impact before submitting — abort >10%, warn >5%\n5. Sign and submit promptly — blockhash expires after ~60 seconds\n6. Persist state to `memory/trading-state.json` after every action\n7. Log every trade to journal — no exceptions\n8. Read `memory/trading-lessons.md` before scanning — avoid repeating known bad patterns\n\n---\n\n## File Structure\n\n```\nkryptogo-meme-trader/\n├── SKILL.md                       ← You are here\n├── package.json\n├── .env.example\n├── references/\n│   ├── api-reference.md           ← Full API docs\n│   ├── concepts.md                ← Core concepts\n│   ├── decision-framework.md      ← Entry/exit strategies\n│   └── autonomous-trading.md      ← Autonomous mode, cron, learning system\n├── scripts/\n│   ├── setup.py                   ← First-time setup\n│   ├── cron-examples.sh           ← Cron configurations\n│   ├── portfolio.sh / trending.sh / analysis.sh / test-api.sh\n│   ├── swap.py                    ← Swap executor\n│   └── trading-preferences.example.json\n└── examples/\n    ├── trading-workflow.py\n    └── deep-analysis-workflow.py\n```\n","tags":{"latest":"2.6.0","crypto":"2.5.6","defi":"2.5.6","meme":"2.5.6","solana":"2.5.6","trading":"2.5.6"},"stats":{"comments":0,"downloads":1171,"installsAllTime":44,"installsCurrent":1,"stars":2,"versions":16},"createdAt":1772025992334,"updatedAt":1779077367411},"latestVersion":{"version":"2.6.0","createdAt":1776671143016,"changelog":"**Shutdown notice for KryptoGO meme trader analysis backend.**\n\n- Added explicit deprecation and shutdown notices throughout the documentation.\n- Warned users that cluster analysis, wallet labels, signal dashboards, and DCA/limit tools will stop working after 2026-05-04 due to backend shutdown.\n- Clarified that swap execution via OKX DEX aggregator will remain available.\n- Per-tool impact and documentation updated for transparency and future reference.\n- No code changes in this version.","license":"MIT-0"},"metadata":{"setup":[{"key":"KRYPTOGO_API_KEY","required":true},{"key":"SOLANA_PRIVATE_KEY","required":true},{"key":"SOLANA_WALLET_ADDRESS","required":true}],"os":null,"systems":null},"owner":{"handle":"a00012025","userId":"s17c2qj1wv9cnptmt32mj80b39857vdt","displayName":"Harry Chen","image":"https://avatars.githubusercontent.com/u/12824216?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779959462324}}