Przejdź do nawigacji
Agent Java SDK

Nieustanne uzupełnianie handlu

Perpetual Trade Fills: Agent Java SDK integracja v0.3.0, przykłady, parametry i semantyka odpowiedzi.

Zobacz jako Markdown

Ten przewodnik jest przeznaczony dla Agent Java SDK v0.3.0, Java 8+ i oznaczonych zamówień publicznych. Przykłady działają w zapleczu partnera po inicjalizacji client w Szybki start.

Przykładowe wymagania wstępne

Fragmenty Java dzielą ten import. Zainicjuj client za pomocą Szybki start i uzyskaj platformUserId z zapisanego powiązania. Przykładowe identyfikatory użytkowników/zamówień należy zastąpić własnymi, utrwalonymi wartościami.

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

listPerpetualTrades

Zapytaj o model: 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);

Pola żądania

PoleJava typWymaganyOznaczający
platformUserIdsjava.util.List<String>TakJawnie podaj 1–100 unikalnych identyfikatorów użytkowników platformy publicznej należących do bieżącego partnera; pominięcie i pusta tablica są nieprawidłowe.
symbolStringNIEOpcjonalny filtr par handlowych.
orderIdStringNIEZwykły identyfikator zamówienia; a nie numer zamówienia przeniesienia partnera.
startTimeLongNIEWłącznie z milisekundami Uniksa; użyj stałego okna historii UTC.
endTimeLongNIEEkskluzywne milisekundy Uniksa.
limitIntegerNIEDomyślnie 500; 1–1000.
cursorStringNIEUżyj zwróconego nextCursor z niezmienionymi filtrami; przestań, gdy hasMore ma wartość fałszywą.

Przykład czyta jedną stronę. Aby zapoznać się z wymaganymi polami, zakresem gracza, semantyką filtra, limitem, kursorem i ograniczonymi próbami, wykonaj następujące czynności Przegląd zapytań. Zachowaj wszystkie filtry niezmienione podczas stronicowania; nie interpretuj błędu jako pustego wyniku.

Szczegóły wypełnienia transakcji

Interfejs: trades. Wymaga wyraźnego platformUserIds.

Pole data.typoznaczający
fillIdstringIdentyfikator szczegółów wypełnienia transakcji, odpowiadający temu rekordowi entityId
tradeIdstringPasujący identyfikator transakcji powiązany z transakcją; nie zastępuje szczegółowego identyfikatora
orderIdstringOgólny identyfikator zamówienia, do którego należy ten szczegół
positionIdstringIdentyfikator powiązanego stanowiska
symbolstringpara handlowa
sidestringKierunek kupna i sprzedaży tego gracza BUY / SELL
roleTypestringZnak transakcji tego gracza MAKER / TAKER
positionSidestringKierunek pozycji, objaśniony zgodnie z rzeczywistą wartością LONG / SHORT / BOTH itd.
pricestringTa cena transakcyjna
quantitystringIlość tej transakcji nie jest całkowitą ilością pierwotnego zamówienia.
tradeValuestringWartość nominalna tej transakcji wynika z nominału transakcji
handlingFeestringOpłata transakcyjna za tę transakcję zachowuje symbol źródłowy i dokładność i sama w sobie nie przyjmuje wartości bezwzględnej.
realizedPnlstringZrealizowane zyski i straty odpowiadające tej transakcji; a nie zmienny zysk i strata bieżącej pozycji w czasie rzeczywistym
tradedAtintegerCzas transakcji, milisekundy; użyj tego pola do filtrowania czasu

Zamówienie może mieć wiele wypełnień, które należy szczegółowo zapisać. Nie łącz rekordów różnych graczy/nie wypełniaj ról do tradeId, a następnie odrzucaj ich tożsamości rekordowe.

Przykładowa koperta odpowiedzi

To jest przykładowa pusta strona, a nie próbka zakończonej transakcji. Powyższe tabele pól specyficznych dla zasobu opisują zapełnione items[].data.

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

Źródło i powiązane przewodniki