SuperAPI AI 工具集

python-mt5

编程与开发

查看项目

更新于 11-01 09:34

技能介绍

python-mt5 是一项面向 Python 与 MetaTrader 5(MT5)集成的技能指南,用于说明如何通过 MetaTrader5 Python 包连接 MT5 终端,进行行情数据获取、交易下单与持仓管理。

用途 该技能主要服务于需要在 Python 中调用 MT5 交易终端的场景,包括连接终端与账户、读取市场数据、发送交易指令以及查询持仓、挂单和历史记录。资料以 API 速查与流程说明为主,适合作为集成开发时的参考。

主要能力 连接与账户:initialize() 支持自动查找终端、指定终端路径或传入完整参数(login、password、server、timeout、portable);配套 login()、shutdown()、account_info()、terminal_info()、version()。 市场数据:symbols_total()、symbols_get()、symbol_info()、symbol_info_tick()、symbol_select() 用于查询与管理交易品种,使用前需检查 symbol_info.visible。 K 线与 Tick:copy_rates_from()、copy_rates_from_pos()、copy_rates_range() 获取 OHLC 数据,支持 M1 至 MN1 周期;copy_ticks_from()、copy_ticks_range() 获取 Tick 数据,支持 COPY_TICKS_ALL/INFO/TRADE 标志。返回 numpy 数组,含 time、open、high、low、close、tick_volume、spread、real_volume 等列。 市场深度:market_book_add()、market_book_get()、market_book_release() 用于 DOM 数据,仅部分品种可用。 交易:以 request 字典描述订单,先 order_check() 校验保证金与条件,再 order_send() 发送,并检查 retcode 是否为 TRADE_RETCODE_DONE(10009)。支持市价单、挂单、修改 SL/TP、修改与删除挂单、反向平仓等操作类型。 查询:positions_total()/positions_get()、orders_total()/orders_get()、history_orders_、history_deals_ 支持按品种、掩码、ticket 或时间范围查询。 错误处理:last_error() 返回 (code, message),资料列出常见错误码,如自动交易被禁用、连接超时、参数无效、历史数据未找到等。

使用方式 安装:pip install MetaTrader5。基本流程为 initialize() 连接终端,执行数据或交易操作,结束时 shutdown()。时间参数需使用 UTC,示例中使用 pytz 构造带时区的 datetime。项目还提供 scripts/ 下的实用脚本:check_connection.py 检查连接、calc_margin.py 计算保证金、export_rates.py 导出 K 线为 CSV(支持 --dry-run)。

适用场景 适用于量化策略研究、行情数据导出与分析、自动交易执行、持仓与订单监控等需要 Python 与 MT5 交互的开发工作。

限制与前提 资料未说明该技能的收费、平台支持范围或性能指标。使用时需保证 MT5 终端运行且允许自动交易,部分品种不提供 DOM 数据,时间需按 UTC 处理,交易结果必须检查 retcode 与 last_error()。更多 API 常量与结构参见 reference.md,代码示例参见 examples.md。