binance-api/docs/pacifica/TODO.zh.md

Pacifica 待办清单（测试与覆盖范围）

说明：本清单用于跟踪 Pacifica 集成尚未覆盖或需增强的能力，优先保证签名一致性、最小下单约束、风控与回退策略。

市场数据（REST/WS）

• 增加 REST/WS 价格、最近成交、K 线测试（含断线重连与一致性校验）
• 历史资金费率、历史价格、历史 K 线查询与字段校验

订单体系

• 实现并测试止损单（Create stop）与仓位 TP/SL（Create position TP/SL）
• 取消止损单（Cancel stop）
• 订单历史、按 ID 查询订单历史（字段映射与分页）
• 批量 API：混合多条 Create/Cancel 的组合场景与失败回滚表现

账户相关

• Account Info/Settings 全字段校验与数值含义确认
• Update margin mode（逐仓/全仓）切换测试
• Update leverage：多符号批量与越界约束
• 历史类：Trade/Funding/Equity/Balance 历史拉取与校验
• 子账户：创建与资金划转（Subaccount fund transfer）

WebSocket（鉴权推送）

• 账户推送：Balance/Margin/Leverage/Info/Positions/Orders/Order updates/Trades
• 市场推送：Prices/Orderbook/Trades/Candle（快照+增量一致性）

安全与签名

• Agent Wallet 全链路测试（含限价/止损/批量混合；先绑定再下单）
• 硬件钱包签名（如有计划）

稳定性与限制

• API-Key 频控/Ratelimit 行为，加入 4xx/429/5xx 的重试与退避策略
• 解决 openOrders 403（鉴权/CDN/白名单）
• 多品种最小约束：tick/lot/min_notional 统一校验与最小 10u 保障

备注

• 所有签名均严格遵循官方“签名实现”，仅对业务字段签名，account/agent_wallet 不参与签名，最终请求体为平铺结构。
• 符号统一归一化为基础符号（如 BTC），与订单簿/下单接口一致。
• 市价单需包含 slippage_percent（如 "0.5"），client_order_id 使用 UUID。

---

还未覆盖/建议补测的 Pacifica 能力

• 市场数据
  • 价格订阅/最近成交/蜡烛线（REST/WS）
  • 历史资金费率、价格、K线查询
• 订单体系
  • 止损单与止盈/止损（Create stop / Create position TP/SL）
  • 取消止损单（Cancel stop）
  • 订单历史、按 ID 查询订单历史
  • 批量操作的组合场景（多 Create+Cancel 混合执行、失败回滚表现）
• 账户相关
  • Account Info/Settings 全字段正确性与数值含义校验
  • Update margin mode（逐仓/全仓切换）
  • Update leverage（多符号批量、越界约束）
  • 资金历史：Trade/Funding/Equity/Balance History
  • 提现（Request withdrawal）与失败/风控错误处理
  • 子账户：创建后资金划转（Subaccount fund transfer）
• WebSocket（鉴权与推送）
  • 账户类推送：Balance/Margin/Leverage/Info/Positions/Orders/Order updates/Trades
  • 市场类推送：Prices/Orderbook/Trades/Candle（断线重连与快照/增量一致性）
• 安全与签名
  • Agent Wallet 绑定/签名全链路回归（含限价/止损/批量混合）
  • 硬件钱包签名（如有计划）
• 运维与限制
  • API-Key 频控/Ratelimit 行为与退避策略
  • 错误码覆盖与自动重试策略（400/401/403/422/429/5xx）
• 其他
  • 最小下单约束跨品种验证（tick/lot/min_notional 差异）
  • openOrders 的权限/网络策略（目前 403，需要与官方确认）

参考文档（按模块）：

• 市场与订单簿: https://docs.pacifica.fi/api-documentation/api/rest-api/markets/get-orderbook
• 市价/限价/止损/批量/撤单: https://docs.pacifica.fi/api-documentation/api/rest-api/orders/create-market-order https://docs.pacifica.fi/api-documentation/api/rest-api/orders/create-limit-order https://docs.pacifica.fi/api-documentation/api/rest-api/orders/batch-order https://docs.pacifica.fi/api-documentation/api/rest-api/orders/cancel-order
• 签名实现: https://docs.pacifica.fi/api-documentation/api/signing/implementation
• 账户/杠杆/模式/历史类接口：文档左侧 API 栏的 Account 分组页面（资金、权益、历史、设置等）