### 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：指数退避（客户端已实现）。


