💸 自动亏钱 Agent (Automated Loss-Making Agent)

如果真的能100%亏钱，那么反指就是100%胜率！

🌐 演示网站

在线 Demo: https://crypto-agent.elpha.top/

📚 使用说明

请使用前务必阅读 FAQ 文档！

📖 FAQ 常见问题解答

🏗 项目架构

• 语言: Python 3.10+
• 前端: Flask + Tailwind CSS (响应式仪表盘)
• 核心逻辑: LangGraph (构建 Agent 决策 Pipeline)
• 交易执行: CCXT (Binance USDM 合约)
• 数据持久化: SQLite (存储订单记录、分析日志)

🚀 快速开始

注意：该项目的大部分代码都是由gemini 3 pro完成，本人只是给gemini老师指指路，有bug欢迎issue与pr！

1. 环境准备

推荐使用 uv 进行快速环境管理，或者使用标准的 pip。

使用 uv (推荐):

uv sync

使用 pip:

pip install -r requirements.txt

2. 配置文件设置

在项目根目录修改.env.template为.env 文件，并参照以下格式填写(下面为重要部分)：

大陆如果无法访问合约api需要在agent_graph.py中初始化MarketTool的时候传入proxy_port参数（如本地运行v2ray服务(开启局域网连接)则填写10809）

# --- 调度器控制开关 ---

# --- 交易所配置 (实盘必填) ---
# 请确保 API 已开启合约交易权限，并绑定了运行环境的 IP 白名单
BINANCE_API_KEY=your_binance_api_key_here
BINANCE_SECRET=your_binance_secret_key_here

# --- 系统安全 ---
# 用于在前端 Dashboard 删除历史记录时的验证密码
ADMIN_PASSWORD=your_secure_password

# --- 杠杆设置 ---
# 注意：当前版本此参数仅作为 Prompt 提示 Agent，不会自动调整交易所杠杆倍数！
# 请务必去 Binance App/网页端手动调整对应币种的杠杆倍数。
LEVERAGE=10

# --- LangSmith (可选，用于调试 Agent 思维链) ---
LANGCHAIN_TRACING_V2=false
LANGCHAIN_API_KEY=your_langchain_api_key_here
LANGCHAIN_PROJECT=crypto-agent

# --- 交易对与 Agent 配置 (JSON 格式) ---
# 这是一个列表，支持为同一个币种配置多个不同性格/模型的 Agent
SYMBOL_CONFIGS='[
    {
        "symbol": "BTC/USDT",
        "api_base": "[https://dashscope.aliyuncs.com/compatible-mode/v1](https://dashscope.aliyuncs.com/compatible-mode/v1)",
        "api_key": "your_qwen_api_key",
        "model": "qwen3-max",
        "temperature": 0.7,
        "mode": "STRATEGY"
    },
    {
        "symbol": "ETH/USDT",
        "api_base": "[https://dashscope.aliyuncs.com/compatible-mode/v1](https://dashscope.aliyuncs.com/compatible-mode/v1)",
        "api_key": "your_qwen_api_key",
        "model": "qwen-plus",
        "temperature": 0.5,
        "mode": "REAL"
    }
]'

3. 运行项目

启动调度器与后端:

python dashboard.py

访问 http://localhost:7860 查看实盘/策略运行状态。

🔧 环境变量说明

ENABLE_SCHEDULER

• 作用: 控制是否启用定时任务调度器
• 默认值: true
• 说明: 设置为 true 时，定时任务会按照预设逻辑定期执行；设置为 false 时，定时任务会被禁用，仅运行网页服务

⚙️ 核心机制说明

1. 多 Agent 灵活性

你可以在 SYMBOL_CONFIGS 中为一个币种配置多个 Agent。

• 共享上下文: 它们共享同一个市场数据和历史记录。
• 执行顺序: 调度器按顺序执行。注意：Agent 之间会相互影响。如果 Agent A 先执行并开仓，Agent B 在随后的执行中会看到 Agent A 的持仓状态，其决策会受到影响。 实际使用请参考FAQ之后自行测试。

2. 交易模式

• STRATEGY (策略模式):

• 仅进行纸面交易（Paper Trading）。

• 生成带止盈止损的建议订单，记录在数据库中，不消耗真实资金。

• 适合测试 Prompt 和模型逻辑。
  当前版本1h运行一次

• REAL (实盘模式):

• 高风险。直接调用 Binance 接口下单。

• 目前逻辑侧重于 Limit 挂单入场。
  当前版本强制15m盯一次盘面（周一到周日）

详细说明：

场景A：只有 BTC (策略)

调度器每 60分钟 醒来一次。

BTC 运行。

场景B：只有 ETH (实盘)

调度器每 15分钟 醒来一次。

ETH 运行。

场景C：BTC (策略) + ETH (实盘)

调度器每 15分钟 醒来一次。

09:00 -> 调度器醒来。ETH 跑；BTC 检查发现是整点 -> 跑。

09:15 -> 调度器醒来。ETH 跑；BTC 检查发现不是整点 -> 跳过。

09:30 -> 调度器醒来。ETH 跑；BTC 检查发现不是整点 -> 跳过。

10:00 -> 调度器醒来。ETH 跑；BTC 检查发现是整点 -> 跑。

3. 杠杆 (LEVERAGE)

配置文件中的 LEVERAGE 参数目前仅用于 Prompt 注入（告诉 AI 当前是多少倍杠杆）。

• ⚠️ 重要: 程序不会自动去交易所修改杠杆倍数。
• 请确保 .env 中的值与你 Binance 账户中实际设置的杠杆倍数一致。

4. TODO

实盘模式有bug时候进行修复（还在测试中） 策略模式目前胜率较低，盈亏比不佳，需要再次调整