跳到主要内容

会话密钥

类型：SESSION · 权重：1

状态：已实现。

POST /api/v3/session-key

为交易所钱包会话所绑定的 Canton party 签发（或轮换）一对 HMAC API key。Rocky 网页端在钱包连接后走的就是这条路径；机构接入方通过 机构接入 获得密钥，不需要调用本接口。

本接口不在签名接口面上：没有 X-MBX-APIKEY / signature。请求以钱包会话 bearer token 鉴权，并计入按 IP 的公开权重桶。

请求 —— JSON 请求体

POST /api/v3/session-key
Authorization: Bearer <交易所钱包会话 token>
Content-Type: application/json

{ "party": "<canton-party-id>" }
字段类型必填说明
partystring是Canton party id。会去掉首尾空白；去空白后长度 1–512 个字符。必须与会话绑定的 party 相同。

响应 — 200（值仅为示意）

{
  "userId": "7c2d1f0e-3a4b-5c6d-8e9f-0a1b2c3d4e5f",
  "key": "9f1c…64 hex…",
  "secret": "4b7e…64 hex…"
}
字段类型说明
userIdstring由 party 确定性推导的 UUIDv5（rocky-spot:<party>）：同一 party 永远映射到同一个现货账户，重新连接后看到的余额与订单不变。
keystring64 个十六进制字符；放入 X-MBX-APIKEY 的值。密钥类型为 HMAC。
secretstring64 个十六进制字符；HMAC-SHA256 共享密钥。只返回一次。

每次调用都会吊销该 party 之前签发的会话密钥（标签 spot-session:<party>）并返回一对新密钥；重新连接无法找回旧的 secret。新密钥处于 standard 限流档位。

错误 —— 仅返回 HTTP 状态码，没有 {code,msg} 响应体（429 除外）

HTTP原因
400party 为空或超过 512 个字符，或请求体不是合法 JSON。
401Bearer token 缺失、无效、已吊销或已过期。
403会话未绑定 Canton party，或 party 与会话的 party 不一致。
429-1003 —— 按 IP 的公开权重耗尽。
500数据库故障。