REST API

公共端點

以 Markdown 格式查看

基礎 URL

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"
}

刷新令牌

POST /v1/public/user/refresh-token

在一般整合情境下，登入狀態會透過 Cookie 重新更新。請保留登入回應時回傳的 Cookie。

回應欄位：

場地類型描述
accessTokenstring新存取令牌
accessExpireint64存取權杖的有效期限

特工 SSO

換票

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

請求參數：

參數類型必修描述
ticketstring是的由代理服務開具的一次性票券
deviceIdstring不裝置指紋，最多可輸入 64 個字元

回應欄位：

場地類型描述
accessTokenstring存取令牌
accessExpireint64存取權杖的有效期限
redirectPathstring建議重定向路徑

Embed 代幣交易所

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

請求參數：

參數類型必修描述
embedTokenstring是的由代理服務發行的短命嵌入式交易代幣
channelIdstring是的嵌入 iframe 通道 ID，最多 128 個字元
deviceIdstring不裝置指紋，最多可輸入 64 個字元

回應欄位：

場地類型描述
accessTokenstring存取令牌
accessExpireint64存取權杖的有效期限

PnL 排行榜

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

請求參數：

參數類型必修描述
periodstring是的7d / 30d / 90d

回應欄位：

場地類型描述
list[].rankint32軍階
list[].userIdstring外部使用者識別碼
list[].traderstring蒙面商人名稱
list[].volumestring窗口內的交易量
list[].pnlAmountstring視窗中實現的PnL
list[].pnlPctstringPnL 比率，從 0 到 1
myRankint32目前使用者的等級。若未認證或未排名，退貨0