Agave

# 龙舌兰EA 产品描述

## 产品名称

**龙舌兰EA 1.0**  
出品：**郁金香金融科技 / Tulip FinTech**

## 产品定位

龙舌兰EA是一款面向 MetaTrader 5 的黄金自动交易专家顾问，交易品种为 **XAUUSD 黄金**，适合 **1万美分账户（10,000 USC）** 起步测试，并提供 **12个可调风险等级**。

## 核心特性

- **黄金专用**：XAUUSD、XAUUSDc、XAUUSDm 自动识别后缀。
- **12档风险可调**：
  0.15%、0.25%、0.50%、0.75%、1.00%、1.50%、2.00%、3.00%、4.00%、6.00%、10.00%、16.00%
  - 默认：**2.00%**
  - 最大：**16.00%**（仅研究/高风险档）
- **ONNX模型内嵌**：EA不依赖外部模型文件，安装后即可运行。
- **订单参数可配**：Magic、订单注释、成交模式、滑点均可外部设置。
- **成交模式适配**：AUTO / FOK / IOC / RETURN，适配不同经纪商。
- **拆单与容量控制**：大单自动拆分，带总手数、持仓数、保证金和日损保护。
- **MQL5发布保护**：
  - 市场关闭时不开单；
  - 低于最小手数时不开单；
  - 不在允许品种列表时不交易。
- **无外部文件依赖**：发布版为独立 ex5。

## 适用账户

- 账户类型：**美分账户（Cent Account）**
- 建议初始资金：**10,000 USC（1万美分）**
- 建议先使用模拟账户验证
- 品种：XAUUSD / XAUUSDc / XAUUSDm
- 推荐周期：**M30**
- 平台：MetaTrader 5

## 12个风险等级

| 等级 | 风险 |
|---:|---:|
| 1 | 0.15% |
| 2 | 0.25% |
| 3 | 0.50% |
| 4 | 0.75% |
| 5 | 1.00% |
| 6 | 1.50% |
| 7 | **2.00%（默认）** |
| 8 | 3.00% |
| 9 | 4.00% |
| 10 | 6.00% |
| 11 | 10.00% |
| 12 | 16.00% |

> 16%为高风险研究档；实盘建议从0.15%–0.50%开始，确认点差、成交和经纪商限制后再逐步调整。

## 产品特性

- **黄金专项设计**：围绕 XAUUSD 的高波动、趋势与回撤结构建模，不是通用外汇网格。
- **12档风险可调**：从0.15%到16.00%，默认2.00%，可根据账户承受力逐级调整。
- **ONNX神经网络内嵌**：模型随EA一起发布，不依赖外部模型、CSV或运行库文件。
- **三头模型输出**：同时输出胜率、优势度、风险三个维度，用于候选筛选与仓位缩放。
- **p_win风险缩放**：高置信度信号适度加风险，低置信度信号收缩风险，参数K可调。
- **ATR止损 + R倍数止盈**：止损按波动率自适应，止盈以R为单位，避免固定点数硬编码。
- **拆单执行**：大单拆分为多笔，降低单笔成交量限制对策略的影响。
- **容量保护**：总手数、总持仓、保证金、日损等内部保护，防止无限制放大。
- **品种后缀适配**：自动识别 XAUUSDc、XAUUSDm 等经纪商后缀，也支持完整品种名覆盖。
- **成交模式适配**：AUTO/FOK/IOC/RETURN，适配不同经纪商成交规则。
- **MQL5发布保护**：市场关闭不开单、低于最小手数不开单、非允许品种不交易。
- **独立运行**：EA资源内嵌，无外部文件依赖，便于安装和审核。

## 交易机制

1. **周期与候选**
   - 推荐M30周期；
   - 每个决策bar生成多族候选信号，形成候选池；
   - 对候选计算88维市场特征。

2. **模型评分**
   - ONNX三头网络输出：
     - `p_win`：候选盈利概率；
     - `edge`：候选优势度；
     - `risk`：候选风险估计。
   - 依据模型输出进行候选排序与过滤。

