Skip to navigation

Giao dịch vĩnh viễn

Giao dịch vĩnh viễn: Agent Java SDK tích hợp v0.3.0, ví dụ, tham số và ngữ nghĩa phản hồi.

View as Markdown

Hướng dẫn này hướng tới Agent Java SDK v0.3.0, Java 8+ và hợp đồng công khai được gắn thẻ. Các ví dụ chạy trong phần phụ trợ của đối tác sau khi khởi tạo client trong Bắt đầu nhanh.

Điều kiện tiên quyết mẫu

Đoạn mã Java chia sẻ những nội dung nhập này. Khởi tạo client bằng cách sử dụng Bắt đầu nhanh và lấy platformUserId từ liên kết đã lưu. ID người dùng/đơn đặt hàng mẫu phải được thay thế bằng các giá trị cố định của riêng bạn.

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

listPerpetualTrades

Mẫu yêu cầu: 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);

Các trường yêu cầu

Cánh đồngJava loạiYêu cầuNghĩa
platformUserIdsjava.util.List<String>ĐúngCung cấp rõ ràng 1–100 ID người dùng nền tảng công khai duy nhất thuộc về đối tác hiện tại; thiếu sót và một mảng trống là không hợp lệ.
symbolStringKHÔNGBộ lọc cặp giao dịch tùy chọn.
orderIdStringKHÔNGID đơn hàng thông thường; không phải là số thứ tự chuyển nhượng đối tác.
startTimeLongKHÔNGBao gồm Unix mili giây; sử dụng cửa sổ lịch sử UTC cố định.
endTimeLongKHÔNGUnix mili giây độc quyền.
limitIntegerKHÔNGMặc định 500; 1–1000.
cursorStringKHÔNGSử dụng nextCursor được trả về với các bộ lọc không thay đổi; dừng khi hasMore sai.

Ví dụ đọc một trang. Đối với các trường bắt buộc, phạm vi trình phát, ngữ nghĩa bộ lọc, giới hạn, con trỏ và số lần thử giới hạn, hãy làm theo Tổng quan về truy vấn. Giữ tất cả các bộ lọc không thay đổi trong khi phân trang; không hiểu lỗi là kết quả trống.

Chi tiết điền giao dịch

Giao diện: trades. Yêu cầu platformUserIds rõ ràng.

Trường datakiểunghĩa
fillIdstringID chi tiết điền giao dịch, tương ứng với bản ghi này entityId
tradeIdstringID giao dịch trùng khớp được liên kết với giao dịch; không thay thế ID chi tiết
orderIdstringID đơn đặt hàng chung mà chi tiết này thuộc về
positionIdstringID vị trí liên quan
symbolstringcặp giao dịch
sidestringHướng mua bán của người chơi này BUY / SELL
roleTypestringKý tự giao dịch của người chơi này MAKER / TAKER
positionSidestringHướng vị trí, được giải thích theo giá trị thực tế LONG / SHORT / BOTH, v.v.
pricestringGiá giao dịch này
quantitystringSố lượng của giao dịch này không phải là tổng số lượng của đơn hàng ban đầu.
tradeValuestringGiá trị danh nghĩa của giao dịch này xuất phát từ danh nghĩa giao dịch
handlingFeestringPhí giao dịch cho giao dịch này vẫn giữ nguyên biểu tượng nguồn và độ chính xác và không tự lấy giá trị tuyệt đối.
realizedPnlstringLãi lỗ thực hiện tương ứng với giao dịch này; không phải lãi và lỗ thả nổi theo thời gian thực của vị thế hiện tại
tradedAtintegerThời gian giao dịch, mili giây; sử dụng trường này để lọc thời gian

Một đơn hàng có thể có nhiều lần điền, cần được lưu chi tiết. Không hợp nhất các bản ghi của những người chơi/điền vai trò khác nhau theo tradeId rồi loại bỏ danh tính bản ghi của họ.

Ví dụ về phong bì phản hồi

Đây là trang trống minh họa, không phải mẫu giao dịch đã hoàn thành. Các bảng trường dành riêng cho tài nguyên ở trên mô tả items[].data.

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

Nguồn và hướng dẫn liên quan