Перейти к навигации
Agent Java SDK

Постоянное торговое исполнение

Бессрочные торговые исполнения: интеграция с Agent Java SDK v0.3.0, примеры, параметры и семантика ответов.

Просмотр в формате Markdown

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

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

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

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

listPerpetualTrades

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

Поля запроса

ПолеJava типНеобходимыйЗначение
platformUserIdsjava.util.List<String>ДаЯвно укажите от 1 до 100 уникальных идентификаторов пользователей общедоступной платформы, принадлежащих текущему партнеру; пропуск и пустой массив недействительны.
symbolStringНетДополнительный фильтр торговых пар.
orderIdStringНетОбычный идентификатор заказа; не номер заказа на передачу партнера.
startTimeLongНетВключительно миллисекунды Unix; используйте фиксированное окно истории UTC.
endTimeLongНетЭксклюзивные миллисекунды Unix.
limitIntegerНетПо умолчанию 500; 1–1000.
cursorStringНетИспользуйте возвращенный nextCursor с неизмененными фильтрами; остановитесь, когда hasMore имеет значение false.

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

Детали торгового заполнения

Интерфейс: trades. Требуется явный platformUserIds.

Поле dataтипзначение
fillIdstringИдентификатор реквизитов торгового заполнения, соответствующий этой записи entityId
tradeIdstringСоответствующий идентификатор транзакции, связанный с транзакцией; не заменяет подробный идентификатор
orderIdstringОбщий идентификатор заказа, к которому относится данная деталь
positionIdstringИдентификатор связанной позиции
symbolstringторговая пара
sidestringНаправление покупки и продажи этого игрока BUY / SELL
roleTypestringПерсонаж транзакции этого игрока MAKER / TAKER
positionSidestringНаправление позиции, поясняется в соответствии с фактическим значением LONG / SHORT / BOTH и т. д.
pricestringЭта цена сделки
quantitystringКоличество этой транзакции не является общим количеством исходного заказа.
tradeValuestringНоминальная стоимость этой сделки определяется условной стоимостью сделки.
handlingFeestringКомиссия за эту транзакцию сохраняет исходный символ и точность и сама по себе не принимает абсолютное значение.
realizedPnlstringРеализованная прибыль и убыток, соответствующие этой сделке; не плавающая прибыль и убыток текущей позиции в реальном времени
tradedAtintegerВремя транзакции, миллисекунды; используйте это поле для фильтрации времени

В заказе может быть несколько исполнений, которые необходимо подробно сохранить. Не объединяйте записи разных игроков/исполняющих роли с помощью tradeId и затем удаляйте их идентификаторы записей.

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

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

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

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