REST API

Endpoint pubblici

Visualizza come Markdown

Base URL

https://api.6mm.com

Versione di servizio

GET /v1/version

Ottieni informazioni sulla versione del servizio.

Tempo Server

GET /v1/time

Ottieni tempo server. Questo endpoint può essere usato per calibrare il tempo del client prima API Key firmare.

Accesso utente

POST /v1/public/user/login

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
usernamestringSìNome utente, lunghezza 3 - 32
passwordstringSìPassword, lunghezza 1 - 64
deviceIdstringNoImpronta digitale del dispositivo, fino a 64 caratteri
deviceNamestringNoNome del dispositivo, fino a 128 caratteri

Esempio di richiesta:

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

Esempio di risposta:

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

Token di aggiornamento

POST /v1/public/user/refresh-token

Negli scenari di integrazione normali, lo stato di accesso viene aggiornato tramite Cookie. Mantieni il Cookie restituito dalla risposta di accesso.

Campi di risposta:

CampoTipoDescrizione
accessTokenstringNuovo token di accesso
accessExpireint64Tempo di scadenza del token di accesso

Agente SSO

Cambio biglietti

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
ticketstringSìBiglietto una tantum emesso dal servizio agenti
deviceIdstringNoImpronta digitale del dispositivo, fino a 64 caratteri

Campi di risposta:

CampoTipoDescrizione
accessTokenstringToken di accesso
accessExpireint64Tempo di scadenza del token di accesso
redirectPathstringPercorso di reindirizzamento suggerito

Incorpora lo scambio di token

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
embedTokenstringSìToken di trading embedded di breve durata emesso dal servizio agente
channelIdstringSìID canale iframe incorporato, fino a 128 caratteri
deviceIdstringNoImpronta digitale del dispositivo, fino a 64 caratteri

Campi di risposta:

CampoTipoDescrizione
accessTokenstringToken di accesso
accessExpireint64Tempo di scadenza del token di accesso

Classifica PnL

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
periodstringSì7d / 30d / 90d

Campi di risposta:

CampoTipoDescrizione
list[].rankint32Grado
list[].userIdstringID utente esterno
list[].traderstringNome del commerciante mascherato
list[].volumestringVolume di scambi nella finestra
list[].pnlAmountstringHo realizzato PnL nella finestra
list[].pnlPctstringRapporto PnL, decimale da 0 a 1
myRankint32Posizione dell’utente attuale. Restituisce 0 se non autenticati o non classificati