Binance Trade Hunter 🔥

币安交易机会捕手 — TG 直接玩币。

First-Time Setup (MANDATORY)

When this skill is first loaded or installed, IMMEDIATELY check if src/config.yaml exists in this skill's directory.

If src/config.yaml does NOT exist, you MUST stop and guide the user through setup NOW — do not wait for a command:

1. Tell the user: "🔧 Binance Trade Hunter 安装成功！需要完成初始配置才能使用。"
2. Copy src/config.example.yaml to src/config.yaml
3. Ask the user for their Binance API Key and Ed25519 private key file path
   • ⚠️ Before asking, warn the user: "为了资金安全，强烈建议使用币安子账户的 API Key 操作，不要使用主账户。子账户可以在币安 App → 账户管理 → 子账户 中创建，单独设置 API 权限和资金额度，即使 Key 泄露也不会影响主账户资产。"
   • API Key must have Spot Trading permission enabled
   • Key type must be Ed25519 (not HMAC-SHA256)
4. Ask the user: "是否需要配置独立的 Telegram 通知？如不指定，将默认使用当前对话的 TG Bot 发送通知。"
   • If user wants custom TG: ask for bot_token and chat_id, fill into config.yaml
   • If user skips (default): leave telegram section empty or remove it. The skill will auto-detect the current session's TG bot token and chat_id from OpenClaw config.
5. Fill the values into src/config.yaml
6. Run: pip install -r src/requirements.txt (if dependencies not installed)
7. After setup is complete, tell the user: "✅ 配置完成！现在可以开始使用了。试试说「分析潜力币」或「查看余额」。"

Do NOT skip this step. Do NOT proceed to any command if config.yaml is missing.

Usage

All commands use this skill's directory as working dir. Replace SKILL_DIR with the resolved absolute path of this SKILL.md's parent directory.

Instant Commands

All functions return formatted text. Reply directly to user.

Analyze Top Coins — "分析潜力币" / "推荐币" / "analyze coins"

cd SKILL_DIR; python -c "import sys; sys.path.insert(0,'src'); from skill_api import analyze_top_coins; print(analyze_top_coins(3))"

Analyze Single Coin — "分析 XXX" / "analyze BTC" / "看看 SOL"

cd SKILL_DIR; python -c "import sys; sys.path.insert(0,'src'); from skill_api import analyze_coin; print(analyze_coin('BTC'))"

Replace 'BTC' with user's coin symbol.

Buy — "买 50U 的 ETH" / "buy 100U BTC"

cd SKILL_DIR; python -c "import sys; sys.path.insert(0,'src'); from skill_api import buy; print(buy('ETH', 50))"

Args: coin symbol, USDT amount. ⚠️ Real money trade — confirm with user before executing.

Sell All — "卖掉 BTC" / "sell all ETH"

cd SKILL_DIR; python -c "import sys; sys.path.insert(0,'src'); from skill_api import sell_all; print(sell_all('BTC'))"

Sell Half — "卖一半 BTC" / "sell half ETH"

cd SKILL_DIR; python -c "import sys; sys.path.insert(0,'src'); from skill_api import sell_half; print(sell_half('BTC'))"

Check Positions — "查看持仓" / "仓位" / "positions"

cd SKILL_DIR; python -c "import sys; sys.path.insert(0,'src'); from skill_api import get_positions; print(get_positions())"

Check Balance — "查看余额" / "余额" / "balance"

cd SKILL_DIR; python -c "import sys; sys.path.insert(0,'src'); from skill_api import get_balance; print(get_balance())"

Background Services

Long-running services. Only start when user explicitly requests.

Pump Alert (异动监控) Start: "启动异动监控" / "start pump alert"

cd SKILL_DIR; python -c "import sys; sys.path.insert(0,'src'); from skill_api import start_pump_alert; print(start_pump_alert())"

Stop: "停止异动监控" / "stop pump alert"

cd SKILL_DIR; python -c "import sys; sys.path.insert(0,'src'); from skill_api import stop_pump_alert; print(stop_pump_alert())"

Coin Push (定时推送) Start: "启动定时推送" / "start coin push"

cd SKILL_DIR; python -c "import sys; sys.path.insert(0,'src'); from skill_api import start_coin_push; print(start_coin_push())"

Stop: "停止定时推送" / "stop coin push"

cd SKILL_DIR; python -c "import sys; sys.path.insert(0,'src'); from skill_api import stop_coin_push; print(stop_coin_push())"

Service Status — "服务状态" / "service status"

cd SKILL_DIR; python -c "import sys; sys.path.insert(0,'src'); from skill_api import service_status; print(service_status())"

Dependencies

Python 3.10+ required. Install via:

cd SKILL_DIR; pip install -r src/requirements.txt

Key packages: requests, cryptography, pyyaml, websocket-client

Notes

• All trade commands execute real orders on Binance. Confirm coin and amount before executing.
• Background services run as independent processes. Use service_status to check.
• On Windows, add UTF-8 wrapper if emoji output causes encoding errors: import sys,io; sys.stdout=io.TextIOWrapper(sys.stdout.buffer,encoding='utf-8')

🌊 用 AI 建设加密，和币安一起逐浪 Web3！