Gezinmeye atla
Agent Java SDK

Sürekli Ticaret Dolumları

Sürekli Ticaret Doldurmaları: Agent Java SDK v0.3.0 entegrasyonu, örnekler, parametreler ve yanıt semantiği.

Markdown olarak görüntüle

Bu kılavuz Agent Java SDK v0.3.0, Java 8+ ve etiketli kamu sözleşmesini hedefler. Örnekler, client başlatıldıktan sonra bir iş ortağı arka ucunda çalıştırılır. Hızlı Başlangıç.

Örnek önkoşullar

Java parçacıkları bu içe aktarmaları paylaşır. Hızlı Başlangıç’ı kullanarak client’ı başlatın ve kaydedilen bağlamadan platformUserId’i edinin. Örnek kullanıcı/sipariş kimlikleri kendi kalıcı değerlerinizle değiştirilmelidir.

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

listPerpetualTrades

Talep modeli: 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);

Talep alanları

AlanJava türüGerekliAnlam
platformUserIdsjava.util.List<String>EvetMevcut ortağa ait 1-100 benzersiz genel platform kullanıcı kimliğini açıkça sağlayın; ihmal ve boş bir dizi geçersizdir.
symbolStringHAYIRİsteğe bağlı işlem çifti filtresi.
orderIdStringHAYIRSıradan sipariş kimliği; iş ortağı transfer emri numarası değil.
startTimeLongHAYIRKapsamlı Unix milisaniye; sabit bir UTC geçmiş penceresi kullanın.
endTimeLongHAYIRÖzel Unix milisaniyesi.
limitIntegerHAYIRVarsayılan 500; 1–1000.
cursorStringHAYIRDöndürülen nextCursor öğesini değişmemiş filtrelerle kullanın; hasMore yanlış olduğunda dur.

Örnek bir sayfayı okuyor. Gerekli alanlar, oynatıcı kapsamı, filtre semantiği, limit, imleç ve sınırlı yeniden denemeler için aşağıdaki adımları izleyin Sorguya genel bakış. Sayfalama sırasında tüm filtreleri değiştirmeden tutun; Bir hatayı boş bir sonuç olarak yorumlamayın.

Ticaret doldurma ayrıntıları

Arayüz: trades. Açıkça platformUserIds gerektirir.

data alanıtipAnlam
fillIdstringBu kayda karşılık gelen takas doldurma ayrıntıları kimliği entityId
tradeIdstringİşlemle ilişkili eşleşen işlem kimliği; ayrıntılı kimliğin yerine geçmez
orderIdstringBu detayın ait olduğu genel sipariş kimliği
positionIdstringİlişkili konum kimliği
symbolstringticaret çifti
sidestringBu oyuncunun alış ve satış yönü BUY / SELL
roleTypestringBu oyuncunun işlem karakteri MAKER / TAKER
positionSidestringGerçek değere göre açıklanan konum yönü LONG / SHORT / BOTH vb.
pricestringBu işlem fiyatı
quantitystringBu işlemin miktarı orijinal siparişin toplam miktarı değildir.
tradeValuestringBu işlemin nominal değeri, işlemin kavramsal değerinden gelir.
handlingFeestringBu işleme ilişkin işlem ücreti, kaynak sembolünü ve doğruluğunu korur ve tek başına mutlak değeri almaz.
realizedPnlstringBu işleme ilişkin gerçekleşen kar ve zarar; mevcut pozisyonun gerçek zamanlı değişken kar ve zararı değil
tradedAtintegerİşlem süresi, milisaniye; bu alanı zaman filtreleme için kullanın

Bir siparişin birden fazla dolumu olabilir ve bunların ayrıntılı olarak kaydedilmesi gerekir. Farklı oyuncuların/doldurma rollerinin kayıtlarını tradeId ile birleştirmeyin ve ardından kayıt kimliklerini atmayın.

Örnek yanıt zarfı

Bu, tamamlanmış bir işlemin örneği değil, açıklayıcı boş bir sayfadır. Yukarıdaki kaynağa özgü alan tablolarında doldurulmuş items[].data açıklanmaktadır.

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

Kaynak ve ilgili kılavuzlar