Vai alla navigazione
Agent Java SDK

Riempimenti commerciali perpetui

Perpetual Trade Fills: integrazione di Agent Java SDK v0.3.0, esempi, parametri e semantica della risposta.

Visualizza come Markdown

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.*;

listPerpetualTrades

Modello richiesto: PerpetualTradesRequest.

import com.sixmm.agent.model.PerpetualTradesRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
PerpetualTradesRequest request = new PerpetualTradesRequest();
request.platformUserIds = Collections.singletonList("1188041528");
request.limit = 100;
request.symbol = "BTCUSDT";
request.endTime = System.currentTimeMillis();
request.startTime = request.endTime - 3_600_000L;
PerpetualResponse response = client.listPerpetualTrades(request);
System.out.println(response.data.items.size());
System.out.println(response.data.hasMore);
System.out.println(response.data.nextCursor);

Campi richiesta

CampoTipo JavaNecessarioSenso
platformUserIdsjava.util.List<String>SÌFornire esplicitamente da 1 a 100 ID utente univoci della piattaforma pubblica appartenenti al partner attuale; l’omissione e un array vuoto non sono validi.
symbolStringNOFiltro opzionale per le coppie di scambio.
orderIdStringNOID dell’ordine ordinario; non un numero di ordine di trasferimento del partner.
startTimeLongNOMillisecondi Unix inclusi; utilizzare una finestra della cronologia UTC fissa.
endTimeLongNOMillisecondi Unix esclusivi.
limitIntegerNOPredefinito 500; 1–1000.
cursorStringNOUtilizza il nextCursor restituito con i filtri invariati; interrompere quando hasMore è falso.

L’esempio legge una pagina. Per i campi obbligatori, ambito del giocatore, semantica del filtro, limite, cursore e tentativi limitati, seguire Panoramica delle query. Mantieni invariati tutti i filtri durante la paginazione; non interpretare un errore come un risultato vuoto.

Dettagli di riempimento commerciale

Interfaccia: trades. Richiede platformUserIds esplicito.

campo data.tipoSenso
fillIdstringID dettagli trade fill, corrispondente a questo record entityId
tradeIdstringL’ID transazione corrispondente associato alla transazione; non sostituisce l’ID dettagliato
orderIdstringL’ID ordine generale a cui appartiene questo dettaglio
positionIdstringID posizione associata
symbolstringcoppia commerciale
sidestringLa direzione di acquisto e vendita di questo giocatore BUY / SELL
roleTypestringIl carattere della transazione di questo giocatore MAKER / TAKER
positionSidestringDirezione della posizione, spiegata in base al valore effettivo LONG / SHORT / BOTH ecc.
pricestringQuesto prezzo di transazione
quantitystringLa quantità di questa transazione non è la quantità totale dell’ordine originale.
tradeValuestringIl valore nominale di questa transazione deriva dal nozionale della transazione
handlingFeestringLa commissione per questa transazione mantiene il simbolo e l’accuratezza della fonte e non assume da sola il valore assoluto.
realizedPnlstringIl profitto e la perdita realizzati corrispondenti a questa transazione; non i profitti e le perdite fluttuanti in tempo reale della posizione corrente
tradedAtintegerTempo di transazione, millisecondi; utilizzare questo campo per il filtraggio temporale

Un ordine può avere più esecuzioni, che dovrebbero essere salvate in dettaglio. Non unire i record di giocatori diversi/riempire ruoli tramite tradeId per poi eliminare le loro identità record.

Busta di risposta di esempio

Questa è una pagina vuota illustrativa, non un esempio di un’operazione completata. Le tabelle dei campi specifici della risorsa sopra descrivono il items[].data popolato.

{"code":0,"message":"success","data":{"items":[],"nextCursor":"","hasMore":false}}

Fonte e guide correlate