Crypto Trading Agents

---

name: crypto-trading-agents description: > 多Agent加密货币量化交易系统 — 基于 TradingAgents 多Agent框架 + Binance 执行层。 支持：技术分析、消息分析、多Agent辩论、自动化交易信号生成、Binance 现货下单。 适用场景：研究量化策略、自动交易Bot开发、加密货币组合分析。

---

Crypto Trading Agents

> 多Agent加密货币量化交易系统 | TradingAgents + Binance

系统架构

TradingAgents 多Agent框架
    ├── Technical Analyst (技术分析：RSI/MACD/Bollinger/ATR)
    ├── News Analyst (消息分析：市场新闻/宏观经济)
    ├── Sentiment Analyst (情绪分析：社交媒体情绪)
    ├── Fundamentals Analyst (基本面分析)
    ├── Bull/Bear Researcher (多空辩论)
    └── Portfolio Manager (组合管理，生成交易信号)
              ↓
        Binance Trader
    ├── 市价/限价下单
    ├── 止损/止盈
    └── 仓位/挂单查询
              ↓
       Binance 现货市场

环境要求

Python 3.10+

uv (推荐) 或 pip

Binance API Key（现货权限即可，不需要合约）

网络连接（Binance API 访问）

快速安装

# 克隆项目
git clone https://github.com/TauricResearch/TradingAgents.git
cd TradingAgents
创建虚拟环境
uv venv .venv --python 3.12
source .venv/bin/activate
安装核心依赖
pip install .
安装 CCXT（用于 Binance 对接）
uv pip install ccxt
可选：安装加密货币技术指标增强
uv pip install pandas numpy

环境变量配置

在项目根目录创建 .env 文件：

cp .env.example .env

编辑 .env，填入：

# ─── LLM API（TradingAgents 多Agent分析用）───
OPENAI_API_KEY=sk-...           # OpenAI GPT
或
GOOGLE_API_KEY=...              # Google Gemini
或
ANTHROPIC_API_KEY=...           # Anthropic Claude
─── Binance API（交易执行用）───
BINANCE_API_KEY=your_api_key
BINANCE_API_SECRET=your_api_secret
─── 可选 ───
BINANCE_TESTNET=true            # true = 使用测试网（不花真钱）

使用方法

方法一：Python API（推荐，开发用）

import tradingagents as ta
─── 1. 多Agent分析 ───────────────────────────
analyst = ta.CryptoAnalyst()
result = analyst.analyze("BTC/USDT", date="2026-03-24")
analyst.print_report(result)
─── 2. Binance 交易执行 ─────────────────────
trader = ta.BinanceTrader()
查询账户
print(trader.status("BTC/USDT"))
市价买入
print(trader.buy_market("BTC/USDT", amount=0.01))
限价买入
print(trader.buy_limit("BTC/USDT", amount=0.01, price=60000.0))
设置止损
print(trader.set_stop_loss("BTC/USDT", amount=0.01, stop_price=55000.0))
─── 3. 直接调用数据接口 ──────────────────────
from tradingagents.dataflows.binance_data import get_binance_ticker
from tradingagents.dataflows.crypto_indicators import get_crypto_indicators
实时行情（无需 API Key）
print(get_binance_ticker("BTC/USDT"))
技术指标（无需 API Key）
print(get_crypto_indicators("BTC/USDT", period="1d", lookback=60))

方法二：命令行（快速操作）

source .venv/bin/activate
分析（不需要 API Key）
python -m tradingagents.crypto_trading --symbol BTC/USDT --action analyze
python -m tradingagents.crypto_trading --symbol ETH/USDT --action analyze
账户状态
python -m tradingagents.crypto_trading --symbol BTC/USDT --action status
市价交易（需要 API Key）
python -m tradingagents.crypto_trading --symbol BTC/USDT --action trade --side buy --amount 0.01
限价交易
python -m tradingagents.crypto_trading --symbol BTC/USDT --action trade --side buy --amount 0.01 --price 60000
测试网交易
python -m tradingagents.crypto_trading --symbol BTC/USDT --action trade --side buy --amount 0.01 --testnet

方法三：直接使用 Binance Executor

from tradingagents.execution.binance_executor import (
    execute_market_order,
    execute_limit_order,
    execute_stop_loss,
    get_open_orders,
    get_position,
)
查持仓
print(get_position("BTC/USDT"))
市价单
print(execute_market_order("BTC/USDT", "buy", 0.01))
限价单
print(execute_limit_order("BTC/USDT", "buy", 0.01, 60000.0))
止损单
print(execute_stop_loss("BTC/USDT", "sell", 0.01, 55000.0))

