Endpoint pubblici

Visualizza come Markdown

Base URL

https://api.6mm.com

Versione di servizio

1GET /v1/version

Ottieni informazioni sulla versione del servizio.

Tempo Server

1GET /v1/time

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

Accesso utente

1POST /v1/public/user/login

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
usernamestringNome utente, lunghezza 3 - 32
passwordstringPassword, 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:

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

Token di aggiornamento

1POST /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

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
ticketstringBiglietto 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

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
embedTokenstringToken di trading embedded di breve durata emesso dal servizio agente
channelIdstringID 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

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
periodstring7d / 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