Posizioni perpetue

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

listCurrentPerpetualPositions

Modello richiesto: CurrentPerpetualPositionsRequest.

import com.sixmm.agent.model.CurrentPerpetualPositionsRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
CurrentPerpetualPositionsRequest request = new CurrentPerpetualPositionsRequest();
request.platformUserIds = Collections.singletonList("1188041528");
request.limit = 100;
request.symbol = "BTCUSDT";
PerpetualResponse response = client.listCurrentPerpetualPositions(request);
System.out.println(response.data.items.size());
System.out.println(response.data.hasMore);
System.out.println(response.data.nextCursor);

Campi richiesta

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.

listPerpetualPositionHistory

Modello richiesto: PerpetualPositionHistoryRequest.

import com.sixmm.agent.model.PerpetualPositionHistoryRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
PerpetualPositionHistoryRequest request = new PerpetualPositionHistoryRequest();
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.listPerpetualPositionHistory(request);
System.out.println(response.data.items.size());
System.out.println(response.data.hasMore);
System.out.println(response.data.nextCursor);

Campi richiesta

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.

Posizioni: attuali e storiche

Il calibro di calcolo della cronologia roe è pnl / (entryPrice × maxQuantity / leverage) e l’interfaccia restituisce direttamente il valore della proporzione salvato. Quando si visualizza la percentuale, utilizzare l’operazione decimale e moltiplicare per 100, quindi aggiungere %; il denominatore utilizza il margine nominale del record storico della posizione, non il saldo del portafoglio del conto. Quando il prezzo di apertura o la quantità massima della posizione è 0, la leva finanziaria non è valida, ecc. e non può essere calcolata, la fonte viene salvata come 0. Pertanto, non si può dedurre che il profitto o la perdita siano 0 solo sulla base di roe=0.

La posizione corrente non ha prezzo di riferimento in tempo reale, profitti e perdite fluttuanti in tempo reale, ROE in tempo reale o prezzo di liquidazione in tempo reale. Riflette lo stato della posizione memorizzata e non può utilizzare i campi dell’ora di aggiornamento e del margine per richiedere i risultati correnti del controllo del rischio in tempo reale.

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

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