إعلان Gate بشأن تغييرات نوع حقل كمية الطلب في عقود USDT Perp وخطة إطلاق المزايا

التغييرات على أنواع الحقول المتعلقة بحجم العقود الآجلة
من أجل تعزيز مرونة تداول العقود الآجلة ودعم أوامر الكميات الكسرية بشكل كامل، ستقوم Gate بتنفيذ ترقية تدريجية لواجهات برمجة التطبيقات لعقود USDT Perp. ستؤثر هذه الترقية على منطق تحليل الحقول المتعلقة بحجم الطلب (الحجم) في كل من REST API وWebSocket. يرجى تقييم وتعديل منطق استراتيجيتك مسبقًا وفقًا للخطة المرحلية لضمان استمرار تداولك دون تأثر.

1.1 نظرة عامة على خطة الترقية (مقسمة إلى 3 مراحل)

1. المرحلة الأولى: ترقية توافق نوع الحقول (تم إطلاقها في 9 ديسمبر 2025)

• تم الانتهاء من تعديلات بنية البيانات الأساسية.
• تم تعديل نوع بيانات الحقول المتعلقة بحجم العقد من عدد صحيح إلى سلسلة نصية.
• النظام حاليًا في وضع التوافق. من خلال تضمين حقل X-Gate-Size-Decimal في رأس الطلب، يتم تحقيق معالجة توافقية لحقل كمية العقود.

معلمة الرأس	الوصف	ملاحظات
X-Gate-Size-Decimal = 1	تتغير أنواع الحقول المتعلقة بالحجم من عدد صحيح إلى سلسلة نصية	1. يدعم استقبال بيانات عشرية.
X-Gate-Size-Decimal = 0 أو عدم استخدام هذا الحقل بشكل افتراضي	تظل أنواع الحقول المتعلقة بالحجم عدد صحيح	1. لا يدعم استقبال بيانات عشرية. 2. معالجة الدقة - يتم اقتطاعها نحو الصفر (إلى الأسفل).

• إذا لم يتم ضبط رأس X-Gate-Size-Decimal، سيستمر حقل الحجم في استقبال وإرجاع النوع العددي الصحيح بشكل افتراضي.

2. المرحلة الثانية: إطلاق ميزة أوامر الكميات الكسرية

1. من المقرر إطلاق قدرة النظام على تنفيذ أوامر الكميات الكسرية لعقود USDT Perp في 30 ديسمبر 2025. خلال هذه المرحلة، سيتم تفعيل القدرات الأساسية للنظام ودعم واجهات برمجة التطبيقات فقط. لن يتم فتح أي عقود فعليًا لأوامر الكميات الكسرية في هذا الوقت، وستظل قواعد تنفيذ الطلبات للمستخدمين دون تغيير.

2. بدءًا من أواخر يناير 2026، سيتم طرح ميزة أوامر الكميات الكسرية تدريجيًا على العقود. وسيتم الإعلان عن العقود المحددة والجداول الزمنية للطرح من قبل المنصة في إشعارات لاحقة.

3. بالنسبة للمستخدمين الذين لا يزالون يستخدمون نوع الحقول القديم دون التكيف، قد تظهر المشكلات التالية:

• تحليل دقة غير طبيعي في بيانات عمق العقود.
• عدم اتساق دقة الطلبات.
• دقة غير طبيعية في الطلبات المنفذة.

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

3. المرحلة الثالثة: التفعيل الكامل لجميع عقود USDT-M Perp والانتقال الإجباري إلى نوع الحقول النصية

1. ستدعم جميع أزواج التداول للعقود بشكل كامل تنفيذ أوامر الكميات الكسرية.
2. في وقت محدد، سيقوم النظام بإرجاع النوع النصي بشكل افتراضي ويعدل القيمة الافتراضية للرأس (X-Gate-Size-Decimal)، مع تحويل سلوك التحليل الافتراضي من 0 إلى 1 لتوفير فترة انتقالية قصيرة للمستخدمين الذين لم يكملوا التكيف بعد.
3. بعد فترة الانتقال، سيتم إيقاف دعم رأس X-Gate-Size-Decimal رسميًا ولن يكون لتكوينه أي تأثير.
4. سيتم توحيد جميع الحقول المتعلقة بحجم الطلبات لاستخدام النوع النصي لضمان الدقة والتوافق. ولن يتم دعم النوع العددي الصحيح القديم بعد ذلك.
5. سيتم الإعلان عن تاريخ التفعيل المحدد مسبقًا عبر إشعار رسمي. يرجى التأكد من إتمام جميع التعديلات مسبقًا.

