Skip to navigation
Agent Java SDK

Buku Besar Kontrak

Buku Besar Kontrak: 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.*;

listPerpetualLedger

Model permintaan: PerpetualLedgerRequest.

import com.sixmm.agent.model.PerpetualLedgerRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
PerpetualLedgerRequest request = new PerpetualLedgerRequest();
request.platformUserIds = Collections.singletonList("1188041528");
request.limit = 100;
request.endTime = System.currentTimeMillis();
request.startTime = request.endTime - 3_600_000L;
PerpetualResponse response = client.listPerpetualLedger(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.
assetTypeStringTIDAKKlasifikasi aset sebagaimana dikembalikan oleh buku besar; jangan berasumsi USDT.
changeTypeStringTIDAKJenis perubahan bisnis buku besar, mempertahankan nilai 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.

Catatan buku besar kontrak

Antarmuka: account/ledger. Data yang dikembalikan hanya berisi 11 bidang bisnis berikut dan tidak membawa tanda boolean pesanan.

data bidangjenisarti
ledgerIdstringBuku besar sumber mencatat ID transaksi; transaksi yang sama dapat dipecah menjadi beberapa detail
symbolstringPasangan perdagangan terkait, dapat dihilangkan jika tidak terkait
assetTypestringJenis aset, disimpan berdasarkan nilai sumber; digunakan untuk klasifikasi aset, tidak disimpulkan secara default USDT
changeTypestringJenis usaha perubahan rekening, disimpan sesuai nilai sumber, seperti biaya penanganan, untung dan rugi, transfer; dapat difilter berdasarkan bidang yang sama
amountstringJumlah perubahan rincian ini, angka positif menunjukkan peningkatan, angka negatif menunjukkan penurunan; presisi tetap dipertahankan
walletBalanceBeforestringSaldo dompet sebelum perubahan akun dicatat dalam detail ini
walletBalanceAfterstringSaldo dompet setelah perubahan akun dicatat dalam detail ini
frozenBalanceBeforestringSaldo beku yang dicatat sebelum perubahan akun dicatat dalam rincian ini
frozenBalanceAfterstringSaldo yang dibekukan dicatat dalam detail ini setelah perubahan akun
referenceIdstringNomor bisnis terkait; ditafsirkan sebagai changeType dan tidak dapat dianggap seragam sebagai urutan orderId; “0” menunjukkan bahwa sumber tidak memiliki nomor terkait yang valid
createdAtintegerWaktu pembuatan detail perubahan akun, milidetik; bidang ini digunakan untuk pemfilteran waktu di antarmuka ini

Gunakan saldo sebelum dan sesudah perubahan akun dikembalikan oleh antarmuka. changeType yang berbeda memiliki semantik yang berbeda, dan tidak dapat diasumsikan bahwa setiap jumlah sama dengan walletBalanceAfter − walletBalanceBefore. Tampilan/ringkasan catatan buku besar harus mempertahankan jenis dan identitas detailnya.

Berikut contoh formatnya, menggunakan ID dan jumlah fiktif:

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "platformUserId": "1188041528",
        "entityType": "ACCOUNT_LEDGER",
        "entityId": "900001",
        "data": {
          "ledgerId": "ledger-example-001",
          "symbol": "BTCUSDT",
          "assetType": "USDT",
          "changeType": "HANDLING_FEE",
          "amount": "-0.10000000",
          "walletBalanceBefore": "100.00000000",
          "walletBalanceAfter": "99.90000000",
          "frozenBalanceBefore": "0.00000000",
          "frozenBalanceAfter": "0.00000000",
          "referenceId": "800001",
          "createdAt": 1791590400000
        }
      }
    ],
    "nextCursor": "",
    "hasMore": false
  }
}

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