Бессрочные заказы

Это руководство предназначено для Agent Java SDK v0.3.0, Java 8+ и помеченного публичного контракта. Примеры выполняются в серверной части партнера после инициализации client в Быстрый старт.

Пример предварительных условий

Фрагменты Java разделяют этот импорт. Инициализируйте client с помощью быстрого запуска и получите platformUserId из сохраненной привязки. Примеры идентификаторов пользователей/заказов необходимо заменить вашими собственными сохраненными значениями.

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

listCurrentPerpetualOrders

Модель запроса: 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);

Поля запроса

Пример читает одну страницу. Для обязательных полей, области действия игрока, семантики фильтра, ограничения, курсора и ограниченных повторов следуйте инструкциям. Обзор запроса. Сохраняйте все фильтры неизменными при пейджинге; не интерпретируйте ошибку как пустой результат.

listPerpetualOrderHistory

Модель запроса: 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);

Поля запроса

Пример читает одну страницу. Для обязательных полей, области действия игрока, семантики фильтра, ограничения, курсора и ограниченных повторов следуйте инструкциям. Обзор запроса. Сохраняйте все фильтры неизменными при пейджинге; не интерпретируйте ошибку как пустой результат.

Обыкновенные заказы: текущие и история

Текущий: orders/current + orderCategory=NORMAL; История: orders/history + orderCategory=NORMAL.

История заказов включает прекращенные обычные заказы. Каждую запись нельзя считать полностью завершенной только на основании имени интерфейса. Текущая страница заказа — это запрос текущего статуса, а не поток событий заказа.

Условные ордера: текущие и история

Текущий: orders/current + orderCategory=CONDITIONAL; История: orders/history + orderCategory=CONDITIONAL. Оба требуют явного platformUserIds.

Условные заказы не предоставляют filledQuantity, remainingQuantity, avgFilledPrice для обычных заказов. Если вам нужен статус транзакций обычных заказов после их запуска, запрашивайте обычные заказы/транзакции через generatedOrderId и не делайте вывод об объеме транзакции на основе статуса условного заказа.

Пример конверта ответа

Это иллюстративная пустая страница, а не образец завершенной сделки. В приведенных выше таблицах полей для конкретных ресурсов описываются заполненные items[].data.

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

Источник и связанные руководства

• Официальный источник v0.3.0
• Обзор запроса и нумерация страниц
• Финансирование кошелька
• Руководство по обновлению