Skip to navigation
Agent Java SDK

Pengisian Perdagangan Abadi

Pengisian Perdagangan Abadi: integrasi Agent Java SDK v0.3.0, contoh, parameter, dan semantik respons.

View as Markdown

Panduan ini menargetkan Agent Java SDK v0.3.0, Java 8+, dan kontrak publik yang diberi tag. Contoh dijalankan di backend mitra setelah menginisialisasi client di Mulai Cepat.

Contoh prasyarat

Cuplikan Java membagikan impor ini. Inisialisasi client menggunakan Quick Start dan dapatkan platformUserId dari pengikatan yang disimpan. Contoh ID pengguna/pesanan harus diganti dengan nilai Anda yang tetap.

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

listPerpetualTrades

Model permintaan: 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);

Bidang permintaan

BidangJava ketikDiperlukanArti
platformUserIdsjava.util.List<String>YaSecara eksplisit memberikan 1–100 ID pengguna platform publik unik milik mitra saat ini; kelalaian dan array kosong tidak valid.
symbolStringTIDAKFilter pasangan dagang opsional.
orderIdStringTIDAKID pesanan biasa; bukan nomor pesanan transfer mitra.
startTimeLongTIDAKMilidetik Unix inklusif; gunakan jendela riwayat UTC yang tetap.
endTimeLongTIDAKMilidetik Unix eksklusif.
limitIntegerTIDAKBawaan 500; 1–1000.
cursorStringTIDAKGunakan nextCursor yang dikembalikan dengan filter yang tidak berubah; berhenti ketika hasMore salah.

Contohnya berbunyi satu halaman. Untuk bidang yang wajib diisi, cakupan pemain, semantik filter, batas, kursor, dan percobaan ulang terbatas, ikuti Ikhtisar kueri. Biarkan semua filter tidak berubah saat melakukan paging; jangan menafsirkan kesalahan sebagai hasil kosong.

Detail pengisian perdagangan

Antarmuka: trades. Membutuhkan platformUserIds yang eksplisit.

data bidangjenisarti
fillIdstringID detail pengisian perdagangan, sesuai dengan catatan ini entityId
tradeIdstringID transaksi yang cocok dan terkait dengan transaksi tersebut; tidak menggantikan ID detail
orderIdstringID pesanan umum yang memuat detail ini
positionIdstringID posisi terkait
symbolstringpasangan perdagangan
sidestringArah jual beli pemain ini BUY / SELL
roleTypestringKarakter transaksi pemain ini MAKER / TAKER
positionSidestringArah posisi, dijelaskan berdasarkan nilai sebenarnya LONG / SHORT / BOTH dll.
pricestringHarga transaksi ini
quantitystringKuantitas transaksi ini bukan total kuantitas pesanan awal.
tradeValuestringNilai nominal transaksi ini berasal dari transaksi nosional
handlingFeestringBiaya transaksi untuk transaksi ini mempertahankan simbol sumber dan keakuratannya, dan tidak mengambil nilai absolut dengan sendirinya.
realizedPnlstringRealisasi keuntungan dan kerugian terkait dengan transaksi ini; bukan keuntungan dan kerugian mengambang real-time dari posisi saat ini
tradedAtintegerWaktu transaksi, milidetik; gunakan bidang ini untuk memfilter waktu

Suatu pesanan mungkin memiliki beberapa pengisian, yang harus disimpan secara detail. Jangan menggabungkan catatan pemain yang berbeda/mengisi peran sebanyak tradeId dan kemudian membuang identitas catatan mereka.

Contoh amplop tanggapan

Ini adalah halaman kosong ilustrasi, bukan contoh perdagangan yang telah selesai. Tabel bidang khusus sumber daya di atas menjelaskan items[].data yang terisi.

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

Sumber dan panduan terkait