Utenti e risorse

Questa guida è rivolta a Agent Java SDK v0.3.0, Java 8+ e agli appalti pubblici contrassegnati. Gli esempi vengono eseguiti nel backend di un partner dopo aver inizializzato client in Avvio rapido.

Prerequisiti di esempio

Gli snippet Java condividono queste importazioni. Inizializza client utilizzando Quick Start e ottieni platformUserId dall’associazione salvata. Gli ID utente/ordine di esempio devono essere sostituiti con i tuoi valori persistenti.

import com.sixmm.agent.*;
import com.sixmm.agent.model.*;
import java.util.*;

Regole ID utente

platformUserId è l’ID utente esterno 6MM Attualmente è un numero di 10 cifre stringa, ad esempio:

1188041528

Regole:

• Memorizzalo come una stringa, non come un numero intero.
• Non generare, decodificare o dedurre significato da esso.
• Utilizza il tuo ID utente lato partner come agentUserId.
• Persistenza della relazione tra agentUserId, platformUserId e agentOrderNo.

Associa utente

Bind crea o recupera la relazione tra un utente partner e un 6MM utente della piattaforma. Chiamalo quando un utente entra per la prima volta nel flusso di trading o prima del primo trasferimento in 6MM.

import com.sixmm.agent.model.BindRequest;
import com.sixmm.agent.model.BindResponse;
BindResponse resp = client.bind(
        BindRequest.of("agent-user-001")
                .withUsername("alice")
                .withExt("{\"source\":\"web\"}"));
System.out.println(resp.platformUserId);
System.out.println(resp.bindStatus);
System.out.println(resp.isSimulatedUser);

Campi richiesta:

Campi di risposta:

Interroga l’account del partner

import com.sixmm.agent.model.QueryAccountRequest;
import com.sixmm.agent.model.QueryAccountResponse;
QueryAccountResponse resp = client.queryAccount(QueryAccountRequest.of("USDT"));
System.out.println(resp.agentCode);
System.out.println(resp.agentStatus);
resp.assets.forEach(asset -> {
    System.out.println(asset.currency);
    System.out.println(asset.depositBalance);
});

Quando currency è assente, SDK utilizza defaultCurrency.

Interrogare le risorse utente

import com.sixmm.agent.model.QueryUserAssetsRequest;
import com.sixmm.agent.model.QueryUserAssetsResponse;
QueryUserAssetsResponse resp = client.queryUserAssets(
        QueryUserAssetsRequest.of("1188041528"));
System.out.println(resp.walletBalance);
System.out.println(resp.availableBalance);
System.out.println(resp.version);

Campi:

Distinguere i tre portafogli

queryAccount Interroga il conto di margine della piattaforma del commerciante, non il portafoglio dell’utente del commerciante. Questa interfaccia non dispone di parametri environment e non può essere interrogata come risorsa utente simulata.

Interroga i due portafogli della piattaforma degli utenti simulati:

QueryUserAssetsResponse assets = client.queryUserAssets(
        QueryUserAssetsRequest.of(platformUserId)
                .withFunding()
                .withEnvironment(ExecutionEnvironment.SIMULATED));

Interfaccia: POST /v1/agent/query-user-assets. Il finanziamento viene richiesto solo quando includeFunding=true; per impostazione predefinita viene utilizzata la semantica della query della risorsa contratto originale.

Gli importi vengono gestiti come stringhe o BigDecimal, non float/double.

Fonte e guide correlate

• Fonte ufficiale v0.3.0
• Panoramica delle query e impaginazione
• Portafoglio di finanziamento
• Guida all’aggiornamento