3. **入场**
   - 只在市场开市、点差允许、候选有效时尝试入场；
   - ATR决定止损距离；
   - R倍数决定止盈目标；
   - 手数由风险档、账户权益、止损距离和p_win缩放共同决定；
   - 超过最小手数才开单，不足则跳过。

4. **持仓管理**
   - 单品种单篮持仓模式，避免无控制加仓；
   - 最长持有bar数限制，防止趋势失效后无限持仓；
   - 止损/止盈/时间退出由规则统一管理；
   - 大单按拆单粒度执行，减少单笔成交量限制。

5. **风险控制**
   - 风险档决定单笔基础风险；
   - p_win K控制置信度缩放；
   - 拆单、总手数、持仓数、保证金和日损保护共同限制极端情况；
   - 不使用马丁格尔、网格翻倍或亏损加仓。

## 原理简介

龙舌兰EA采用**事件驱动 + 概率评分 + 风险预算**的结构：

- 先从黄金K线中提取趋势、波动、位置、形态、时段等88维特征；
- 再用内嵌ONNX神经网络对候选信号输出胜率、优势和风险；
- 策略层只选择模型评分较高、且满足交易条件的候选；
- 执行层用ATR和R倍数定义退出，用风险档与p_win缩放定义仓位；
- 组合层通过拆单和容量保护，把单笔交易限制在账户可承受范围。

它的核心不是“预测价格必涨必跌”，而是：
1. 找出历史上具有统计优势的候选；
2. 在信号强时适度放大、信号弱时收缩；
3. 用止损和容量控制限制单次错误的影响；
4. 通过长期多次交易累积概率优势。

## 适用与不适用

**适合：**
- 想用1万美分账户测试黄金自动交易的投资者；
- 能接受回撤、理解杠杆风险的交易者；
- 需要可调风险档和品种后缀适配的MT5用户。

**不适合：**
- 追求固定收益或保本的用户；
- 无法承受高回撤、使用高杠杆或生活资金交易的用户；
- 未经过模拟验证就直接上实盘的用户。

## 参数说明

- **Magic number**：同账户多实例必须使用不同魔术码。
- **Order comment prefix**：订单注释前缀，便于对账。
- **Risk tier**：12档风险选择。
- **p_win risk scaling K**：模型置信度风险缩放。
- **Split order chunk size**：单笔拆单手数。
- **Max chunks per candidate**：单候选最大拆单数。
- **Stop loss in ATR**：ATR止损倍数。
- **Take profit in R**：R倍数止盈。
- **Max holding bars**：最长持有K线数；0=关闭。
- **AllowedSymbols**：允许交易的品种白名单，默认XAUUSD,EURUSD。
- **Full symbol override**：完整品种名覆盖。
- **Base symbol / Suffix / AutoSuffix**：黄金品种后缀适配。
- **Filling mode**：成交模式。
- **Allowed slippage**：允许滑点（points）。

## 使用建议

1. 先在模拟账户运行，确认经纪商黄金品种名称和点差；
2. 设置正确的品种后缀（c/m）或直接填写完整品种名；
3. Magic设置唯一值；
4. 风险从0.15%–0.50%开始；
5. 不建议直接使用6%以上档位；
6. 注意美分账户的最小手数、最大手数和保证金限制。

## 风险提示

- 外汇和黄金交易具有高风险，可能导致本金损失。
- 高杠杆、高波动和滑点会放大亏损。
- 16%风险档可能出现大幅回撤，不适合普通实盘账户。
- 历史测试或研究结果不代表未来收益。
- 本产品不保证盈利，不承诺任何固定收益。
- 请在充分理解策略和风险后，使用可承受损失的资金。

## 发布信息

- 产品版本：1.0
- 平台：MetaTrader 5
- 语言：中文/英文参数
- 文件：`AgaveEA_v1_release.ex5`（ONNX内嵌，无外部依赖）
- 开发/发布：郁金香金融科技

---

**免责声明：** 本产品为自动化交易工具，不构成投资建议。使用前请自行评估风险并遵守所在地区及经纪商规则。