Đơn đặt hàng 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.*;

listCurrentPerpetualOrders

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

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.

listPerpetualOrderHistory

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

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.

Lệnh thông thường: hiện tại và lịch sử

Hiện tại: orders/current + orderCategory=NORMAL; Lịch sử: orders/history + orderCategory=NORMAL.

Lịch sử đơn hàng bao gồm các đơn hàng thông thường đã chấm dứt. Mỗi bản ghi không thể được coi là hoàn thành đầy đủ nếu chỉ dựa vào tên giao diện. Trang đặt hàng hiện tại là truy vấn trạng thái hiện tại, không phải luồng sự kiện đặt hàng.

Lệnh có điều kiện: hiện tại và lịch sử

Hiện tại: orders/current + orderCategory=CONDITIONAL; Lịch sử: orders/history + orderCategory=CONDITIONAL. Cả hai đều yêu cầu platformUserIds rõ ràng.

Lệnh có điều kiện không cung cấp filledQuantity, remainingQuantity, avgFilledPrice cho các lệnh thông thường. Nếu bạn cần trạng thái giao dịch của các lệnh thông thường sau khi kích hoạt, hãy truy vấn các lệnh/giao dịch thông thường thông qua generatedOrderId và không suy ra khối lượng giao dịch từ trạng thái lệnh có điều kiện.

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