إعلان ترقية واجهة برمجة تطبيقات الهامش في KuCoin

04/07/2025 14:33:02

مخصص

أعزاء مستخدمي KuCoin،

لتقديم بيئة تداول أفضل للمستخدمين وتحسين تجربة التداول، تخضع واجهة برمجة تطبيقات الرافعة المالية في KuCoin لعملية هجرة وترقية عالية التردد. ستُجرى هذه الهجرة على دفعات متعددة ومن المتوقع إكمالها بحلول نهاية مارس 2026.

1. نطاق الهجرة:

للمستخدمين الذين قاموا بتمكين الهامش، إذا لم تكن هناك مراكز أو أصول هامشية أثناء الهجرة، فلن يؤثر ذلك عليك.

2. تأثير الهجرة:

     2.1 المستخدمون غير المُستخدمين لواجهة برمجة التطبيقات (المستخدمون النهائيون)

  • سيظل تجربة المستخدم على الويب/التطبيق دون تغيير قبل وبعد الهجرة.

     2.2 مستخدمو API

  • ستكون لهذا الترحيل تأثير معين على طريقة استدعاء واجهة برمجة التطبيقات وعرض حالة الأصول. سيتم إخطار هذا الترحيل على دفعات. يرجى تنفيذ العمليات المقابلة في الوقت المناسب بعد استلام إشعار البريد الإلكتروني. سيقوم النظام بالترحيل بعد 7 أيام من إرسال البريد الإلكتروني. (للتقليل من التأثير، يمكنك التبديل إلى واجهة برمجة التطبيقات عالية التردد مسبقًا).

3. عملية النقل:

الخطوة 1: قم بتنظيف يدوي للطلبات ذات التردد المنخفض

أ. يحتاج المستخدمون إلى إلغاء الطلبات الموضعية بواسطة واجهة برمجة التطبيقات ذات التردد المنخفض وواجهة المستخدم النهائية (الموقع/التطبيق) بأنفسهم؛

ب. لا حاجة لإلغاء الطلبات عالية التردد؛

  • إذا لم تُلغِ بشكل نشط، فسيقوم النظام بإلغاء الأمر تلقائيًا أثناء عملية الهجرة (بما في ذلك الأوامر العادية والمتقدمة).

  • إذا لم تؤكد حالة طلبك، يرجى التواصل مع خدمة العملاء للحصول على استشارة.

الخطوة 2: نقل الأصول ذات التردد المنخفض يدويًا (مستخدمو واجهة برمجة التطبيقات)

أ. يحتاج المستخدمون إلى نقل الأصول من الحسابات ذات التردد المنخفض إلى الحسابات ذات التردد العالي يدويًا، والانتقال إلى واجهة API الجديدة (انظر api-doc للتفاصيل).

ب. الحصول على الحدود التحويلية - واجهة برمجة تطبيقات KUCOIN في هذا الوقت، يتم عرض الأصول في الطرف C (الويب والتطبيق) على أنها "مُجمدة"، ولا يمكن تنفيذ أوامر عالية التردد.

الخطوة 3: ابدأ الهجرة

الخطوتان 1 و2 غير إلزاميتين، ولكن بمجرد تنفيذ الهجرة، سيقوم النظام بإلغاء أوامر التردد المنخفض تلقائيًا ونقل أصول التردد المنخفض إلى حسابات التردد العالي.

ملاحظات مهمة:

  1. عدم توفر الحساب مؤقتًا (سيتأثر كلا من مستخدمي الواجهة ومستخدمي واجهة برمجة التطبيقات);

أثناء تنفيذ الهجرة، ستكون حسابات المستخدمين غير متاحة مؤقتًا لمدة 2-3 دقائق، وتشمل وظائف استعلام الأصول والتجارة والتحويل. يرجى ترتيب العمليات مسبقًا لتجنب التأثير على المعاملات.

  1. إلغاء إجباري للطلبات ذات التردد المنخفض;

إذا لم يُلغِ المستخدم أمر التردد المنخفض مسبقًا، فسيقوم النظام بإلغاء إجباري للطلبات العادية وغير المُحققة وطلبات متقدمة منخفضة التردد أثناء عملية الهجرة.

  1. تُعرض الأصول على أنها "مجمدة" لفترة قصيرة؛

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

  1. نصائح التوافق مع الواجهة;

لن يدعم الواجهة القديمة الاستعلامات عالية التردد المتعلقة بالحساب. تأكد من إكمال التحويل مسبقًا، وإلا قد يتم إرجاع استثناء.

  1. سيتم التحويل الرسمي بعد 7 أيام من إشعار البريد الإلكتروني؛

