تغييرات على أنواع الحقول المتعلقة بحجم العقود الآجلة
من أجل تعزيز مرونة تداول العقود الآجلة ودعم أوامر الكميات الكسرية بشكل كامل، ستقوم Gate بتنفيذ ترقية تدريجية لواجهات برمجة التطبيقات لعقود USDT الدائمة. ستؤثر هذه الترقية على منطق تحليل الحقول المرتبطة بكمية الطلب (الحجم) في كل من REST API وWebSocket. يرجى تقييم وتعديل منطق استراتيجيتك مسبقًا وفقًا للخطة المرحلية لضمان استمرار تداولاتك دون تأثر.
1.1 نظرة عامة على خطة الترقية (مقسمة إلى 3 مراحل)
1. المرحلة الأولى: ترقية توافق نوع الحقل (تم إطلاقها في 9 ديسمبر 2025)
- تم الانتهاء من تعديلات بنية البيانات الأساسية.
- تم تعديل نوع بيانات الحقول المتعلقة بكمية العقد من Integer إلى String.
- النظام حاليًا في وضع التوافق. من خلال تضمين حقل X-Gate-Size-Decimal في ترويسة الطلب، يتم تحقيق معالجة توافقية لحقل كمية العقود.
| معلمة الترويسة |
الوصف |
الملاحظات |
| X-Gate-Size-Decimal = 1 |
تتغير أنواع الحقول المتعلقة بالحجم من Integer إلى String |
1. يدعم استقبال البيانات العشرية. |
| X-Gate-Size-Decimal = 0 أو عدم استخدام هذا الحقل في الترويسة افتراضيًا، هذا الحقل غير مستخدم. |
تظل أنواع الحقول المتعلقة بالحجم Integer |
1. لا يدعم استقبال البيانات العشرية.
2. معالجة الدقة - يتم التقريب للأسفل (نحو الصفر). |
- إذا لم يتم تعيين ترويسة X-Gate-Size-Decimal، سيستمر حقل الحجم في قبول وإرجاع النوع Integer افتراضيًا.
2. المرحلة الثانية: إطلاق إمكانية أوامر الكميات الكسرية
-
من المقرر إطلاق إمكانية النظام لأوامر الكميات الكسرية على عقود USDT الدائمة في 30 ديسمبر 2025. خلال هذه المرحلة، سيتم تفعيل القدرات الأساسية للنظام ودعم واجهات برمجة التطبيقات فقط. لن يتم فتح أي عقود فعليًا للأوامر الكسرية في هذا الوقت، وستظل قواعد تنفيذ الأوامر الفعلية للمستخدمين دون تغيير.
-
اعتبارًا من أواخر يناير 2026، سيتم طرح وظيفة أوامر الكميات الكسرية تدريجيًا على العقود. وسيتم الإعلان عن العقود المحددة والجداول الزمنية للطرح من قبل المنصة في إشعارات لاحقة.
-
بالنسبة للمستخدمين الذين لا يزالون يستخدمون نوع الحقل القديم دون التكيف، قد تظهر المشكلات التالية:
- تحليل الدقة بشكل غير طبيعي في بيانات عمق العقد.
- عدم اتساق دقة الأوامر.
- دقة غير طبيعية في الأوامر المنفذة.
لذا، يُذكّر جميع مستخدمي API بإكمال التكيف مع نوع الحقل قدر الإمكان قبل نهاية يناير 2026.
3. المرحلة الثالثة: التفعيل الكامل لجميع عقود USDT-M الدائمة والانتقال الإجباري إلى أنواع الحقول String
- ستدعم جميع أزواج تداول العقود بشكل كامل تنفيذ أوامر الكميات الكسرية.
- في وقت محدد، سيقوم النظام افتراضيًا بإرجاع النوع String وتعديل القيمة الافتراضية للترويسة (X-Gate-Size-Decimal)، مع تحويل سلوك التحليل الافتراضي من 0 إلى 1 لتوفير فترة انتقالية قصيرة للمستخدمين الذين لم يكملوا التكيف بعد.
- بعد فترة الانتقال، سيتم إيقاف العمل رسميًا بحقل ترويسة X-Gate-Size-Decimal، ولن يكون لإعداده أي تأثير.
- سيتم توحيد جميع الحقول المتعلقة بكمية الأوامر لاستخدام النوع String لضمان الدقة والتوافق. ولن يتم دعم النوع Integer القديم بعد ذلك.
- سيتم الإعلان عن تاريخ النفاذ المحدد مسبقًا عبر إشعار رسمي. يرجى التأكد من إكمال جميع التعديلات مسبقًا.
1.2 شرح تفصيلي لترقية المرحلة الأولى
- تم إدخال حقل ترويسة جديد X-Gate-Size-Decimal في كل من REST وWebSocket للتحكم في دقة الحقول المتعلقة بالكمية.
| معلمة الترويسة |
الوصف |
الملاحظات |
| X-Gate-Size-Decimal = 1 |
تتغير أنواع الحقول المتعلقة بالحجم من Integer إلى String |
1. يدعم استقبال البيانات العشرية. |
| X-Gate-Size-Decimal = 0 أو عدم استخدام هذا الحقل في الترويسة افتراضيًا، هذا الحقل غير مستخدم. |
تظل أنواع الحقول المتعلقة بالحجم Integer |
1. لا يدعم استقبال البيانات العشرية.
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
، سيتغير نوع الحقول أعلاه من
Integer
إلى
String
.
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
3. إلغاء جميع الأوامر ذات الحالة 'open'
DELETE /futures/settle/orders
4. الاستعلام عن قائمة الأوامر حسب النطاق الزمني
GET /futures/settle/orders_timerange
5. تنفيذ أوامر العقود الآجلة دفعة واحدة
POST /futures/settle/batch_orders
6. الاستعلام عن تفاصيل أمر واحد
GET /futures/settle/orders/order_id
7. إلغاء أمر واحد
DELETE /futures/settle/orders/order_id
8. تعديل أمر واحد
PUT /futures/settle/orders/order_id
9. تنفيذ أمر عقد 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' حجم المركز بعد ADL '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' (نوع string).
|
1. حقل جديد:
amount
(نوع string).
2. الحقل الأصلي
size
(int ) والحقل الجديد
amount
(string) سيكونان متوافقين.
|
2. الحقول المتعلقة بـ Websocket
| نوع القناة |
القناة |
الحقول |
الملاحظات |
| عام |
1. قناة التداولات العامة
futures.trades
|
الحجم المنفذ 'size'
|
1. باستخدام حقل الترويسة
X-Gate-Size-Decimal=1
، سيتغير نوع الحقول أعلاه من
Integer
إلى
String
.
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. قناة ADL الخاصة futures.auto_deleverages |
حجم المركز 'position_size'
حجم التداول 'trade_size' |
|
| خاص |
1. قناة المراكز
futures.positions |
حجم المركز 'size' |
|
| خاص |
1. قناة أوامر التفعيل السعري
futures.autoorders
|
حقل جديد: 'amount' (نوع string). |
1. حقل جديد:
amount
(نوع string).
2. الحقل الأصلي
size
(
نوع Integer
) والحقل الجديد
amount
(String) سيكونان متوافقين. |
| خاص |
1. قناة أوامر التصفية
futures.liquidates
|
حجم التداول المتبقي 'left'
حجم المركز 'size' |
1. باستخدام حقل الترويسة
X-Gate-Size-Decimal=1
، سيتغير نوع الحقول أعلاه من
Integer
إلى
String
.
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 الاستعلام عن معلومات العقود الآجلة الداعمة لتنفيذ أوامر بالحجم العشري
- تعيين ترويسة X-Gate-Size-Decimal=1
- طلب نقطة نهاية معلومات العقد
curl --location 'https://api.gateio.ws/api/v4/futures/usdt/contracts' \
--header 'X-Gate-Size-Decimal: 1'
- حقل الإرجاع order_size_min: إذا كانت القيمة عشرية، فهذا يشير إلى أن العقود الآجلة المعنية تدعم تنفيذ أوامر بالحجم العشري.
1.5 معلومات إضافية
سجل تحديثات API: https://www.gate.com/ar/docs/developers/apiv4/en/#changelog
لأي استفسارات، يرجى التواصل مع دعم Gate الفني لواجهات البرمجة أو الرجوع إلى وثائق API. نشكركم على دعمكم وتفهمكم.
Gate Team
18 ديسمبر 2025
**بوابتك إلى عالم العملات الرقمية**
تداول أكثر من 4,500 عملة رقمية بأمان وسرعة وسهولة على Gate
**اتخذ الخطوة الآن**
سجل الآن واحصل على مكافآت ترحيبية تصل إلى $10,000
ادعُ أصدقاءك واربح عمولة %40
**ابقَ على تواصل**
تفضل بزيارة الموقع الرسمي لـ Gate
حمّل تطبيق Gate | سطح المكتب
تابعنا على X (تويتر) للحصول على المزيد من المكافآت
انضم إلى مجتمعنا على تيليجرام لمناقشة المواضيع الرائجة
تفاعل مع مجتمعنا العالمي لأحدث التحليلات
**الشفافية والأمان**
اطلع على إثبات الاحتياطي %100 الخاص بنا
