يملأ التجارة الدائمة

يستهدف هذا الدليل 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 النوع	مطلوب	معنى
`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 خطأ.

المثال يقرأ صفحة واحدة. بالنسبة للحقول المطلوبة، ونطاق اللاعب، ودلالات التصفية، والحد، والمؤشر، وعمليات إعادة المحاولة المحدودة، اتبع ذلك نظرة عامة على الاستعلام. احتفظ بجميع المرشحات دون تغيير أثناء الترحيل؛ لا تفسر الخطأ كنتيجة فارغة.

تفاصيل تعبئة التجارة

الواجهة: 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 المأهولة.

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

مثال المتطلبات الأساسية

listPerpetualTrades

حقول الطلب

تفاصيل تعبئة التجارة

مثال على مظروف الاستجابة

المصدر والأدلة ذات الصلة

`listPerpetualTrades`