Các điểm cuối công khai

View as Markdown

Cơ sở URL

https://api.6mm.com

Phiên bản dịch vụ

1GET /v1/version

Lấy thông tin phiên bản dịch vụ.

Thời gian máy chủ

1GET /v1/time

Hãy tận dụng thời gian phục vụ. Điểm cuối này có thể được sử dụng để hiệu chỉnh thời gian khách hàng trước khi API Key ký.

Đăng nhập người dùng

1POST /v1/public/user/login

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
usernamestringĐúng vậyTên người dùng, độ dài 3 - 32
passwordstringĐúng vậyMật khẩu, độ dài 1 - 64
deviceIdstringKhôngVân tay thiết bị, lên đến 64 ký tự
deviceNamestringKhôngTên thiết bị, tối đa 128 ký tự

Yêu cầu ví dụ:

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

Ví dụ phản hồi:

1{
2 "code": 0,
3 "message": "success",
4 "data": {
5 "accessToken": "YOUR_ACCESS_TOKEN",
6 "accessExpire": 1769676656
7 },
8 "requestId": "req-login"
9}

Refresh Token

1POST /v1/public/user/refresh-token

Trong các kịch bản tích hợp thông thường, trạng thái đăng nhập được làm mới qua Cookie. Giữ lại Cookie trả về theo phản hồi đăng nhập.

Trường phản hồi:

Lĩnh vựcLoạiMô tả
accessTokenstringToken truy cập mới
accessExpireint64Thời gian hết hạn của Access Token

Đặc vụ SSO

Đổi vé

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

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
ticketstringĐúng vậyVé một lần do dịch vụ đại lý phát hành
deviceIdstringKhôngVân tay thiết bị, lên đến 64 ký tự

Trường phản hồi:

Lĩnh vựcLoạiMô tả
accessTokenstringMã truy cập
accessExpireint64Thời gian hết hạn của Access Token
redirectPathstringĐường dẫn chuyển hướng được đề xuất

Tích hợp Trao đổi Token

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

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
embedTokenstringĐúng vậyToken giao dịch nhúng ngắn hạn do dịch vụ đại lý phát hành
channelIdstringĐúng vậyID kênh iframe nhúng, tối đa 128 ký tự
deviceIdstringKhôngVân tay thiết bị, lên đến 64 ký tự

Trường phản hồi:

Lĩnh vựcLoạiMô tả
accessTokenstringMã truy cập
accessExpireint64Thời gian hết hạn của Access Token

Bảng xếp hạng PnL

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

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
periodstringĐúng vậy7d / 30d / 90d

Trường phản hồi:

Lĩnh vựcLoạiMô tả
list[].rankint32Cấp bậc
list[].userIdstringID người dùng bên ngoài
list[].traderstringTên thương nhân đeo mặt nạ
list[].volumestringKhối lượng giao dịch trong cửa sổ
list[].pnlAmountstringPnL đã thực hiện trong cửa sổ
list[].pnlPctstringTỷ lệ PnL, thập phân từ 0 đến 1
myRankint32Xếp hạng người dùng hiện tại. Trả về 0 nếu chưa xác thực hoặc không xếp hạng