用途:在编辑 src/providers/okx/* 时使用该工作流,实现并维护 OKX 经纪商/提供方集成,遵循 okx-api SDK 最佳实践。
主要能力与要求:
- 参考资料按需加载:SDK 用法与方法名读 references/okx-sdk-usage.md;错误到动作映射读 references/okx-error-map.md;仅在缺少细节时查阅 .trae/okx-api-llm.txt。
- 架构兼容:保持与 src/providers/types.ts(BrokerProvider、MarketDataProvider、OptionsProvider)兼容;OKX 扩展 API 放在 OKX 专属接口(如 OkxTradingProvider)后,通用 provider 方法仍可用;确保 src/providers/broker-factory.ts 能返回 OKX provider 而不破坏适配器。
- 认证与签名:必须提供 API key、secret、passphrase 三项凭证;签名预哈希为 timestamp + UPPERCASE_METHOD + requestPathWithQuery + rawBody;REST 与私有 WebSocket 认证均用 HMAC SHA256 base64,通过 customSignMessageFn;模拟交易传 demoTrading: true。
- 交易与行情最低覆盖:交易含现货、杠杆、永续/期货、期权的下单、撤单/查询与列表;账户含余额、持仓、账单/流水、成交;行情含 ticker、订单簿、成交、K 线、交易产品;WebSocket 含 ticker、订单簿、成交、K 线及账户/订单/持仓订阅。
- 错误与限流:解析并映射 OKX code + msg 到内部错误类别;显式处理已知认证/订单/风控/限流码;对可重试失败应用请求节流与带抖动指数退避重试;不重试无效输入与认证失败。
- 文档:代码变更需更新 src/providers/okx/README.md,示例与当前方法名一致,分别给出一个现货订单、期货订单、期权订单、账户历史、WebSocket 订阅示例,并保持与 references/okx-sdk-usage.md 一致。
限制:资料未提供具体价格、收费、平台支持范围或性能数据;未提供完整代码示例与安装命令。