Auto-GPT MetaTrader 插件 📈

AutoGPT MetaTrader 插件是一款软件工具，使交易者能够将其 MetaTrader 4 或 5 交易账户连接到 Auto-GPT。

在 ChatGPT 上试用 MetaTrader GPT

💖 帮助支持 Auto-GPT 插件的开发 💖

如果您能请我们喝杯咖啡，就能帮助支付 Auto-GPT 插件的开发成本，并推动完全自主人工智能的边界！ 您的支持将不胜感激。这个免费开源项目的开发离不开所有 贡献者和赞助者。如果您想赞助本项目，并让您的头像或公司 logo 出现在下方，请点击这里。

加密货币捐赠：0x2457e8746EFa5894b70aE06a1b391474bc928B05

💡 主要功能：

• 💰 下单交易
• ℹ️ 账户信息
• ⛔️ 平仓
• ❌ 平掉所有仓位
• 🕯 K线数据
• 📈 当日股票
• 📂 红色文件夹新闻
• ％ 社区情绪（开发中）
• 📝 修改订单（开发中）

🔧 安装

请按照以下步骤配置 Auto-GPT MetaTrader 插件：

1. 克隆 Auto-GPT-MetaTrader-Plugin 仓库

克隆此仓库，并在终端中导航到 Auto-GPT-MetaTrader-Plugin 文件夹：

git clone https://github.com/isaiahbjork/Auto-GPT-MetaTrader-Plugin.git

2. 安装所需依赖

执行以下命令以安装必要的依赖项：

pip install -r requirements.txt

3. 将插件打包为 Zip 文件

压缩 Auto-GPT-MetaTrader-Plugin 文件夹，或下载仓库的 Zip 文件。

4. 安装 Auto-GPT

如果您尚未安装，请克隆 Auto-GPT 仓库，按照其安装说明操作，并导航到 Auto-GPT 文件夹。

如果出现“未找到模块”的错误消息，您可能需要在 Auto-GPT 文件中运行以下命令：

pip install ta myfxbook

5. 将 Zip 文件复制到 Auto-GPT 插件文件夹

将第 3 步中的 Zip 文件传输到 Auto-GPT 仓库内的 plugins 子文件夹中。

6. 查找 .env.template 文件

在主 /Auto-GPT 文件夹中找到名为 .env.template 的文件。

7. 创建并重命名该文件的副本

复制 .env.template 文件，并将其重命名为 /Auto-GPT 文件夹中的 .env。

8. 编辑 .env 文件

在文本编辑器中打开 .env 文件。请注意：以点开头的文件可能会被您的操作系统隐藏。

9. 添加 MetaTrader 配置设置

将以下配置设置附加到文件末尾：

################################################################################
### METATRADER
################################################################################
META_API_ACCOUNT_ID=
META_API_TOKEN=
META_API_REGION=
LUNAR_CRUSH_API_KEY=
MY_FX_BOOK_USERNAME=
MY_FX_BOOK_PASSWORD=
FCS_API_KEY=

• 创建一个 MetaAPI 账户，并连接到您的经纪商。
• MT5 账户需要付费才能访问 K 线数据。
• 创建一个 MyFxBook 账户，并连接到您的交易账户。
• 创建一个 FCS API 账户。（每月可免费调用 500 次）
• 将 META_API_ACCOUNT_ID 设置为您在 MetaAPI 中的账户 ID。
• 将 META_API_TOKEN 设置为您在 MetaAPI 中的令牌。
• 将 META_API_REGION 设置为您在 MetaAPI 中的地区（纽约、伦敦、新加坡）。
• 将 LUNAR_CRUSH_API_KEY 设置为您在 LunarCrush 中的 API 密钥。
• 将 MY_FX_BOOK_USERNAME 设置为您在 MyFxBook 中的用户名或邮箱。
• 将 MY_FX_BOOK_PASSWORD 设置为您在 MyFxBook 中的密码。
• 将 FCS_API_KEY 设置为您在 FCS API 中的密钥。

10. 将插件加入白名单

在您的 .env 文件中搜索 ALLOWLISTED_PLUGINS，并将此插件添加进去：

################################################################################
### ALLOWLISTED PLUGINS
################################################################################
#ALLOWLISTED_PLUGINS - 设置允许使用的插件列表（例如：plugin1,plugin2,plugin3）
ALLOWLISTED_PLUGINS=AutoGPTMetaTraderPlugin

11. 查看可用命令

您可以在此处查看可用的命令和指标：[src/auto_gpt_metatrader/commands.txt]。

🧪 测试 Auto-GPT MetaTrader 插件

通过测试下单、管理账户、平仓以及获取 K 线数据等功能，体验该插件的强大能力。

测试获取 K 线数据

1. 配置 Auto-GPT： 使用以下参数设置 Auto-GPT：

   • 名称：TradeGPT
   • 角色：获取 K 线数据
   • 目标：
     1. 目标 1：获取 EURUSD 1 小时图的 K 线数据
     2. 目标 2：结束

2. 运行 Auto-GPT： 启动 Auto-GPT，它应使用 MetaTrader 插件并加载 K 线数据。

