本文基于 OKX Quant Trading、MultiCharts、API Key、期货仓位倍数、加密资产现货、OCO 组合、合约比例、交易接口调试等关键词撰写，旨在帮助你把 MultiCharts 与 OKX 打通，让程序化交易如行云流水。
一、前期准备：获取 OKX API 凭证
- 登录 OKX 账户后台，依次进入「API 管理 → 创建 API key」。
- 记住「API Key」「Secret Key」「Passphrase」三组字符串。
- 勾选「读取」「交易」权限并绑定可信 IP，避免后续出现「Invalid API-key」报错。
二、配置 OKX 期货 Broker Profile
步骤 1：进入设置界面
在 MultiCharts →「文件」→「经纪商档案」，点击「新建」并选择 OKX Futures，随后出现两个关键页签：Main（主要） 与 Contracts Ratio（合约比例）。
步骤 2：Main 页签逐项填写
| 模块 | 参数 | 操作说明 |
|---|---|---|
| Connectivity（连接） | API Key、Secret Key、Passphrase | 严格区分大小写，复制粘贴避免空格。 |
| Currency | 择取结算本位（如 USDT 或 USD）。 | |
| Server | 与创建 API 时的地域节点一致；若开 Demo 请勾 Demo。 | |
| Default Order Settings（下单默认值） | Time in Force | 选择 GTC（一直有效）或 IOC（立即成交）。 |
| Orders request waiting limits | 开启后，MultiCharts 会自动限频，防止撞 OKX 1 min 20 次上限。 | |
| Isolated Margin Mode | 打开即可把单一期货仓位的保证金与账户其他资金隔离。 | |
| Reduce Only | 平仓时强制单向减仓，绕过 OKX 最小名义值的限制。 | |
| Global（全局） | Timing security | 建议 5000 ms；防止时间漂移引发拒绝。 |
| Use heartbeats | 断线后 3 秒自动重连。 | |
| Show Error pop-up alert | 建议勾选，可第一时间看到拒绝原因。 |
步骤 3：确认合约比例（Contracts Ratio）
以 AVAX-USDT-SWAP 为例，该合约的比例系数是 0.1。
- MultiCharts 指令「买 1 手」→ OKX 真实成交 0.1 手（10 %）。
- 若 OKX 单次最小名义值需 5 USDT，在 MultiCharts 最少输入「50 手」才能符合监管。
三、OKX 期货订单与仓位细节解析
支持的订单类型
全部机器人喂单：Market、Limit、Stop、Stop-Limit。
OCO（One-Cancels-Other）组合由 MultiCharts 本地模拟成交，即一旦其中一个单成交，MC 立即取消剩余单，但仍存在瞬间被抢先吃掉的风险。
盈亏计算方式
- equity、浮动盈亏 均由 MultiCharts 本地实时计算；OKX 只返回“净仓口”。
- 若需在图表与经纪商仓口完全同步，可参考文末「策略 ↔ 账户仓同步器」章节。
四、配置 OKX 现货 Broker Profile
与期货配置重叠部分
连接字段、时间窗口、心跳检测、弹窗报警等与期货完全一致，不再赘述。
新增重点：现货仓位模拟
OKX 现货基于「币种钱包」，不会主动告诉 MultiCharts 你的持仓。
操作要点：
- 首次连接 → MC 默认空仓。
- Lookup → 拉取历史订单，本地重建仓位。仅为「MC 发出过的订单」。
- Recalculate → 指定日期开始重算；若你曾在钱包里手动转币，请忽略。
注意：现货模式佣金实时扣除——MC「开仓量」最终会比下单量略少，平仓务必使用 From Broker To Strategy MP Synchronizer。
五、常见问题与解答（FAQ）
Q1：为什么 Broker Profile 点 Connect 一直打转不连上？
A：检查三点：
① 在 Leverage 页签点击「Lookup」后再连接；
② 查看「Order and Position Tracker → Logs」确认是否时间漂移 —— 右键 Win 任务栏 →「调整日期/时间 → 立即同步」；
③ 报错「Invalid API-key…」多半是 IP 未绑定或权限不足，重新生成。
Q2：下单被驳回「Order’s Notional must be ≥ 5.0 USDT」怎么办？
A：
- 检查「Contract Ratio」，计算最终成交数量 = MC 手数 × 比例；
- 若要平仓，勾选「Reduce Only」即可跳过最低名义值限制。
Q3：Spot 支持 Stop-Market 单吗？
A：不支持。OKX Spot 原生接口仅 Market、Limit、Stop-Limit；若想实现保护性止损，可用本地 Stop-Limit 或借助 OCO 组合 智能替换。
Q4：可以混用期货与现货 API 吗？
A：可以。在 MultiCharts 里分别建立「OKX Futures」与「OKX Spot」两套档案，互不干扰，也能同时在不同图表运行。
Q5：合约比例在哪里查看或修改？
A：路径 → 「经纪商档案 → OKX Settings → Contracts Ratio」。OKX 官方每日调降或调升杠杆倍数后，MC 会推送到本地，无需手动改。
六、三步走完，即可开始实盘
- 校验最小委托量：把 MC 手数 与 Contract Ratio 以及 OKX 官方规则乘一遍，确保 ≥ Minimum Notional；
- 启动数据馈送：文件 → QuoteManager → Add Symbol → From Data Source → OKX；
- 绑定行情与经纪商：双击图表 → Format Symbol → Settings 中将「Data Source」与「Broker」绑定到刚建好的 OKX Broker Profile。
七、进阶技巧小结
- 跨品种 Beta 套利：在两张图表同时加载 BTC-USDT-SWAP（期货）与 BTCUSDT（现货），利用 MC 的 Portfolio Trader 回测对冲收益。
- 沙盒回测：点击 Demo 复选框，所有撮合在 OKX 模拟盘完成，零手续费也能验证策略逻辑。
- 单 IP 限频：建议把 MC 部署在海外云主机，通过固定出口 IP 绑定，可避免因家用宽带 IP 跳动被临时锁单。
至此，OKX 期货与现货的接口就与您熟悉的 MultiCharts 无缝衔接。祝你交易顺利，量化长青。