Skip to navigation

المواقف الدائمة

المواقف الدائمة: Agent Java SDK التكامل v0.3.0 والأمثلة والمعلمات ودلالات الاستجابة.

View as 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.*;

listCurrentPerpetualPositions

نموذج الطلب: CurrentPerpetualPositionsRequest.

import com.sixmm.agent.model.CurrentPerpetualPositionsRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
CurrentPerpetualPositionsRequest request = new CurrentPerpetualPositionsRequest();
request.platformUserIds = Collections.singletonList("1188041528");
request.limit = 100;
request.symbol = "BTCUSDT";
PerpetualResponse response = client.listCurrentPerpetualPositions(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لامرشح اختياري لزوج التداول.
limitIntegerلاالافتراضي 500؛ 1-1000.
cursorStringلااستخدم nextCursor الذي تم إرجاعه مع المرشحات التي لم تتغير؛ توقف عندما يكون hasMore خطأ.

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

listPerpetualPositionHistory

نموذج الطلب: PerpetualPositionHistoryRequest.

import com.sixmm.agent.model.PerpetualPositionHistoryRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
PerpetualPositionHistoryRequest request = new PerpetualPositionHistoryRequest();
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.listPerpetualPositionHistory(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لامرشح اختياري لزوج التداول.
positionSideStringلاقم بالتصفية باستخدام التعداد الجانبي للموضع المصدر.
startTimeLongلاميلي ثانية يونكس شاملة؛ استخدم نافذة سجل UTC ثابتة.
endTimeLongلاحصري يونكس ميلي ثانية.
limitIntegerلاالافتراضي 500؛ 1-1000.
cursorStringلااستخدم nextCursor الذي تم إرجاعه مع المرشحات التي لم تتغير؛ توقف عندما يكون hasMore خطأ.

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

المناصب: الحالية والتاريخية

data الحقليكتبالوضع الحاليمواقف تاريخيةمعنى
positionIdstringإمدادإمدادمعرف المنصب، المطابق لـ entityId
symbolstringإمدادإمدادزوج التداول
positionSidestringإمدادإمدادLONG / SHORT / BOTH واتجاهات الموضع الأخرى
statusstringإمدادإمدادسلسلة مع الحالة الرقمية للموضع، راجع نظرة عامة على الاستعلام
leverageintegerإمدادإمدادالاستفادة المتعددة
marginModestringإمدادإمدادسلسلة التعداد الرقمية “1” للموضع الكامل، “2” للموضع المعزول
quantitystringإمدادغير متوفركمية الموقف الحالي
entryPricestringإمدادإمدادمتوسط ​​سعر الافتتاح للصفقات المخزنة
marginstringإمدادغير متوفرمبلغ هامش المركز الحالي، وليس رصيد محفظة العقد بالكامل للمستخدم
maxQuantitystringغير متوفرإمدادالحد الأقصى لعدد المواقف المسجلة في هذا الموقف التاريخي
closeQuantitystringغير متوفرإمدادالعدد التراكمي للصفقات المغلقة خلال دورة حياة الصفقة التاريخية
closePricestringغير متوفرإمدادمتوسط ​​سعر الإغلاق المخزن
pnlstringغير متوفرإمدادالربح والخسارة للوضع التاريخي؛ لا تدمجها مع المعاملة realizedPnl للتكرار والتراكم ببساطة
roestringغير متوفرإمدادالقيمة التناسبية لعائد المركز التاريخي، غير مضروبة في 100؛ على سبيل المثال، "0.043" يمثل 4.3%، "-0.05" يمثل -5%
fundingFeeAccumstringإمدادإمدادرسوم التمويل المتراكمة، مع الاحتفاظ برمز المصدر ودقته
openedAtintegerإمدادإمدادوقت افتتاح المركز، بالمللي ثانية
updatedAtintegerإمدادغير متوفروقت تحديث الموقف الحالي، بالمللي ثانية
closedAtintegerغير متوفرإمدادوقت الإغلاق، ميلي ثانية؛ استخدم هذا الحقل لتصفية وقت الموقع التاريخي

عيار حساب التاريخ roe هو pnl / (entryPrice × maxQuantity / leverage)، وتقوم الواجهة مباشرة بإرجاع قيمة النسبة المحفوظة. عند عرض النسبة المئوية، استخدم العملية العشرية واضرب في 100، ثم أضف %؛ يستخدم المقام الهامش الاسمي لسجل المركز التاريخي، وليس رصيد محفظة الحساب. عندما يكون سعر الافتتاح أو الحد الأقصى لكمية المركز 0، تكون الرافعة المالية غير صالحة، وما إلى ذلك ولا يمكن حسابها، ويتم حفظ المصدر كـ 0. لذلك، لا يمكن استنتاج أن الربح أو الخسارة هي 0 بناءً على roe=0.

لا يحتوي المركز الحالي على سعر محدد في الوقت الفعلي، أو أرباح وخسائر عائمة في الوقت الفعلي، أو ROE في الوقت الفعلي، أو سعر تصفية في الوقت الفعلي. إنه يعكس حالة الموضع المخزن ولا يمكنه استخدام وقت التحديث وحقول الهامش للمطالبة بنتائج التحكم في المخاطر الحالية في الوقت الفعلي.

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

هذه صفحة فارغة توضيحية، وليست عينة من صفقة مكتملة. تصف جداول الحقول الخاصة بالموارد أعلاه items[].data المأهولة.

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

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