Vị thế vĩnh viễn

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

listCurrentPerpetualPositions

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

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

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.

listPerpetualPositionHistory

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

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

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.

Vị trí: Hiện tại và Lịch sử

Tầm cỡ tính toán của lịch sử roe là pnl / (entryPrice × maxQuantity / leverage) và giao diện trả về trực tiếp giá trị tỷ lệ đã lưu. Khi hiển thị tỷ lệ phần trăm, sử dụng phép tính thập phân và nhân với 100, sau đó thêm %; mẫu số sử dụng ký quỹ danh nghĩa của bản ghi vị thế lịch sử chứ không phải số dư ví tài khoản. Khi giá mở cửa hoặc số lượng vị thế tối đa là 0, đòn bẩy không hợp lệ, v.v. và không thể tính toán, nguồn được lưu là 0. Do đó, không thể suy ra rằng lãi hoặc lỗ là 0 chỉ dựa trên roe=0.

Vị thế hiện tại không có giá đánh dấu theo thời gian thực, lãi và lỗ thả nổi theo thời gian thực, ROE hoặc giá thanh lý theo thời gian thực. Nó phản ánh trạng thái vị thế được lưu trữ và không thể sử dụng thời gian cập nhật và các trường ký quỹ để yêu cầu kết quả kiểm soát rủi ro theo thời gian thực hiện tại.

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

• Nguồn v0.3.0 chính thức
• Tổng quan về truy vấn và phân trang
• Ví tiền tài trợ
• Hướng dẫn nâng cấp