1.2 شرح مفصل لترقية المرحلة الأولى

1. تم إدخال حقل رأس جديد X-Gate-Size-Decimal في كل من REST وWebSocket API للتحكم في دقة الحقول المتعلقة بالحجم.

معلمة الرأس	الوصف	ملاحظات
X-Gate-Size-Decimal = 1	تتغير أنواع الحقول المتعلقة بالحجم من عدد صحيح إلى سلسلة نصية	1. يدعم استقبال بيانات عشرية.
X-Gate-Size-Decimal = 0 أو عدم استخدام هذا الحقل بشكل افتراضي	تظل أنواع الحقول المتعلقة بالحجم عدد صحيح	1. لا يدعم استقبال بيانات عشرية. 2. معالجة الدقة - يتم اقتطاعها نحو الصفر (إلى الأسفل).

التوصية: يجب على العملاء التكيف بسرعة مع تغيير نوع حقل كمية العقود. بمجرد دعم العقود رسميًا لأوامر الكميات الكسرية، يمكنهم تجربة هذه الميزة والاستفادة منها بسرعة.

2. مثال مرجعي لإعداد الرأس

Rest

# إعداد رؤوس الطلب
headers =
{
'KEY': API_KEY,
'Timestamp': timestamp,
'SIGN': signature,
# تفعيل الحجم العشري
'X-Gate-Size-Decimal': '1',
'Content-Type': 'application/json',
'Accept': 'application/json'
}

Websocket

# إعداد رؤوس الطلب
# تفعيل الحجم العشري
headers['X-Gate-Size-Decimal'] = '1'

1.3 تغييرات نوع حقل الحجم في المستقبل

1. الحقول المتعلقة بـ Rest

