Skip to navigation
Agent Java SDK

Posisi Abadi

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

listCurrentPerpetualPositions

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

Bidang permintaan

BidangJava ketikDiperlukanArti
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.

listPerpetualPositionHistory

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

Bidang permintaan

BidangJava ketikDiperlukanArti
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.
positionSideStringTIDAKFilter menggunakan enum sisi posisi sumber.
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.

Posisi: Saat Ini dan Historis

data bidangjenisPosisi saat iniPosisi bersejaraharti
positionIdstringmemasokmemasokID Posisi, sesuai dengan entityId
symbolstringmemasokmemasokpasangan perdagangan
positionSidestringmemasokmemasokLONG / SHORT / BOTH dan arah posisi lainnya
statusstringmemasokmemasokString dengan status numerik posisi, lihat ikhtisar kueri
leverageintegermemasokmemasokManfaatkan banyak
marginModestringmemasokmemasokString enumerasi numerik “1” untuk posisi penuh, “2” untuk posisi terisolasi
quantitystringmemasokTidak tersediaKuantitas posisi saat ini
entryPricestringmemasokmemasokHarga pembukaan rata-rata dari posisi tersimpan
marginstringmemasokTidak tersediaJumlah margin posisi saat ini, bukan seluruh saldo dompet kontrak pengguna
maxQuantitystringTidak tersediamemasokJumlah maksimum posisi yang tercatat dalam posisi historis ini
closeQuantitystringTidak tersediamemasokJumlah kumulatif posisi yang ditutup selama siklus hidup posisi historis
closePricestringTidak tersediamemasokHarga penutupan rata-rata yang disimpan
pnlstringTidak tersediamemasokPosisi historis untung dan rugi; jangan digabungkan dengan transaksi realizedPnl untuk sekedar mengulang dan menumpuk
roestringTidak tersediamemasokNilai proporsional pengembalian posisi historis, tidak dikalikan 100; misalnya, "0.043" mewakili 4.3%, "-0.05" mewakili -5%
fundingFeeAccumstringmemasokmemasokAkumulasi biaya pendanaan, mempertahankan simbol dan keakuratan sumber
openedAtintegermemasokmemasokWaktu pembukaan posisi, milidetik
updatedAtintegermemasokTidak tersediaWaktu pembaruan posisi saat ini, milidetik
closedAtintegerTidak tersediamemasokWaktu penutupan, milidetik; gunakan bidang ini untuk memfilter waktu posisi historis

Kaliber penghitungan riwayat roe adalah pnl / (entryPrice × maxQuantity / leverage), dan antarmuka secara langsung mengembalikan nilai proporsi yang disimpan. Saat menampilkan persentase, gunakan operasi desimal dan kalikan dengan 100, lalu tambahkan %; penyebutnya menggunakan margin nominal dari catatan posisi historis, bukan saldo dompet akun. Ketika harga pembukaan atau jumlah posisi maksimum adalah 0, leverage tidak valid, dll. dan tidak dapat dihitung, sumbernya disimpan sebagai 0. Oleh karena itu, tidak dapat disimpulkan bahwa untung atau rugi adalah 0 hanya berdasarkan roe=0.

Posisi saat ini tidak memiliki harga tanda waktu nyata, keuntungan dan kerugian mengambang waktu nyata, ROE waktu nyata, atau harga likuidasi waktu nyata. Ini mencerminkan status posisi yang disimpan dan tidak dapat menggunakan waktu pembaruan dan bidang margin untuk mengklaim hasil pengendalian risiko real-time saat ini.

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