إعلان ترقية واجهة برمجة تطبيقات KuCoin (2026-06-03)

لتحسين تجربة التداول عبر واجهة برمجة التطبيقات، وتعزيز قدرات التداول ضمن إطار حساب التداول الموحّد (UTA)، وتقليل تعقيد التكامل بين أنماط الحسابات المختلفة، ستقوم KuCoin بترقية واجهة برمجة التطبيقات Pro وإطلاق تحديثات واجهة برمجة التطبيقات ذات الصلة.
بعد الترقية، سيتم ترقية واجهة برمجة التطبيقات Pro إلى واجهة برمجة التطبيقات UTA. من الآن فصاعدًا، ستدعم واجهة برمجة التطبيقات UTA فقط وضع الحساب التجاري الموحّد (UTA).
 

1. جدول الترقية

من المقرر تحديث النظام في 08:00 في 3 يونيو 2026 (UTC) ومن المتوقع أن يستمر لمدة 180 دقيقة.
 

2. تأثير الترقية

خلال فترة الترقية، قد يواجه المستخدمون التأثيرات التالية:
  1. قد يواجه بروتوكول WebSocket PRO فصلًا مؤقتًا أو فقدانًا للبيانات أو تأخيرًا. يمكن للمستخدمين إعادة الاتصال ببروتوكول WebSocket لاستعادة الاتصال.
 

3. تفاصيل الترقية

3.1 ترقية واجهة برمجة تطبيقات UTA

حاليًا، بعض نقاط نهاية واجهة برمجة تطبيقات Pro متوافقة مع الحسابات الكلاسيكية وحسابات التداول الموحدة (UTA). في المستقبل، سنواصل التركيز على إطار حسابات التداول الموحدة وتحسين واجهة برمجة تطبيقات UTA بميزات وقدرات جديدة. ستنتقل دعم التوافق المرتبط بالحسابات الكلاسيكية إلى وضع الصيانة ولن يكون التركيز الأساسي لتطوير الميزات المستقبلية أو تحسين الأداء أو التطور طويل الأجل للمنصة.
 
[تفاصيل التعديل]
  • سيتم ترقية واجهة برمجة التطبيقات Pro إلى واجهة برمجة التطبيقات UTA، والتي ستقدم دعماً رئيسياً لحساب التداول الموحّد (UTA) من الآن فصاعداً.
  • سيدخل دعم التوافق الخاص بالحساب الكلاسيكي ضمن واجهة برمجة تطبيقات UTA في وضع الصيانة.
 
إذا كنت تستخدم حاليًا نموذج "Pro API + حساب كلاسيكي"، نوصي بشدة بإكمال أحد خيارات التحويل التالية في أسرع وقت ممكن:
  • التبديل إلى وضع حساب التداول الموحّد (UTA) للتداول؛
  • استمر في استخدام واجهة برمجة التطبيقات الكلاسيكية لتداول الحساب الكلاسيكي.
 
سيساعد هذا في ضمان نقل سلس وعمليات تداول غير مقطوعة.
 

3.2 ترقيات واجهة برمجة التطبيقات

  • تحسين تدفق مفاوضات WebSocket والمصادقة:
    • سيتم تغيير المعالجة المتزامنة إلى معالجة غير متزامنة خلال مراحل المبادلة والمصادقة، مما يقلل من السلوك المحظور ويزيد من عدد طلبات المصادقة التي يمكن معالجتها وحدة زمنية.
    • عندما يفشل اتصال WebSocket في المصادقة بسبب بيانات اعتماد غير صالحة أو منتهية الصلاحية أو غير مصرح بها، سيقوم الخادم بإرسال رسالة "auth failed" عبر إطار WebSocket، مما يمكّن العملاء من تحديد سبب الفشل بسرعة واتخاذ الإجراءات المناسبة. هذا التحسين لا يؤثر على اتصالات WebSocket المصادق عليها بنجاح.

 

    • positionMargin: الهامش المحتل من قبل المركز الآجل.
    • riskRatio: نسبة المخاطرة لموقع مستقبلي معزول.

 

  • [Modify] UTA Websocket Position, أُضيف حقل الاستجابة:
    • pM: الهامش المستخدم من قبل المركز المستقبلي.
    • r: نسبة المخاطرة لموقف مستقبلي معزول. على سبيل المثال، 0.65 تمثل 65%.

 

  • [تعديل] Classic REST Get Deposit List و Classic REST Get Deposit Detail. تم إضافة قيم حالة الإرجاع التالية إلى نقاط النهاية لعرض حالات إيداع أكثر تفصيلًا:
    • ROLLBACKING: يتم عكس الإيداع. يرجى الانتظار.
    • ROLLBACK: تم عكس الإيداع. لم يتم إضافة أي أموال إلى الحساب. يرجى التواصل مع الدعم للحصول على المساعدة.
    • WAIT_RISK_MGT: يتم حاليًا إجراء التحقق المعياري من المخاطر للإيداع. يرجى التواصل مع الدعم للحصول على المساعدة.
    • RISK_MGT_REJECTED: تم رفض الإيداع بعد التحقق من المخاطر. يرجى التواصل مع الدعم لتقديم المعلومات المطلوبة للمراجعة.
    • PRE_SUCCESS: تم إيداع الأموال في الحساب قبل التأكيد النهائي للكتلة.
    • WAIT_TRM_MGT: يتم حاليًا إجراء التحقق القياسي للامتثال. يرجى التواصل مع الدعم للحصول على مساعدة.
    • TRM_MGT_REJECTED : تم رفض الإيداع بعد التحقق من المخاطر. يرجى التواصل مع الدعم لتقديم المعلومات المطلوبة للمراجعة.

 

  • [إضافة] Fast API - التقديم على السحب السريع
    • دعم أذونات مفتاح API المعرفة من قبل المستخدم في تدفق تفويض OAuth، بما في ذلك منح أذونات السحب
    • صلاحية جديدة: السحب السريع (صلاحية السحب عبر واجهة برمجة التطبيقات السريعة)
    • دعم سحب API مع التحقق بخطوتين

 

 

 

  • [Modify] UTA REST Place Order ، أضف حقلًا جديدًا closeOrder لدعم إغلاق المركز للرمز المحدد

 

 
 
للمزيد من المعلومات حول واجهة برمجة التطبيقات، انضم إلى مجتمع KuCoin API Telegram الرسمي
يمكنك أيضًا التواصل معنا عبر البريد الإلكتروني على: api@kucoin.com
 
نعتذر بصدق عن أي إزعاج قد يسببه هذا التعديل، ونقدّر دعمكم وثقتكم المستمرة في واجهة برمجة تطبيقات KuCoin.

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