نوع الواجهة	نقطة النهاية	الحقل	ملاحظات
عام	1. الاستعلام عن جميع معلومات العقود الآجلة GET /futures/settle/contracts 2. الاستعلام عن معلومات عقد واحد GET /futures/settle/contracts/contract	الحد الأدنى لحجم الطلب المسموح به للعقد 'order_size_min' الحد الأقصى لحجم الطلب المسموح به للعقد 'order_size_max' الحجم التراكمي التاريخي للتداولات 'trade_size' الحجم الإجمالي الحالي للمراكز الطويلة 'position_size'	1. باستخدام رأس X-Gate-Size-Decimal=1 ، سيتغير نوع الحقول المذكورة أعلاه من عدد صحيح إلى سلسلة نصية . 2. يجب على العملاء تعديل نوع القبول لهذه الحقول.
عام	1. الاستعلام عن معلومات عمق سوق العقود الآجلة GET /futures/settle/order_book	الحجم 's'
عام	1. سجلات تداول سوق العقود الآجلة GET /futures/settle/trades	حجم التداول 'size'
عام	1. مخطط الشموع لسوق العقود الآجلة GET /futures/settle/candlesticks	حجم التداول (حجم العقد) 'v'
عام	1. إحصائيات العقود الآجلة GET /futures/settle/contract_stats	حجم التصفية الطويلة (عقود) 'long_liq_size' حجم التصفية القصيرة (عقود) 'short_liq_size' الحجم الإجمالي للاهتمام الصريح (عقود) 'open_interest' نسبة مركز أفضل متداول طويل/قصير 'top_lsr_size' حجم مركز أفضل متداول طويل 'top_long_size' حجم مركز أفضل متداول قصير 'top_short_size' حجم أفضل آخذ طويل 'long_taker_size' حجم أفضل آخذ قصير 'short_taker_size'
عام	1. الاستعلام عن سجل أوامر التصفية GET /futures/settle/liq_orders	حجم المركز 'size' سعر أمر التصفية 'order_size' حجم أمر صانع النظام للتصفية 'left'
خاص	1. الحصول على قائمة مراكز المستخدم GET /futures/settle/positions 2. الحصول على معلومات مركز واحد GET /futures/settle/positions/contract 3. تحديث هامش المركز POST /futures/settle/positions/contract/margin 4. تحديث الرافعة المالية للمركز POST /futures/settle/positions/contract/leverage 5. تبديل وضع هامش المركز POST /futures/settle/positions/cross_mode 6. التبديل بين وضعي الهامش المتقاطع والمعزول تحت وضع التحوط POST /futures/settle/dual_comp/positions/cross_mode 7. تحديث حد المخاطرة للمركز POST /futures/settle/positions/contract/risk_limit 8. تعيين وضع المركز POST /futures/settle/dual_mode 9. الحصول على معلومات المركز في وضع التحوط GET /futures/settle/dual_comp/positions/contract 10. تحديث هامش المركز في وضع التحوط POST /futures/settle/dual_comp/positions/contract/margin 11. تحديث الرافعة المالية للمركز في وضع التحوط POST /futures/settle/dual_comp/positions/contract/leverage 12. تحديث حد المخاطرة للمركز في وضع التحوط POST /futures/settle/dual_comp/positions/contract/risk_limit	حجم المركز 'size'
خاص	1. تنفيذ أمر العقود الآجلة POST /futures/settle/orders 2. الاستعلام عن قائمة أوامر العقود الآجلة GET /futures/settle/orders 1. إلغاء جميع الطلبات ذات الحالة "مفتوح" DELETE /futures/settle/orders 2. الاستعلام عن قائمة أوامر العقود الآجلة حسب النطاق الزمني GET /futures/settle/orders_timerange 3. تنفيذ أوامر عقود آجلة جماعية POST /futures/settle/batch_orders 4. الاستعلام عن تفاصيل أمر واحد GET /futures/settle/orders/order_id 5. إلغاء أمر واحد DELETE /futures/settle/orders/order_id 6. تعديل أمر واحد PUT /futures/settle/orders/order_id 7. تنفيذ أمر عقد BBO حسب المستوى POST /futures/settle/bbo_orders	كمية التداول 'size' حجم العرض لطلبات الجبل الجليدي 'iceberg' الكمية غير المنفذة 'left'
خاص	1. الاستعلام عن سجلات التداول الشخصية GET /futures/settle/my_trades 2. الاستعلام عن سجلات التداول الشخصية حسب النطاق الزمني GET /futures/settle/my_trades_timerange	حجم التداول 'size' حجم المراكز المغلقة: 'close_size'
خاص	1. الاستعلام عن سجل إغلاق المراكز GET /futures/settle/position_close	الحد الأقصى لحجم التداول 'max_size' الحجم التراكمي للمراكز المغلقة 'accum_size'
خاص	1. الاستعلام عن سجل التصفية GET /futures/settle/liquidates	حجم المركز 'size' حجم أمر التصفية المعلق 'left'
خاص	1. الاستعلام عن معلومات أوامر تقليص المديونية التلقائي ADL GET /futures/settle/auto_deleverages	حجم التداول 'trade_size' حجم المركز بعد تقليص المديونية التلقائي 'position_size'
خاص	1. الاستعلام عن قائمة الطلبات التلقائية GET /futures/settle/price_orders 2. إلغاء جميع الطلبات التلقائية DELETE /futures/settle/price_orders 3. الاستعلام عن تفاصيل أمر تلقائي واحد GET /futures/settle/price_orders/order_id 4. إلغاء أمر تلقائي واحد DELETE /futures/settle/price_orders/order_id 5. تعديل أمر تلقائي واحد PUT /futures/settle/price_orders/order_id	حقل جديد: 'amount' (نوع سلسلة نصية).	1. حقل جديد: amount (نوع سلسلة نصية). 2. الحقل الأصلي size (عدد صحيح ) والحقل الجديد amount (سلسلة نصية) سيكونان متوافقين.

2. الحقول المتعلقة بـ Websocket

