binance-api/docs/exchanges/pacifica/ADAPTER.md

Pacifica 适配文档

— 端点（REST） —

• Markets：/api/v1/info、/api/v1/book、/api/v1/recent_trades（如有）
• Orders：/api/v1/orders/create_market、/api/v1/orders/create、/api/v1/orders/stop/create、/api/v1/orders/cancel、/api/v1/orders/cancel_all、/api/v1/orders/batch、/api/v1/orders（受限）
• Account：/api/v1/account/info、/api/v1/positions、/api/v1/account/update-leverage、/api/v1/account/update-margin-mode
• Subaccounts：/api/v1/subaccounts/create、/api/v1/subaccounts/transfer

— 签名 —

• Header 级：X-PUBKEY/X-TS/X-SIGNATURE（部分 POST 可关闭 header 签名，仅 body 签名）
• Body 级：Ed25519，对 {timestamp, expiry_window, type, data} 的紧凑 JSON 签名；account/agent_wallet 不进签名。
• Agent Wallet：订单创建使用 agent 私钥签名，body 含 agent_wallet。

— WS —

• wss://ws.pacifica.fi/ws，无需 login；subscribe + ping 心跳。
• 频道：prices、book、trades、account_info、account_balance、account_positions、account_orders。
• 标准化映射参见 docs/market/WS_NORMALIZATION.md。

— 常见错误 —

• 400 Verification failed：签名字段不全/不匹配；client_order_id 需 UUID；symbol 需基础符号。
• 403：CDN/白名单限制；可退回 WS 或历史回退方案（若启用）。
• 429/5xx：指数退避（客户端已实现）。