إعلان ترقية API للهامش في كوكوين
عزيزنا مستخدم كوكوين،
لتوفير بيئة تداول أفضل وتحسين تجربة التداول، يعمل API للهامش الخاص بمنصة كوكوين على إجراء ترقية وهجرة عالية التردد.سيتم تنفيذ هذه العملية على عدة دفعات ومن المتوقع أن تكتمل بحلول نهاية عام 2025.
1. نطاق الهجرة:
بالنسبة للمستخدمين الذين قاموا بتفعيل الهامش، إذا لم يكن لديهم أي مراكز هامش أو أصول خلال عملية الهجرة، فلن يتأثروا بذلك.
2. تأثير الهجرة:
2.1 المستخدمون غير المعتمدين على API (مستخدمي C-end)
- لن تتغير تجربة المستخدم على الموقع الإلكتروني/التطبيق قبل وبعد عملية الهجرة.
2.2 مستخدمو API
- ستؤثر هذه العملية على طريقة استدعاء واجهة API وكذلك عرض حالة الأصول. سيتم إعلام المستخدمين بهذه الهجرة على دفعات. يُرجى تنفيذ العمليات اللازمة بعد استلام إشعار البريد الإلكتروني. سيتم تنفيذ الهجرة بعد 7 أيام من إرسال البريد الإلكتروني. (لتقليل التأثير، يمكنك التبديل إلى API عالي التردد مسبقاً).
3. عملية الهجرة:
الخطوة الأولى: تنظيف يدوي للأوامر منخفضة التردد
a. يحتاج المستخدمون إلى إلغاء الأوامر التي تم وضعها بواسطة API منخفض التردد ومنصة C-end (الموقع الإلكتروني/التطبيق) بأنفسهم؛
b. الأوامر عالية التردد لا تحتاج إلى إلغاء؛
-
إذا لم تقم بالإلغاء بشكل استباقي، سيقوم النظام بإلغاء الأمر قسرياً أثناء عملية الهجرة (بما في ذلك الأوامر العادية والمتقدمة).
-
إذا لم تؤكد حالة أوامرك، يُرجى التواصل مع خدمة العملاء للحصول على استشارة.
الخطوة الثانية: نقل يدوي للأصول منخفضة التردد (مستخدمي API)
a. يحتاج المستخدمون إلى نقل الأصول من حسابات منخفضة التردد إلى حسابات عالية التردد يدوياً والانتقال إلى واجهة API الجديدة (يرجى الاطلاع على api-doc للحصول على التفاصيل).
b.الحصول على حصص التحويل - KUCOIN APIفي الوقت الحالي، يتم عرض الأصول في واجهة المستخدم (الويب والتطبيق) كـ "FROZEN"، ولا يمكن تشغيل الطلبات عالية التردد.
الخطوة 3: بدء عملية النقل
*الخطوتان 1 و 2 ليستا إلزاميتين، ولكن بمجرد تنفيذ عملية النقل، سيقوم النظام تلقائيًا بإلغاء الطلبات منخفضة التردد وتحويل الأصول منخفضة التردد إلى حسابات عالية التردد.
ملاحظات مهمة:
-
عدم توفر الحساب بشكل مؤقت (سيؤثر ذلك على مستخدمي واجهة المستخدم ومستخدمي API)؛
أثناء تنفيذ عملية النقل، ستصبح الحسابات غير متوفرة بشكل مؤقت لمدة 2-3 دقائق، مما سيؤثر على وظائف الاستعلام عن الأصول والتداول والتحويل. يُرجى ترتيب العمليات مسبقًا لتجنب التأثير على المعاملات.
-
الإلغاء الإجباري للطلبات منخفضة التردد؛
إذا لم يقم المستخدم بإلغاء الطلب منخفض التردد مسبقًا، سيقوم النظام بإلغاء الطلبات العادية والمتقدمة غير المكتملة منخفضة التردد بشكل إجباري أثناء عملية النقل.
-
عرض الأصول كـ "frozen" لفترة قصيرة؛
أثناء مرحلة التحضير للنقل، قد يتم عرض الأصول عالية التردد كـ "frozen" في الواجهة القديمة، وستعود إلى الوضع الطبيعي بعد اكتمال النقل.
-
نصائح بشأن توافق الواجهة؛
لن تدعم الواجهة القديمة استعلامات الحسابات عالية التردد بعد الآن. تأكد من إتمام الانتقال مسبقًا، وإلا قد يتم إرجاع استثناءات.
-
النقل الرسمي سيتم بعد مرور 7 أيام على إشعار البريد الإلكتروني؛
سيبدأ النقل الرسمي بعد مرور 7 أيام على إرسال إشعار البريد الإلكتروني. يُنصح المستخدمون بمراقبة صندوق البريد الخاص بهم عن كثب وإتمام جميع التحضيرات اللازمة قبل تاريخ النقل لضمان انتقال سلس وتجنب انقطاع الخدمة.
محتوى النقل التفصيلي:
استعلامات الأصول
-
نوصي باستخدام واجهة API الجديدة لاستعلامات الأصول:
-
استعلام الأصول لحساب الهامش المتقاطع: /api/v3/margin/accounts
-
استعلام الأصول لحساب الهامش المعزول: /api/v3/isolated/accounts
-
-
بعد النقل، ستظل بيانات الأصول قبل وبعد النقل متسقة. بمجرد اكتمال عملية النقل، ستُرجع جميع استعلامات الهامش، margin_v2، و ALL نتائج متسقة (وكذلك بالنسبة للحسابات المعزولة).
ملاحظة:ستظل واجهات الاستعلام عن الأصول القديمة (/api/v1/margin/account للهامش المتقاطع و /v1/isolated/accounts للهامش المعزول) متاحة بعد عملية الانتقال، ولكن سيتم عرض الأصول عالية التكرار كـ "مجمدة" للمستخدمين الذين لم ينتقلوا بعد.
استعلامات دفتر المعاملات
1. V1 Interface : /api/v1/accounts/ledgers
- يمكن استعلام دفتر المعاملات لكل من الحسابات عالية التكرار ومنخفضة التكرار قبل وبعد الانتقال، باستخدام نفس الفترة الزمنية السابقة.
2. V3 Interface : /api/v3/hf/margin/account/ledgers
- تدعم هذه الواجهة استعلامات معاملات الحساب عالي التكرار فقط، مع فترة زمنية محدودة في آخر ثلاثة أيام.
يمكن للمستخدمين اختيار الواجهة بناءً على احتياجاتهم.
التحويلات
-
تظل واجهة التحويل كما هي. يمكن استخدام الواجهة السابقة لتحويل الأموال بين الحسابات عالية التكرار ومنخفضة التكرار.
-
قبل الانتقال: يتم دعم التحويلات بين الحسابات عالية التكرار ومنخفضة التكرار داخل نفس المستخدم.
-
بعد الانتقال: سيتم اعتبار margin و margin_v2 نفس الحساب، ولن يتم دعم التحويلات بين هذين الحسابين بعد الآن (وكذلك للهامش المعزول).
-
استعلامات الطلبات التاريخية
1. V1 Interface : /api/v1/orders?status=done
- يمكن استعلام الطلبات التاريخية لكل من الطلبات عالية التكرار ومنخفضة التكرار، باستخدام نفس الفترة الزمنية.
2. V3 Interface : /api/v3/hf/margin/orders/done
- تدعم هذه الواجهة استعلام الطلبات عالية التكرار فقط، ويمكنها إرجاع بيانات آخر ثلاثة أيام فقط. يمكن للمستخدمين الاختيار وفقًا لاحتياجاتهم.
طلبات تنفيذ الطلب/إلغاء الطلب/استعلام الطلبات النشطة
1. V1 Interface : تدعم وضع وإلغاء واستعلام الطلبات النشطة منخفضة التكرار.
2. V3 Interface : تدعم وضع وإلغاء واستعلام الطلبات النشطة عالية التكرار.
الطلبات عالية التكرار ومنخفضة التكرار غير متوافقة مع بعضها البعض، بما في ذلك وظائف أخذ الربح وإيقاف الخسارة. يجب على المستخدمين استخدام الواجهة المناسبة بناءً على نوع الطلب.
تغييرات واجهات الانتقال:
-
ملاحظة: يُوصى بتوضيح التغييرات في الواجهات المرتبطة قبل وبعد عملية الانتقال مسبقًا لتجنب التأثير على الاستخدام.
|
الإجراء |
واجهة قبل الانتقال |
واجهة بعد الانتقال |
|
تنفيذ الطلب |
طلب عادي: /api/v1/margin/order طلب إيقاف: /api/v1/stop-order |
طلب عادي: /api/v3/hf/margin/order أمر إيقاف: /api/v3/hf/margin/stop-order OCO: /api/v3/hf/margin/oco-order |
|
إلغاء الطلب |
حسب orderId: /api/v1/orders/{orderId} حسب clientOid: /api/v1/order/client-order/{clientOid} إلغاء جماعي: /api/v1/orders |
حسب orderId: /api/v3/hf/margin/orders/{orderId}?symbol={symbol} حسب clientOid: /api/v3/hf/margin/orders/client-order/{clientOid}?symbol={symbol} إلغاء جماعي: /api/v3/hf/margin/orders?symbol={symbol}&tradeType={tradeType} |
|
استعلام عن الطلبات النشطة |
/api/v1/orders?status=active |
/api/v3/hf/margin/orders/active?tradeType={tradeType}&symbol={symbol} استعلام عن الأزواج النشطة للتداول: /api/v3/hf/margin/order/active/symbols |
تحذير المخاطر
يشير التداول بالهامش إلى ممارسة اقتراض الأموال مع رأس مال أقل نسبيًا لتداول الأصول المالية والحصول على أرباح أكبر. ومع ذلك، بسبب مخاطر السوق وتقلب أسعار الأصول وعوامل أخرى، نوصي بشدة بأن تكون حذرًا في قراراتك الاستثمارية، واعتماد مستوى مناسب من الرافعة المالية لتداول الهامش، ووقف الخسائر بشكل مناسب وفي الوقت المناسب. كوكوين لا تتحمل أي مسؤولية عن أي خسائر ناتجة عن التداول.
شكرًا لدعمكم!
فريق كوكوين
اكتشف الجوهرة التالية للعملات المشفرة على كوكوين!
تابعنا على X (تويتر) >>>
انضم إلى المجتمعات العالمية لكوكوين>>>
اخلاء المسؤوليه: تُرجمت هذه الصفحة باستخدام تقنية الذكاء الاصطناعي (المدعومة من GPT) لراحتك. للحصول على المعلومات الأكثر دقة، ارجع إلى النسخة الإنجليزية الأصلية.