验签换会话

POST/api/v1/auth/verify公开

Trading API价 E4 · 量 E2 · 金额 E6（整数）YES | NO

校验顺序：先比对原文、再验签、最后消费 nonce——顺序反了会被廉价登录阻断。成功返回 Bearer 会话；同一地址任何入口登录得到同一 trader。signature/bytes 是钱包 signPersonalMessage 返回值的直接透传（base64）。

请求体

addressstring必填
钱包地址
示例"0x3f1a9c2e7b4…a7b8c9d0e1f"
signaturestring必填
钱包 signPersonalMessage 返回的签名（base64 透传）
bytesstring必填
被签原文（base64 透传；校验是对原文比对，不要自行拼装）

响应

200会话已签发

tokenstring
Bearer 会话令牌
示例"eyJhbGciOiJIU…<signature>"
addressstring
会话地址
示例"0x3f1a9c2e7b4…a7b8c9d0e1f"
expiresAtint64
epoch 毫秒，按空闲窗口算
示例1758240000000

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。

请求

curl -X POST "$BASE_URL/api/v1/auth/verify" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0x3f1a9c2e7b4d5e6f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f",
    "signature": "<base64 wallet signature>",
    "bytes": "<base64 signed message bytes>"
  }'

响应

会话已签发

{
  "token": "eyJhbGciOiJIUzI1NiJ9.<payload>.<signature>",
  "address": "0x3f1a9c2e7b4d5e6f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f",
  "expiresAt": 1758240000000
}