> 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` في [بداية سريعة](/ar/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`                 | لا    | معرف الطلب العادي؛ ليس رقم طلب نقل الشريك.                                                                                    |
| `startTime`       | `Long`                   | لا    | ميلي ثانية يونكس شاملة؛ استخدم نافذة سجل UTC ثابتة.                                                                           |
| `endTime`         | `Long`                   | لا    | حصري يونكس ميلي ثانية.                                                                                                        |
| `limit`           | `Integer`                | لا    | الافتراضي 500؛ 1-1000.                                                                                                        |
| `cursor`          | `String`                 | لا    | استخدم nextCursor الذي تم إرجاعه مع المرشحات التي لم تتغير؛ توقف عندما يكون hasMore خطأ.                                      |

المثال يقرأ صفحة واحدة. بالنسبة للحقول المطلوبة، ونطاق اللاعب، ودلالات التصفية، والحد، والمؤشر، وعمليات إعادة المحاولة المحدودة، اتبع ذلك [نظرة عامة على الاستعلام](/ar/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)
* [نظرة عامة على الاستعلام وترقيم الصفحات](/ar/sdk/agent-sdk/java/perpetual-queries)
* [محفظة التمويل](/ar/sdk/agent-sdk/java/funding-wallet)
* [دليل الترقية](/ar/sdk/agent-sdk/java/upgrade)