المستخدم والحساب

View as Markdown

ما لم يذكر خلاف ذلك، يمكن للنقاط النهائية التالية استخدام توقيع JWT أو API Key .

معلومات المستخدم

1GET /v1/private/user/info

حقول الاستجابة:

الميدانالنوعالوصف
userInfo.userIdstringمعرف المستخدم الخارجي
userInfo.usernamestringاسم المستخدم
userInfo.agentIdint64معرف الوكيل
userInfo.vipLevelint64VIP المستوى
userInfo.lastLoginAtint64آخر وقت تسجيل دخول
userInfo.lastLoginIpstringآخر تسجيل IP

أصول المستخدمين

1GET /v1/private/user/asset

حقول الاستجابة:

الميدانالنوعالوصف
userAsset.userIdstringمعرف المستخدم الخارجي
userAsset.assetTypestringنوع الأصل
userAsset.walletBalancestringرصيد المحفظة
userAsset.frozenMarginstringالهامش مجمد بسبب الأوامر المعلقة
userAsset.usedMarginstringالهامش المستخدم من قبل المراكز

أنشئ listenKey

1POST /v1/private/user/listen-key

ينشئ مفتاح مصادقة لتدفقات WebSocket الخاصة.

تجديد listenKey

1PUT /v1/private/user/listen-key

يمدد صلاحية listenKey .

إغلاق listenKey

1DELETE /v1/private/user/listen-key

يغلق listenKeyالمحدد.

سجلات تغيير الحساب

1GET /v1/private/user/account-change-log?assetType=USDT&page=1&pageSize=20

معايير الطلب:

المعلمةالنوعمطلوبالوصف
assetTypestringلانوع الأصل، مثل USDT
changeTypestringلاتغيير النوع
startTimeint64لاوقت البدء
endTimeint64لانهاية الزمن
pageint32لارقم الصفحة، 1 الافتراضي
pageSizeint32لاالعناصر في كل صفحة، 20 الافتراضي

حقول الاستجابة:

الميدانالنوعالوصف
list[].assetTypestringنوع الأصل
list[].amountstringالمبلغ المتغير
list[].walletBalanceBeforestringرصيد المحفظة قبل التغيير
list[].walletBalanceAfterstringرصيد المحفظة بعد التغيير
list[].frozenBalanceBeforestringتجمد التوازن قبل التغيير
list[].frozenBalanceAfterstringتوازن متجمد بعد التغيير
list[].changeTypestringتغيير النوع
list[].referenceIdstringمعرف الأعمال ذات الصلة
list[].createdAtint64زمن الخلق
totalint64إجمالي العدد

إحصائيات حجم الثلاثين يوما

1GET /v1/private/user/volume-stats

حقول الاستجابة:

الميدانالنوعالوصف
volume30dstringحجم التداول التراكمي خلال الثلاثين يوما الماضية
feeTotal30dstringالرسوم التراكمية خلال آخر 30 يوما

تاريخ التوازن

1GET /v1/private/user/balance-history?period=1D&limit=30

معايير الطلب:

المعلمةالنوعمطلوبالوصف
periodstringنعم1D / 1W / 1M
limitالاستخباراتلاعدد العناصر التي تم إرجاعها، 30 الافتراضي

حقول الاستجابة:

الميدانالنوعالوصف
items[].datestringتاريخ التجميع
items[].balancestringرصيد المحفظة
items[].pnlstringتم تحقيق PnL لتلك الفترة

نظرة عامة على التجارة

1GET /v1/private/user/trade-overview?type=1M

معايير الطلب:

المعلمةالنوعمطلوبالوصف
typestringنعمنطاق الاتجاهات: 1D، 1W، 1M، 3M، 6M، 1Y

حقول الاستجابة:

الميدانالنوعالوصف
todayPnlstringPnL الذي تم تحقيقه اليوم
todayVolumestringحجم تداول العقود اليوم
totalVolumestringحجم تداول العقود التراكمي
totalPnlstringالأرباح التراكمية المحققة
maxDrawdown30dstringأقصى مبلغ سحب خلال آخر 30 يوما
maxDrawdown30dRatestringأقصى معدل سحب خلال آخر 30 يوما، عشري من 0 إلى 1
transferInstringالأموال المحولة التراكمية
transferOutstringالأموال المحولة التراكمية
items[]arrayبيانات اتجاهات الأصول

ملخص نظرة عامة على الأصول

1GET /v1/private/user/asset/overview/summary

حقول الاستجابة هي نفسها حقول ملخص التبادل العام، باستثناء items[].

نظرة عامة على الأصول الاتجاه

1GET /v1/private/user/asset/overview/trend?type=1M

معايير الطلب:

المعلمةالنوعمطلوبالوصف
typestringنعمنطاق الاتجاهات: 1D، 1W، 1M، 3M، 6M، 1Y

حقول الاستجابة:

الميدانالنوعالوصف
items[].snapshotTimeint64وقت اللقطة
items[].balancestringرصيد الحساب الجاري
items[].pnlstringPnL للفترة الحالية
items[].pnlRatestringمعدل الأرباح الربحية للفترة الحالية
items[].totalPnlstringالرقم التراكمي لبيع الأرباح

الرموز المفضلة

حفظ

1POST /v1/private/user/favorite-symbols
2Content-Type: application/json

نص الطلب:

1{
2 "symbols": ["BTCUSDT", "ETHUSDT"]
3}

استعلام

1GET /v1/private/user/favorite-symbols

حقول الاستجابة:

الميدانالنوعالوصف
symbolsالوترية[]قائمة الرموز المفضلة