REST API

公开接口

以 Markdown 格式查看

基础地址

https://api.6mm.com

服务版本

GET /v1/version

获取服务版本信息。

服务时间

GET /v1/time

获取服务端时间。该接口可用于 API Key 签名前的客户端时间校准。

用户登录

POST /v1/public/user/login

请求参数：

参数类型必填说明
usernamestring是用户名，长度 3 - 32 位
passwordstring是密码，长度 1 - 64 位
deviceIdstring否设备指纹，最多 64 位
deviceNamestring否设备名称，最多 128 位

请求示例：

curl -X POST https://api.6mm.com/v1/public/user/login \
  -H "Content-Type: application/json" \
  -d '{
    "username": "alice",
    "password": "yourPassword",
    "deviceId": "device-001",
    "deviceName": "server-001"
  }'

响应示例：

{
  "code": 0,
  "message": "success",
  "data": {
    "accessToken": "YOUR_ACCESS_TOKEN",
    "accessExpire": 1769676656
  },
  "requestId": "req-login"
}

刷新 Token

POST /v1/public/user/refresh-token

普通接入场景下通过 Cookie 刷新登录态，请保留登录响应返回的 Cookie。

响应字段：

字段类型说明
accessTokenstring新的访问 Token
accessExpireint64访问 Token 过期时间

代理商 SSO

Ticket 换 Token

POST /v1/public/agent-sso/exchange-ticket

请求参数：

参数类型必填说明
ticketstring是代理商服务签发的一次性 ticket
deviceIdstring否设备指纹，最多 64 位

响应字段：

字段类型说明
accessTokenstring访问 Token
accessExpireint64访问 Token 过期时间
redirectPathstring建议跳转路径

Embed Token 换 Token

POST /v1/public/agent-sso/exchange-embed-token

请求参数：

参数类型必填说明
embedTokenstring是代理商服务签发的内嵌交易短期 token
channelIdstring是内嵌 iframe 通道 ID，最多 128 位
deviceIdstring否设备指纹，最多 64 位

响应字段：

字段类型说明
accessTokenstring访问 Token
accessExpireint64访问 Token 过期时间

盈利排行榜

GET /v1/public/leaderboard/pnl?period=30d

请求参数：

参数类型必填说明
periodstring是7d / 30d / 90d

响应字段：

字段类型说明
list[].rankint32排名
list[].userIdstring对外用户 ID
list[].traderstring脱敏交易者名称
list[].volumestring窗口内成交量
list[].pnlAmountstring窗口内已实现盈亏
list[].pnlPctstring盈亏比例，0 - 1 小数
myRankint32当前用户排名；未登录或未上榜时返回 0