> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.6mm.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.6mm.com/_mcp/server.

# Вічні торгові заповнення

Цей посібник призначений для **Agent Java SDK `v0.3.0`**, Java 8+ і публічного контракту з тегами. Приклади виконуються в серверній частині партнера після ініціалізації `client` у [Швидкий старт](/uk/sdk/agent-sdk/java/quick-start).

## Приклад передумов

Фрагменти Java поділяють ці імпортовані файли. Ініціалізуйте `client` за допомогою швидкого запуску та отримайте `platformUserId` із збереженого зв’язування. Приклади ідентифікаторів користувача/замовлення потрібно замінити вашими постійними значеннями.

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

## `listPerpetualTrades`

Модель запиту: `PerpetualTradesRequest`.

```java
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.                | Обов'язковий | Значення                                                                                                                                           |
| ----------------- | ------------------------ | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `platformUserIds` | `java.util.List<String>` | так          | Явно вкажіть 1–100 унікальних ідентифікаторів користувачів публічної платформи, що належать поточному партнеру; пропуск і порожній масив недійсні. |
| `symbol`          | `String`                 | немає        | Додатковий фільтр торгових пар.                                                                                                                    |
| `orderId`         | `String`                 | немає        | ID звичайного замовлення; не номер замовлення на переказ партнера.                                                                                 |
| `startTime`       | `Long`                   | немає        | Включно Unix мілісекунди; використовуйте фіксоване вікно історії UTC.                                                                              |
| `endTime`         | `Long`                   | немає        | Ексклюзивні мілісекунди Unix.                                                                                                                      |
| `limit`           | `Integer`                | немає        | За замовчуванням 500; 1–1000.                                                                                                                      |
| `cursor`          | `String`                 | немає        | Використовуйте повернутий nextCursor із незмінними фільтрами; зупинятися, коли hasMore невірно.                                                    |

Приклад читає одну сторінку. Для обов’язкових полів, обсягу гравця, семантики фільтра, обмеження, курсору та обмежених повторних спроб див [Огляд запиту](/uk/sdk/agent-sdk/java/perpetual-queries). Зберігайте всі фільтри незмінними під час перегляду сторінок; не інтерпретуйте помилку як порожній результат.

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

Інтерфейс: `trades`. Потрібен явний platformUserIds.

| `data` поле    | типу    | значення                                                                                                                       |
| -------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `fillId`       | string  | Ідентифікатор даних про торгівлю, що відповідає цьому запису entityId                                                          |
| `tradeId`      | string  | Ідентифікатор транзакції, що відповідає транзакції; не замінює детальний ідентифікатор                                         |
| `orderId`      | string  | Загальний ідентифікатор замовлення, до якого належить ця деталь                                                                |
| `positionId`   | string  | Ідентифікатор пов’язаної позиції                                                                                               |
| `symbol`       | string  | торгова пара                                                                                                                   |
| `side`         | string  | Напрям купівлі та продажу цього гравця BUY / SELL                                                                              |
| `roleType`     | string  | Персонаж транзакції цього гравця MAKER / TAKER                                                                                 |
| `positionSide` | string  | Напрямок позиції, пояснений відповідно до фактичного значення LONG / SHORT / BOTH тощо.                                        |
| `price`        | string  | Ця ціна угоди                                                                                                                  |
| `quantity`     | string  | Кількість цієї транзакції не є загальною кількістю оригінального замовлення.                                                   |
| `tradeValue`   | string  | Номінальна вартість цієї операції походить від умовної вартості операції                                                       |
| `handlingFee`  | string  | Комісія за цю транзакцію зберігає вихідний символ і точність і не приймає абсолютного значення.                                |
| `realizedPnl`  | string  | Реалізований прибуток і збиток, що відповідають цій операції; не плаваючий прибуток і збиток поточної позиції в реальному часі |
| `tradedAt`     | integer | Час транзакції, мілісекунди; використовуйте це поле для фільтрації часу                                                        |

Замовлення може мати кілька заповнень, які необхідно детально зберегти. Не об’єднуйте записи різних гравців/заповнюйте ролі за допомогою tradeId, а потім скидайте їхні записи.

## Приклад конверта відповіді

Це ілюстративна порожня сторінка, а не зразок завершеної торгівлі. У наведених вище таблицях полів для певних ресурсів описано заповнені `items[].data`.

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

## Джерело та відповідні посібники

* [Офіційне джерело v0.3.0](https://github.com/6mm-com/agent-java-sdk/tree/54aa3c1)
* [Огляд запиту та розбивка на сторінки](/uk/sdk/agent-sdk/java/perpetual-queries)
* [Гаманець для фінансування](/uk/sdk/agent-sdk/java/funding-wallet)
* [Посібник з оновлення](/uk/sdk/agent-sdk/java/upgrade)