主要模块

| 模块 | 说明 | |------|------| | tradingagents.crypto_trading | 主入口，CryptoAnalyst + BinanceTrader | | tradingagents.dataflows.binance_data | Binance 数据源（K线/行情/订单簿） | | tradingagents.dataflows.crypto_indicators | 技术指标（RSI/MACD/Bollinger/ATR） | | tradingagents.agents.utils.binance_tools | LangChain Tools，注入多Agent | | tradingagents.execution.binance_executor | 交易执行（市价/限价/止损） |

微信通知集成

系统内置 WeChatNotifier，当配置了企业微信 Webhook 后，所有交易活动自动推送：

export WECHAT_WEBHOOK_URL='https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=XXX'

发送内容：

📡 交易信号：方向、价格、置信度、原因

📗 订单执行：买入/卖出、价格、数量、订单ID

❌ 错误报警：操作失败时即时通知

📊 账户状态：持仓、盈亏、挂单数

自动交易工作流

定时任务（Cron）
    │
    ▼
AutoTradingSession.run("BTC/USDT")
    │
    ├── CryptoAnalyst.analyze()         ← 多Agent分析 + 微信推送信号
    │
    ├── signal = 解析 agent_decision      ← 信号解析（买入/卖出/观望）
    │
    ├── trader.buy_market()             ← 自动执行（可选）
    │
    ├── trader.set_stop_loss()          ← 自动设止损
    │
    └── WeChatNotifier 推送结果          ← 微信通知

命令行一键自动交易 + 微信通知

source .venv/bin/activate
自动分析 + 推送信号到微信（不交易）
python -m tradingagents.crypto_trading --symbol BTC/USDT --action analyze --notify
自动交易 + 微信通知
python -m tradingagents.crypto_trading --symbol BTC/USDT --action auto \
  --auto-trade --amount 0.01 --stop-loss 0.05 --notify --testnet
手动交易 + 微信通知
python -m tradingagents.crypto_trading --symbol BTC/USDT --action trade \
  --side buy --amount 0.01 --notify

Python API（带微信通知）

import tradingagents as ta
初始化（会自动读取 WECHAT_WEBHOOK_URL 环境变量）
notifier = ta.WeChatNotifier()
session = ta.AutoTradingSession(
    auto_trade=False,    # True = 自动执行交易
    notify=True,
    testnet=True,
)
运行：分析 → 信号 → 微信推送 →（可选）自动交易
result = session.run("BTC/USDT", buy_amount=0.01, stop_loss_pct=0.05)
单独使用通知器
notifier.notify_signal("BTC/USDT", "买入", 65000.0, "高", "RSI超卖 + MACD金叉")
notifier.notify_trade("BTC/USDT", "buy", 0.01, 65000.0, "123456", "已执行")

附：完整交易策略 Pine Script

scripts/hourly_contrarian_strategy.pine — 完整版策略（291行），包含：

MA60 多周期方向评分系统（4H + 日线）

顺势信号（回踩MA60 / 回踩前低 / 回抽前高）

K线形态过滤（锤子线 / 吞没形态 / 流星）

逆反思维信号（极端情绪 + 量能突增）

盈亏比 2:1 止损止盈

TP1 保本移动止损

仪表盘（方向 / 评分 / MA60斜率 / 杠杆）

Webhook 告警（支持 Binance 自动下单）

# 获取策略文件
cat scripts/hourly_contrarian_strategy.pine

复制内容到 TradingView Pine Editor 即可使用。

策略建议

1. 先用测试网：BINANCE_TESTNET=true，不花真钱 2. 先回测：用历史数据分析策略效果 3. 小资金实盘：先用最小单位（0.001 BTC）验证 4. 必设止损：每次开仓都要设止损，不要裸奔

安全提示

不要把 API Secret 提交到 Git

建议使用只读 + 现货交易权限的 API Key，不要用全权限

生产环境建议用 VPS + Docker 部署，不要在本地电脑跑

这是一个研究框架，实盘风险自负

故障排除

| 问题 | 解决方法 | |------|----------| | No module named 'ccxt' | uv pip install ccxt | | BINANCE_API_KEY not set | 检查 .env 文件是否配置 | | Insufficient data | 减少 lookback 参数 | | API Rate Limit | CCXT 已内置限流，等待即可 | | Network Error | 检查网络连接，确认 Binance 区域可用 |