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

# Nieustanne uzupełnianie handlu

Ten przewodnik jest przeznaczony dla **Agent Java SDK `v0.3.0`**, Java 8+ i oznaczonych zamówień publicznych. Przykłady działają w zapleczu partnera po inicjalizacji `client` w [Szybki start](/pl/sdk/agent-sdk/java/quick-start).

## Przykładowe wymagania wstępne

Fragmenty Java dzielą ten import. Zainicjuj `client` za pomocą Szybki start i uzyskaj `platformUserId` z zapisanego powiązania. Przykładowe identyfikatory użytkowników/zamówień należy zastąpić własnymi, utrwalonymi wartościami.

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

## `listPerpetualTrades`

Zapytaj o model: `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);
```

### Pola żądania

| Pole              | Java typ                 | Wymagany | Oznaczający                                                                                                                                                    |
| ----------------- | ------------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `platformUserIds` | `java.util.List<String>` | Tak      | Jawnie podaj 1–100 unikalnych identyfikatorów użytkowników platformy publicznej należących do bieżącego partnera; pominięcie i pusta tablica są nieprawidłowe. |
| `symbol`          | `String`                 | NIE      | Opcjonalny filtr par handlowych.                                                                                                                               |
| `orderId`         | `String`                 | NIE      | Zwykły identyfikator zamówienia; a nie numer zamówienia przeniesienia partnera.                                                                                |
| `startTime`       | `Long`                   | NIE      | Włącznie z milisekundami Uniksa; użyj stałego okna historii UTC.                                                                                               |
| `endTime`         | `Long`                   | NIE      | Ekskluzywne milisekundy Uniksa.                                                                                                                                |
| `limit`           | `Integer`                | NIE      | Domyślnie 500; 1–1000.                                                                                                                                         |
| `cursor`          | `String`                 | NIE      | Użyj zwróconego nextCursor z niezmienionymi filtrami; przestań, gdy hasMore ma wartość fałszywą.                                                               |

Przykład czyta jedną stronę. Aby zapoznać się z wymaganymi polami, zakresem gracza, semantyką filtra, limitem, kursorem i ograniczonymi próbami, wykonaj następujące czynności [Przegląd zapytań](/pl/sdk/agent-sdk/java/perpetual-queries). Zachowaj wszystkie filtry niezmienione podczas stronicowania; nie interpretuj błędu jako pustego wyniku.

## Szczegóły wypełnienia transakcji

Interfejs: `trades`. Wymaga wyraźnego platformUserIds.

| Pole `data`.   | typ     | oznaczający                                                                                                                     |
| -------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `fillId`       | string  | Identyfikator szczegółów wypełnienia transakcji, odpowiadający temu rekordowi entityId                                          |
| `tradeId`      | string  | Pasujący identyfikator transakcji powiązany z transakcją; nie zastępuje szczegółowego identyfikatora                            |
| `orderId`      | string  | Ogólny identyfikator zamówienia, do którego należy ten szczegół                                                                 |
| `positionId`   | string  | Identyfikator powiązanego stanowiska                                                                                            |
| `symbol`       | string  | para handlowa                                                                                                                   |
| `side`         | string  | Kierunek kupna i sprzedaży tego gracza BUY / SELL                                                                               |
| `roleType`     | string  | Znak transakcji tego gracza MAKER / TAKER                                                                                       |
| `positionSide` | string  | Kierunek pozycji, objaśniony zgodnie z rzeczywistą wartością LONG / SHORT / BOTH itd.                                           |
| `price`        | string  | Ta cena transakcyjna                                                                                                            |
| `quantity`     | string  | Ilość tej transakcji nie jest całkowitą ilością pierwotnego zamówienia.                                                         |
| `tradeValue`   | string  | Wartość nominalna tej transakcji wynika z nominału transakcji                                                                   |
| `handlingFee`  | string  | Opłata transakcyjna za tę transakcję zachowuje symbol źródłowy i dokładność i sama w sobie nie przyjmuje wartości bezwzględnej. |
| `realizedPnl`  | string  | Zrealizowane zyski i straty odpowiadające tej transakcji; a nie zmienny zysk i strata bieżącej pozycji w czasie rzeczywistym    |
| `tradedAt`     | integer | Czas transakcji, milisekundy; użyj tego pola do filtrowania czasu                                                               |

Zamówienie może mieć wiele wypełnień, które należy szczegółowo zapisać. Nie łącz rekordów różnych graczy/nie wypełniaj ról do tradeId, a następnie odrzucaj ich tożsamości rekordowe.

## Przykładowa koperta odpowiedzi

To jest przykładowa pusta strona, a nie próbka zakończonej transakcji. Powyższe tabele pól specyficznych dla zasobu opisują zapełnione `items[].data`.

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

## Źródło i powiązane przewodniki

* [Oficjalne źródło v0.3.0](https://github.com/6mm-com/agent-java-sdk/tree/54aa3c1)
* [Przegląd zapytań i paginacja](/pl/sdk/agent-sdk/java/perpetual-queries)
* [Portfel finansowania](/pl/sdk/agent-sdk/java/funding-wallet)
* [Przewodnik po aktualizacji](/pl/sdk/agent-sdk/java/upgrade)