gate_scout_order/onchain_scout_gate/安装与说明.md

交易系统部署说明（Gate USDT 永续）

1. 系统概要

本系统是基于 Python 的监控服务，使用 Gate.io 公共 API（USDT 永续）。

• 监控市场：Gate USDT 线性永续（如 BTC_USDT）
• 周期：固定 5m 扫描
• 信号分级：WATCH / TRIGGER

2. config.yaml（节选）

gate:
  api_base: https://api.gateio.ws/api/v4
  settle: usdt
  quote_currency: USDT

monitor:
  universe: all_swaps
  min_24h_quote_volume_usdt: 10000000

watch_symbols: []

完整示例见 config.example.yaml。若仍使用旧字段 okx:，请改为 gate:，否则服务无法启动。

3. 安装（Linux 示例）

apt update && apt install -y python3 python3-pip python3-venv
cd /root/onchain_scout_gate
python3 -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -r requirements.txt
cp -n config.example.yaml config.yaml
nano config.yaml

4. 生产部署：PM2（推荐）

npm install -g pm2
cd /root/onchain_scout_gate
pm2 start deploy/ecosystem.config.cjs
pm2 logs onchain-scout

开机自启：pm2 save 与 pm2 startup（按 CLI 提示执行）。

5. 前台调试

cd /root/onchain_scout_gate && source .venv/bin/activate && python -m app.main

6. 常见问题

• 配置报错：确认已使用 gate: 配置块。
• 依赖缺失：在 venv 内重装 requirements.txt。
• 网络：需要能访问 api.gateio.ws（或通过 proxy）。

7. 运维

• 备份 runtime/alerts.db
• 改配置后：pm2 restart onchain-scout