3. 示例响应：

📉 指标（开发中）：

• 相对强弱指数 (RSI)
• 成交量
• 移动平均线（SMA、EMA、WMA、MAE、OsMA、MACD）
• 斐波那契回撤线
• 布林带
• 资金流量指数 (MFI)

Auto-GPT MetaTrader 插件快速上手指南

本指南帮助中国开发者快速将 MetaTrader 4/5 交易账户连接至 Auto-GPT，实现 AI 自动交易、数据获取及账户管理。

环境准备

在开始之前，请确保满足以下系统要求和前置依赖：

• 操作系统：Windows, macOS 或 Linux
• Python 版本：建议 Python 3.8 及以上
• 核心依赖：
  • Auto-GPT (已安装并配置好基础环境)
  • pip 包管理工具
  • 额外 Python 库：ta, myfxbook (安装步骤中会包含)
• 第三方服务账号 (需提前注册并获取密钥)：
  • MetaAPI：用于连接 MT4/MT5 经纪商账户 (注意：获取 K 线数据通常需要付费账户)。
  • MyFxBook：用于连接交易账户历史数据。
  • FCS API：用于获取财经新闻和市场数据 (免费版每月 500 次调用)。
  • LunarCrush：用于获取社区情绪数据 (可选)。

安装步骤

1. 克隆插件仓库

打开终端，克隆本项目并进入目录：

git clone https://github.com/isaiahbjork/Auto-GPT-MetaTrader-Plugin.git
cd Auto-GPT-MetaTrader-Plugin

2. 安装依赖

安装插件所需的 Python 依赖包：

pip install -r requirements.txt

提示：国内用户若下载缓慢，可添加清华源加速： pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

3. 打包插件

将当前文件夹压缩为 .zip 文件，或者直接下载 官方 ZIP 包。假设生成的文件名为 Auto-GPT-MetaTrader-Plugin.zip。

4. 准备 Auto-GPT 环境

如果您尚未安装 Auto-GPT，请先克隆并配置主程序。进入 Auto-GPT 根目录后，务必安装以下额外依赖以避免模块缺失错误：

pip install ta myfxbook

提示：同样推荐使用国内镜像源加速安装。

5. 部署插件文件

将步骤 3 中生成的 .zip 文件复制到 Auto-GPT 项目根目录下的 plugins 文件夹中：

# 假设你在 Auto-GPT 根目录下
cp /path/to/Auto-GPT-MetaTrader-Plugin.zip ./plugins/

6. 配置环境变量

在 Auto-GPT 根目录下，找到 .env.template 文件，复制一份并重命名为 .env：

cp .env.template .env

(注：Linux/Mac 用户若看不到以 . 开头的文件，请使用 ls -a 查看)

7. 填写配置信息

使用文本编辑器打开 .env 文件，在末尾追加以下 MetaTrader 相关配置，并填入您在“环境准备”阶段获取的密钥：

################################################################################
### METATRADER
################################################################################
META_API_ACCOUNT_ID=你的_MetaAPI_账户_ID
META_API_TOKEN=你的_MetaAPI_Token
META_API_REGION=你的区域_例如:new-york,london,singapore
LUNAR_CRUSH_API_KEY=你的_LunarCrush_Key
MY_FX_BOOK_USERNAME=你的_MyFxBook_用户名或邮箱
MY_FX_BOOK_PASSWORD=你的_MyFxBook_密码
FCS_API_KEY=你的_FCS_API_Key

8. 启用插件白名单

在同一个 .env 文件中，搜索 ALLOWLISTED_PLUGINS，将其修改为包含本插件的名称：

################################################################################
### ALLOWLISTED PLUGINS
################################################################################
ALLOWLISTED_PLUGINS=AutoGPTMetaTraderPlugin

基本使用

配置完成后，即可启动 Auto-GPT 测试插件功能。以下示例演示如何让 AI 获取 EURUSD 的 1 小时 K 线数据。

运行测试

1. 启动 Auto-GPT： 在 Auto-GPT 根目录运行启动命令（通常为 python -m autogpt 或根据你安装的版本运行相应脚本）。

2. 输入指令： 当 Auto-GPT 提示输入目标时，按以下方式设定：

   • Name: TradeGPT
   • Role: fetch candlestick data
   • Goals:
     1. fetch candlestick data for the 1 hour chart on EURUSD
     2. Terminate

3. 预期结果： Auto-GPT 将调用 MetaTrader 插件，通过 MetaAPI 获取实时 K 线数据，并在终端输出类似以下的分析结果或原始数据表格。

   (成功标志：终端显示具体的蜡烛图数据，无报错信息)

可用功能概览

成功连接后，您可以尝试用自然语言下达以下指令：

• 交易操作："Place a buy order for 0.1 lot on GBPUSD" (下单)
• 账户查询："Get my current account balance and equity" (查余额)
• 平仓操作："Close all open trades" (全平)
• 数据分析："Analyze the RSI and Moving Averages for BTCUSD" (技术指标分析，部分功能开发中)