نوع القناة	القناة	الحقول	ملاحظات
عام	1. قناة التداولات العامة futures.trades	حجم التنفيذ 'size'	1. باستخدام رأس X-Gate-Size-Decimal=1 ، سيتغير نوع الحقول المذكورة أعلاه من عدد صحيح إلى سلسلة نصية . 2. يجب على العملاء تعديل نوع القبول لهذه الحقول.
عام	1. قناة المؤشرات futures.tickers	الحجم الإجمالي 'total_size'
عام	1. قناة BBO futures.book_ticker	حجم أفضل مزايدة 'A' حجم أفضل عرض 'B'
عام	1. قناة تحديث العمق futures.order_book_update	حجم العرض المعلق لجانب العرض 'a.s' حجم العرض المعلق لجانب المزايدة 'b.s'
عام	1. قناة العمق الكامل futures.order_book	حجم العرض المعلق لجانب العرض a.s حجم العرض المعلق لجانب المزايدة b.s
عام	1. قناة العمق V2 futures.obu	[السعر، الحجم] 'size' قد يدفع حجم عشري
عام	1. قناة الشموع futures.candlesticks	الحجم 'v'
عام	1. قناة التصفية العامة futures.public_liquidates	حجم أمر التصفية 'size'
عام	1. قناة إحصائيات العقود futures.contract_stats	حجم التصفية الطويلة 'long_liq_size' حجم التصفية القصيرة 'short_liq_size' الحجم الإجمالي للاهتمام الصريح 'open_interest'
خاص	1. قناة الأوامر الخاصة futures.orders	حجم العرض لطلبات الجبل الجليدي 'iceberg' الكمية المتبقية القابلة للتداول 'left' حجم الطلب 'size'
خاص	1. قناة التداولات الخاصة futures.usertrades	حجم التنفيذ 'size'
خاص	1. قناة تقليص المديونية التلقائي الخاصة futures.auto_deleverages	حجم المركز 'position_size' حجم التداول 'trade_size'
خاص	1. قناة المراكز futures.positions	حجم المركز 'size'
خاص	1. قناة أوامر السعر التلقائية futures.autoorders	حقل جديد: 'amount' (نوع سلسلة نصية).	1. حقل جديد: amount (نوع سلسلة نصية). 2. الحقل الأصلي size ( عدد صحيح نوع) والحقل الجديد amount (سلسلة نصية) سيكونان متوافقين.
خاص	1. قناة أوامر التصفية futures.liquidates	الكمية المتبقية القابلة للتداول 'left' حجم المركز 'size'	1. باستخدام رأس X-Gate-Size-Decimal=1 ، سيتغير نوع الحقول المذكورة أعلاه من عدد صحيح إلى سلسلة نصية . 2. يجب على العملاء تعديل نوع القبول لهذه الحقول.
خاص	1. تنفيذ الأوامر futures.order_place 2. تنفيذ أوامر جماعية futures.order_batch_place 3. إلغاء الأوامر futures.order_cancel 4. إلغاء جماعي حسب المعرف futures.order_cancel_cp 5. تعديل الأوامر futures.order_amend 6. الاستعلام عن قائمة الأوامر futures.order_list 7. الاستعلام عن تفاصيل الأوامر futures.order_status	حجم الطلب 'size' الكمية المتبقية القابلة للتداول 'left' كمية العرض لطلبات الجبل الجليدي 'iceberg'

1.4 الاستعلام عن معلومات العقود الآجلة الداعمة لتنفيذ الأوامر العشرية

1. ضبط رأس X-Gate-Size-Decimal=1
2. طلب نقطة نهاية معلومات العقد

curl --location 'https://api.gateio.ws/api/v4/futures/usdt/contracts' \
--header 'X-Gate-Size-Decimal: 1'

3. حقل الإرجاع order_size_min: إذا كانت القيمة عشرية، فهذا يدل على أن العقود الآجلة المعنية تدعم تنفيذ الأوامر العشرية.

1.5 معلومات إضافية

سجل تحديثات API: https://www.gate.com/ar/docs/developers/apiv4/en/#changelog
لأي استفسارات، يرجى التواصل مع الدعم الفني لواجهة البرمجة أو الرجوع إلى وثائق API. نشكركم على دعمكم وتفهمكم.

فريق Gate 18 ديسمبر 2025 **بوابتك إلى عالم العملات الرقمية** تداول أكثر من 4,400 من العملات الرقمية بأمان وسرعة وسهولة عبر Gate **ابدأ الآن** سجّل الآن واطلب مكافآت ترحيبية تصل إلى 10,000 دولار أمريكي ادعُ أصدقاءك واحصل على عمولة بنسبة 40% **ابقَ على تواصل** زر الموقع الرسمي لـ Gate حمّل تطبيق Gate | سطح المكتب تابعنا على X (تويتر) للحصول على المزيد من المكافآت انضم إلى مجتمعنا على تيليجرام لمناقشة أحدث المواضيع تفاعل مع مجتمعنا العالمي للحصول على أحدث الرؤى **الشفافية والأمان** اطلع على إثبات الاحتياطيات بنسبة 100%