سيبدأ التحويل الرسمي بعد 7 أيام من إرسال الإشعار عبر البريد الإلكتروني. يُنصح المستخدمون بمراقبة صناديق بريدهم بعناية وإكمال جميع الاستعدادات الضرورية قبل تاريخ التحويل لضمان انتقال سلس وتجنب أي انقطاعات في الخدمة.

محتوى الهجرة التفصيلي:

استعلامات الأصول

  •  نوصي باستخدام واجهة برمجة التطبيقات الجديدة لاستعلامات الأصول:

    • استعلام أصول حساب الهامش المتقاطع: /api/v3/margin/accounts

    • استعلام أصول حساب الهامش المعزول: /api/v3/isolated/accounts

  •  بعد النقل، ستظل بيانات الأصول قبل وبعد النقل متسقة. بمجرد اكتمال النقل، ستُرجع جميع عمليات الاستعلام الخاصة بالهامش وmargin_v2 وALL نتائج متسقة (وبالمثل بالنسبة للحسابات المعزولة).

ملاحظة: ستظل واجهات استعلام الأصول القديمة (/api/v1/margin/account للهامش المتقاطع و/v1/isolated/accounts للهامش المعزول) متاحة بعد الهجرة، لكن الأصول ذات التردد العالي ستُظهر كـ "مُجمدة" للمستخدمين الذين لم يُكملوا الهجرة بعد.

استعلامات دفتر المعاملات

1. واجهة V1: /api/v1/accounts/ledgers

  • يمكن الاستعلام عن الدفتر للحسابات ذات التردد العالي والتردد المنخفض قبل وبعد الهجرة، بنفس نطاق الوقت السابق.

2. واجهة V3: /api/v3/hf/margin/account/ledgers

  • هذا يدعم فقط استعلام معاملات الحساب ذات التردد العالي، بمدى زمني محدود يبلغ الثلاثة أيام الأخيرة.

يمكن للمستخدمين اختيار الواجهة بناءً على احتياجاتهم.

التحويلات

  •  تبقى واجهة التحويل كما هي. لا تزال الواجهة السابقة قابلة للاستخدام للتحويلات بين الحسابات عالية التردد ومنخفضة التردد.

    • قبل النقل: يتم دعم التحويلات بين الحسابات عالية التردد ومنخفضة التردد ضمن نفس المستخدم.

    • بعد الهجرة: سيتم اعتبار margin و margin_v2 كحساب واحد، ولن يتم دعم التحويلات بين هذين الحسابين (بنفس الطريقة بالنسبة للهامش المعزول).

استعلامات الطلبات التاريخية

1. واجهة V1: /api/v1/orders?status=done

  • يمكن الاستعلام عن الطلبات التاريخية لكل الطلبات عالية التردد ومنخفضة التردد، بنفس النطاق الزمني.

2. واجهة V3: /api/v3/hf/margin/orders/done

  • هذا يدعم فقط استعلام أوامر التردد العالي ويمكنه إرجاع البيانات لآخر ثلاثة أيام فقط. يمكن للمستخدمين اختيار ما يناسبهم.

وضع الأمر/إلغاء الأمر/استعلام الأوامر النشطة

1. واجهة V1: تدعم وضع أوامر التردد المنخفض، وإلغائها، واستعلامها.

2. واجهة V3: تدعم وضع أوامر التداول عالية التردد، وإلغائها، واستعلامها.

لا تتوافق أوامر التردد العالي مع أوامر التردد المنخفض، بما في ذلك وظائف جني الأرباح ووقف الخسارة. يجب على المستخدمين استخدام الواجهة المقابلة بناءً على نوع الأمر.

تغييرات واجهة الهجرة:

  • ملاحظة: يُوصى بتحديد تغييرات الواجهة التي تمت قبل وبعد الهجرة مسبقًا لتجنب التأثير على الاستخدام.

الإجراء

واجهة ما قبل الهجرة

بعد واجهة الهجرة

وضع الأمر

الطلب العادي: /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

إلغاء الطلب

حسب معرف الطلب: /api/v1/orders/{orderId}

حسب clientOid: /api/v1/order/client-order/{clientOid}

إلغاء جماعي: /api/v1/orders

حسب معرف الطلب: /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

تحذير من المخاطر

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

شكرًا لدعمك!

فريق KuCoin

اكتشف الكنز الكريبتوجي التالي على KuCoin!

سجّل الآن على KuCoin! >>>

حمّل تطبيق KuCoin >>>

تابعنا على X (Twitter) >>>

انضم إلينا على تيليغرام >>>

انضم إلى مجتمعات KuCoin العالمية >>>

اخلاء المسؤوليه: تُرجمت هذه الصفحة باستخدام تقنية الذكاء الاصطناعي (المدعومة من GPT) لراحتك. للحصول على المعلومات الأكثر دقة، ارجع إلى النسخة الإنجليزية الأصلية.