简介¶

Polaris 通过公开 api-gateway 提供类 Binance 风格的 OpenAPI，并配套 WebSocket 行情/用户流与机构侧 FIX 接入。

公开能力覆盖¶

现货行情（REST + WS）
现货交易与订单管理
账户 / 资产 / 钱包
Convert 闪兑
法币及法币 migration 辅助接口
子账户与划转
杠杆划转与资金归集
Payment request
用户数据流（listenKey）

逻辑架构¶

Client
  ├─ HTTPS  → api-gateway (/openapi/*)     → order / mkdata / asset / …
  ├─ WSS    → ws-gateway  (/openapi/quote/*, /openapi/ws/<listenKey>/…)
  └─ TCP FIX→ fix-server  (FIXT.1.1 / FIX 5.0 SP2 acceptor)

REST 的机构（broker）上下文由 HTTP Host 解析（BrokerInterceptor → broker apiDomain）。Host 不正确会返回针对 host 的 INVALID_PARAMETER。

证据来源¶

断言	主要证据
公开 REST 面	`ptrader-api-gateway/.../controller` + Postman OpenAPI 集合
鉴权 / HMAC	`AuthFilter`、api-gateway 内 `API-Authentication-Mechanism` 文档
WS 路径与流	`ptrader-ws-gateway` `WebSocketHandler` + `WS_API_SPOT.md`
FIX 会话契约	Postman `Polaris-FIX-Document`；本地 fix-server 检出目前缺少 `src/`

草稿状态¶

版本 0.1.0-draft。OpenAPI 中响应 schema 多为开放对象，待 DTO 补全 — 见待确认清单。