Skip to navigation
Agent Java SDK

Perintah Abadi

Perintah Abadi: Agent Java SDK integrasi 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.*;

listCurrentPerpetualOrders

Model permintaan: CurrentPerpetualOrdersRequest.

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

Bidang permintaan

BidangJava ketikDiperlukanArti
orderCategoryStringYaNORMAL atau CONDITIONAL; kueri bersyarat memerlukan pengguna eksplisit.
platformUserIdsjava.util.List<String>Bersyarat1–100 ID publik unik; diperlukan untuk pengisian dan pesanan bersyarat. Hilangkan kueri yang didukung untuk cakupan pemain langsung; [] tidak valid.
symbolStringTIDAKFilter pasangan dagang opsional.
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.

listPerpetualOrderHistory

Model permintaan: PerpetualOrderHistoryRequest.

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

Bidang permintaan

BidangJava ketikDiperlukanArti
orderCategoryStringYaNORMAL atau CONDITIONAL; kueri bersyarat memerlukan pengguna eksplisit.
platformUserIdsjava.util.List<String>Bersyarat1–100 ID publik unik; diperlukan untuk pengisian dan pesanan bersyarat. Hilangkan kueri yang didukung untuk cakupan pemain langsung; [] tidak valid.
symbolStringTIDAKFilter pasangan dagang opsional.
orderIdStringTIDAKID pesanan biasa; bukan nomor pesanan transfer mitra.
conditionIdStringTIDAKID pesanan bersyarat; jangan campur dengan orderId.
clientOrderIdStringTIDAKReferensi pesanan klien perdagangan, bukan agentOrderNo.
sideStringTIDAKBUY / SELL filter.
statusStringTIDAKStatus spesifik sumber daya; lihat referensi status.
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.

Perintah biasa: terkini dan sejarah

Saat ini: orders/current + orderCategory=NORMAL; Riwayat: orders/history + orderCategory=NORMAL.

data bidangjenisArti dan ruang lingkup penerapan
symbolstringPasangan perdagangan, seperti BTCUSDT
orderIdstringID pesanan biasa platform
orderCategorystringMemperbaiki NORMAL
clientOrderIdstringNomor pesanan klien yang diberikan oleh sumber pesanan transaksi; bukan kolom yang sama dengan transfer dana merchant agentOrderNo
orderTypestringJenis delegasi, seperti LIMIT, MARKET; nilai pencacahan sebenarnya yang berlaku
sidestringArah jual beli BUY / SELL
statusstringStatus pesanan biasa, lihat ikhtisar kueri
timeInForcestringMasa berlaku/strategi eksekusi transaksi, seperti GTC, IOC, FOK; diinterpretasikan menurut nilai sebenarnya
pricestringharga yang dipercayakan; dapat dihilangkan jika tidak ada harga yang diberikan, dan harga transaksi pasar tidak akan ditambah sendiri.
quantitystringJumlah pesanan asli
filledQuantitystringKuantitas transaksi
remainingQuantitystringKuantitas yang belum ditransaksikan; kueri saat ini mengambil kuantitas − filledQuantity, dan kueri historis mengambil nilai catatan historis
avgFilledPricestringHarga transaksi rata-rata dari bagian yang diselesaikan; mungkin tidak ada nilainya jika tidak selesai
reduceOnlybooleanApakah hanya akan mengurangi posisi
closeOnlybooleanEntah itu hanya digunakan untuk menutup posisi
makerOnlybooleanApakah akan mengeksekusi hanya sebagai Pembuat
leverageintegerManfaatkan banyak; Urutan biasa historis memiliki sumber, dan tatanan biasa saat ini tidak menghasilkan nilai ini
marginModestringModus margin; Urutan biasa historis saat ini mengembalikan string enumerasi numerik, seperti “1”, “2”; pesanan biasa saat ini tidak disediakan
createdAtintegerWaktu pembuatan pesanan, milidetik; gunakan bidang ini untuk memfilter waktu pemesanan historis
updatedAtintegerDelegasikan waktu pembaruan catatan, milidetik

Riwayat pesanan mencakup pesanan biasa yang dihentikan. Setiap catatan tidak dapat dianggap selesai sepenuhnya berdasarkan nama antarmuka saja. Halaman pesanan saat ini adalah kueri status saat ini, bukan aliran peristiwa pesanan.

Perintah bersyarat: terkini dan sejarah

Saat ini: orders/current + orderCategory=CONDITIONAL; Riwayat: orders/history + orderCategory=CONDITIONAL. Keduanya memerlukan platformUserIds secara eksplisit.

data bidangjenisarti
symbolstringpasangan perdagangan
conditionIdstringID pesanan bersyarat, tidak bergantung pada orderId biasa
orderCategorystringMemperbaiki CONDITIONAL
generatedOrderIdstringID pesanan biasa dihasilkan setelah pemicuan; dapat dihilangkan jika tidak dibuat
clientOrderIdstringNomor pesanan klien dari pesanan bersyarat, dikeluarkan jika ada
sidestringBUY / SELL
orderTypestringJenis pesanan pasca-pemicu, ditafsirkan berdasarkan nilai sebenarnya
triggerTypestringJenis aturan pemicu, dijelaskan oleh enumerasi sumber sebenarnya
workingTypestringJenis pekerjaan/sumber harga yang memicu harga, ditafsirkan sebagai pencacahan sebenarnya
timeInForcestringMasa berlaku/strategi eksekusi pesanan setelah dipicu
pricestringHarga pesanan setelah dipicu, dikeluarkan ketika sumber memiliki nilai
quantitystringJumlah pesanan bersyarat
triggerPricestringharga pemicu
reduceOnlybooleanApakah hanya akan mengurangi posisi
closePositionbooleanApakah akan menggunakan semantik penutupan posisi penuh, jangan bingung dengan closeOnly sebagai bidang yang sama
leverageintegerManfaatkan kelipatan, hasilkan saat bukan nol
marginModestringKelas ini mengembalikan CROSS / ISOLATED, yang merupakan string numerik yang berbeda dari urutan/posisi historis biasa
statusstringStatus pemicu tunggal bersyarat, lihat ikhtisar kueri
triggerStatusstringImplementasi saat ini menggunakan nilai status bersyarat yang sama dengan status
createdAtintegerWaktu pembuatan pesanan bersyarat, milidetik; kondisi sejarah disaring pada saat ini
updatedAtintegerPerbarui waktu, keluaran ketika ada nilai, milidetik
deletedAtintegerHapus waktu tanda, keluaran ketika ada nilai, milidetik; ini bukan bidang waktu transaksi/pembatalan terpadu

Pesanan bersyarat tidak menyediakan filledQuantity, remainingQuantity, avgFilledPrice untuk pesanan biasa. Jika Anda memerlukan status transaksi pesanan biasa setelah dipicu, tanyakan pesanan/transaksi biasa melalui generatedOrderId, dan jangan menyimpulkan volume transaksi dari status pesanan bersyarat.

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