okx-trading

OKX 提供商 Broker 技能

编辑 src/providers/okx/* 时使用此工作流。

1. 仅加载所需参考资料

• 如需了解 SDK 用法模式和方法名称，请阅读 references/okx-sdk-usage.md。
• 如需了解错误到操作的映射，请阅读 references/okx-error-map.md。
• 如需查看完整源代码上下文，仅在缺少详细信息时参考 .trae/okx-api-llm.txt。

2. 保持架构兼容性

• 保持与 src/providers/types.ts（BrokerProvider、MarketDataProvider、OptionsProvider）的兼容性。
• 将 OKX 专属的扩展 API 放在 OKX 提供商接口后面（例如 OkxTradingProvider），同时确保通用提供商方法正常工作。
• 确保 src/providers/broker-factory.ts 能够返回 OKX 提供商，且不会导致适配器失效。

3. 遵守身份验证和签名规则

• 必须提供全部三项凭据：API 密钥、密钥、密码短语。
• 使用 OKX 签名预哈希：timestamp + UPPERCASE_METHOD + requestPathWithQuery + rawBody。
• REST 和私有 WebSocket 身份验证均使用 HMAC SHA256 base64 签名，通过 customSignMessageFn 实现。
• 模拟交易时传入 demoTrading: true。

4. 交易和市场覆盖范围最低要求

• 交易：现货、保证金、掉期/期货、期权的下单、撤单/查询和列表。
• 账户：余额、持仓、账单/交易记录、成交记录。
• 市场数据：行情、订单簿、交易、K 线、交易品种。
• WebSocket：订阅行情、订单簿、交易、K 线、账户/订单/持仓。

5. 错误和速率限制行为

• 解析 OKX 的 code + msg 错误，并将其映射到内部错误类别。
• 明确处理已知的身份验证/订单/风险/速率限制代码。
• 对可重试的失败应用请求限流，并使用带抖动的指数退避策略进行重试。
• 不要重试无效输入或身份验证失败。

6. 代码变更的文档要求

• 更新 src/providers/okx/README.md，示例须与当前方法名称一致。
• 以下各提供一个示例：现货下单、期货下单、期权下单、账户历史记录、WebSocket 订阅。
• 示例应符合 SDK 实际用法，并与 references/okx-sdk-usage.md 保持一致。