REST API

Titik Akhir Publik

View as Markdown

URL dasar

https://api.6mm.com

Versi Layanan

GET /v1/version

Dapatkan informasi versi layanan.

Waktu Server

GET /v1/time

Dapatkan waktu server. Endpoint ini dapat digunakan untuk mengkalibrasi waktu klien sebelum API Key penandatanganan.

Login Pengguna

POST /v1/public/user/login

Parameter permintaan:

ParameterTipeWajibDeskripsi
usernamestringYaNama pengguna, panjang 3 - 32
passwordstringYaKata sandi, panjang 1 - 64
deviceIdstringTidakSidik jari perangkat, hingga 64 karakter
deviceNamestringTidakNama perangkat, hingga 128 karakter

Contoh permintaan:

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

Contoh respons:

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

Refresh Token

POST /v1/public/user/refresh-token

Dalam skenario integrasi normal, status login diperbarui melalui Cookie. Simpan Cookie yang dikembalikan berdasarkan respons login.

Bidang respons:

LapanganTipeDeskripsi
accessTokenstringToken akses baru
accessExpireint64Waktu kedaluwarsa Token Akses

Agen SSO

penukaran tiket

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

Parameter permintaan:

ParameterTipeWajibDeskripsi
ticketstringYaTiket sekali pakai yang dikeluarkan oleh layanan agen
deviceIdstringTidakSidik jari perangkat, hingga 64 karakter

Bidang respons:

LapanganTipeDeskripsi
accessTokenstringtoken akses
accessExpireint64Waktu kedaluwarsa Token Akses
redirectPathstringJalur pengalihan yang disarankan

Pertukaran Token Sematkan

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

Parameter permintaan:

ParameterTipeWajibDeskripsi
embedTokenstringYaToken trading embedded berumur pendek yang diterbitkan oleh layanan agen
channelIdstringYaID saluran iframe tertanam, hingga 128 karakter
deviceIdstringTidakSidik jari perangkat, hingga 64 karakter

Bidang respons:

LapanganTipeDeskripsi
accessTokenstringtoken akses
accessExpireint64Waktu kedaluwarsa Token Akses

Papan Peringkat PnL

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

Parameter permintaan:

ParameterTipeWajibDeskripsi
periodstringYa7d / 30d / 90d

Bidang respons:

LapanganTipeDeskripsi
list[].rankint32Pangkat
list[].userIdstringID pengguna eksternal
list[].traderstringNama pedagang bertopeng
list[].volumestringVolume perdagangan di jendela
list[].pnlAmountstringMenyadari PnL di jendela
list[].pnlPctstringRasio PnL, desimal dari 0 ke 1
myRankint32Peringkat pengguna saat ini. Mengembalikan 0 jika tidak terautentikasi atau tidak diberi peringkat