التحقق الزمني لعقود Gate API هو قدرة للتحقق من الوقت تضيفها Gate على جانب محرك المطابقة (ME) في واجهات برمجة تطبيقات تداول العقود الخاصة بها. يعمل رأسا HTTP معًا لتأكيد إرسال طلب ضمن نافذة زمنية محددة. يضبط العميل X-Gate-Client-Send-Us على الطابع الزمني للإرسال بالميكروثانية، ويضبط X-Gate-Timeout-Window-Us على الحد الأقصى للنافذة الصالحة، أيضًا بالميكروثانية. ينطبق هذا التحديث على بنية التداول Gate 3.0 فقط.
تعالج الآلية خطرًا ملموسًا في التداول الخوارزمي: فقد يصل طلب ظل في قائمة انتظار بالشبكة، أو أُعيدت محاولته ببطء من العميل، أو تأثر بانحراف الساعة، إلى محرك المطابقة بعد وقت طويل من نية المتداول. في أسواق تداول العقود سريعة الحركة، ينشئ الأمر المتأخر بسعر غير مناسب مخاطر الانزلاق السعري والتنفيذات غير المرغوبة. يمنح التحقق الزمني العميل طريقة تعريفية للقول: "اعتبر هذا الطلب غير صالح بعد N ميكروثانية"، مما يضع التحكم في انتهاء الصلاحية على طبقة ME بدلًا من الاعتماد على توقيت الشبكة وحده.
تدعم واجهات برمجة تطبيقات تداول العقود في Gate الآن رأسي طلب للتحقق الزمني على جانب محرك المطابقة (ME): X-Gate-Client-Send-Us وX-Gate-Timeout-Window-Us، وكلاهما بالميكروثانية.
يحمل X-Gate-Client-Send-Us الطابع الزمني لإرسال العميل بالميكروثانية منذ حقبة Unix. يقارن الخادم هذه القيمة بساعته الخاصة عند الاستلام.
يحدد X-Gate-Timeout-Window-Us الحد الأقصى للنافذة الزمنية الصالحة للطلب بالميكروثانية. إذا تجاوز الوقت المنقضي بين الطابع الزمني للإرسال واستلام الخادم هذه النافذة، يُرفض الطلب.
طُرحت نقاط نهاية REST في 16 نوفمبر 2026. ويتبعها دعم WebSocket في 19 نوفمبر 2026.
تنطبق الآلية فقط على بنية التداول Gate 3.0 لواجهات تداول العقود (العقود الآجلة)؛ ولا تدعم البنى الأخرى هذه الميزة حاليًا. خطوات التكامل هي: مزامنة ساعتك، وحساب الطابع الزمني للإرسال بالميكروثانية، وضبط الرأسين، والتحقق من منطق تكامل API وتحديثه وفقًا لأحدث أسماء الحقول.
التحقق الزمني لعقود Gate API هو زوج من رؤوس HTTP يتيح للعميل تحديد مدة بقاء الطلب صالحًا. تعمل الآلية على مستوى النقل قبل أن يعالج محرك المطابقة الطلب. يقرأ الخادم الرأسين في كل استدعاء وارد لواجهة API للعقود، ويحسب الفرق بين وقت استلامه الخاص والطابع الزمني للإرسال الذي حدده العميل، ثم يقارن النتيجة بنافذة المهلة المحددة.
يحمل X-Gate-Client-Send-Us الطابع الزمني، بالميكروثانية منذ حقبة Unix، لوقت إرسال العميل للطلب. تتوافق القيمة 1794794400123456 مع نقطة زمنية محددة بدقة الميكروثانية. الوحدة هي الميكروثانية، وليست المللي ثانية أو الثواني، وهو خطأ شائع في التكامل ينتج عنه أخطاء "الطابع الزمني قديم جدًا" أو "الطابع الزمني بعيد جدًا في المستقبل".
يخبر الرأس الخادم بموعد مغادرة الطلب من العميل. ثم يحسب الخادم الوقت المنقضي بطرح هذه القيمة من الطابع الزمني الخاص به عند الاستلام. إذا كانت ساعة العميل غير متزامنة بدرجة كبيرة مع ساعة الخادم، فسيكون الوقت المنقضي المحسوب غير صحيح حتى لو كان زمن استجابة الشبكة طبيعيًا.
يحدد X-Gate-Timeout-Window-Us الحد الأقصى للنافذة الزمنية الصالحة للطلب، بالميكروثانية. يرفض الخادم أي طلب يتجاوز وقته المنقضي هذه النافذة. تتوافق القيمة 5000000 مع خمس ثوانٍ. وتتوافق القيمة 500000 مع نصف ثانية، وهي نافذة أكثر تشددًا تناسب وضع الأوامر الحساس لزمن الاستجابة.
يمنح الرأس العميل تحكمًا صريحًا في مدى تقادم الطلب المسموح به. تقلل النافذة الضيقة مخاطر التنفيذ وفق ظروف سوق قديمة. أما النافذة الأوسع فتتسامح مع تقلبات الشبكة وانحراف الساعة، لكنها تتيح وقتًا أطول لتحرك أسعار السوق بين نية العميل وتنفيذ الخادم.
في أسواق العقود والعقود الآجلة، يمكن أن يتحرك السعر خلال مللي ثانية. وقد يصل أمر كان المقصود تنفيذه بالسعر الحالي بعد ثوانٍ عندما يكون السوق قد تغير بالفعل. دون التحقق الزمني، لا تملك API طريقة لمعرفة ما إذا كان العميل يقصد التأخير أو ما إذا كان الطلب قد أُعيد تشغيله أو تكراره أو علق في قائمة انتظار.
يعالج التحقق الزمني ثلاثة سيناريوهات ملموسة:
ارتفاعات زمن استجابة الشبكة. يمكن رفض الطلب الذي يستغرق وقتًا أطول من المتوقع للوصول إلى الخادم قبل أن يعالجه محرك المطابقة، مما يمنع التنفيذ بأسعار لم يعد المتداول يعتبرها مقبولة.
انحراف ساعة العميل. إذا كانت ساعة نظام العميل متقدمة على ساعة الخادم أو متأخرة عنها، فسيكون الوقت المنقضي المحسوب منحرفًا. يمكن للعميل اكتشاف ذلك من استجابة الخطأ وضبط مزامنة ساعته.
الطلبات المعاد تشغيلها أو المكررة. يُرفض الطلب الذي يتم اعتراضه وإعادة تشغيله بعد انتهاء نافذته لأن الخادم يرى أن الوقت المنقضي يتجاوز النافذة المحددة. يضيف ذلك طبقة حماية ضد بعض هجمات إعادة التشغيل تتجاوز المصادقة القائمة على التوقيع.
يوضح الإعلان الرسمي أن هذا التحديث يعزز قدرة التحقق من الوقت على جانب محرك المطابقة (ME) لطلبات تداول العقود. ينبغي لمستخدمي بنية التداول Gate 3.0 مراجعة منطق تكامل API الخاص بهم وتحديثه وفقًا لأحدث أسماء الحقول لضمان عمل ميزة التحقق الزمني بشكل صحيح.
قبل ضبط رأس الطابع الزمني، تأكد من مزامنة ساعة العميل مع مصدر وقت موثوق. استخدم NTP أو استعلم عن نقطة نهاية وقت خادم Gate وسجل الإزاحة بين ساعتك المحلية والخادم. تحافظ إعادة المزامنة الدورية على الانحراف ضمن الحدود المقبولة. تحافظ معظم إعدادات NTP القياسية على الانحراف دون بضعة مللي ثوانٍ، وهو ضمن نافذة مهلة نموذجية تتراوح بين 1 و5 ثوانٍ.
عند إعداد كل طلب، التقط الوقت الحالي بالميكروثانية منذ حقبة Unix. توفر معظم اللغات ذلك مباشرة:
import time
send_us = int(time.time() * 1_000_000)
const sendUs = Date.now() * 1000;
اكتب هذه القيمة في رأس X-Gate-Client-Send-Us.
اختر نافذة تتوافق مع تحمل استراتيجية التداول الخاصة بك لزمن الاستجابة. بالنسبة إلى استراتيجيات صناعة السوق أو المضاربة السريعة التي تتطلب تحكمًا دقيقًا، فإن 500000 ميكروثانية (0.5 ثانية) مناسبة. أما الاستراتيجيات الأبطأ، مثل التداول الشبكي أو إعادة موازنة المحفظة، فتتيح 5000000 ميكروثانية (5 ثوانٍ) تحملًا أكبر.
اكتب هذه القيمة في رأس X-Gate-Timeout-Window-Us.
عندما يرفض الخادم طلبًا لأن الوقت المنقضي يتجاوز النافذة، تعرض API استجابة خطأ. ينبغي للعميل لديك:
لا تعِد استخدام الرؤوس الأصلية عند إعادة المحاولة. يجب أن يحمل كل طلب جديد طابعًا زمنيًا ونافذة جديدين.
بمرور الوقت، قد تنحرف ساعات العميل مقارنة بالخادم. جدوِل مزامنات NTP دورية أو استعلم عن نقطة نهاية وقت خادم Gate واضبط الإزاحة لديك. يمكنك أيضًا إضافة فحص حالة خفيف إلى وحدة التحكم أو لوحة المراقبة لديك يعرض الإزاحة بين الوقت المحلي ووقت الخادم عند كل عملية نشر. راقب معدل إخفاقات التحقق الزمني باعتباره مؤشرًا على الحالة التشغيلية؛ فارتفاع معدل الإخفاقات غالبًا ما يشير إلى انحراف الساعة بدلًا من مشكلات الشبكة.
طُرحت نقاط نهاية REST أولًا في 16 نوفمبر 2026. ويتبعها دعم WebSocket في 19 نوفمبر 2026. وينطبق كلاهما فقط على بنية التداول Gate 3.0؛ ولا تدعم البنى الأخرى هذه الميزة حاليًا.
يحمل كل طلب HTTP الرأسين بشكل مستقل. يحسب العميل الطابع الزمني للإرسال في لحظة إعداد الطلب. لا توجد حالة اتصال يجب الحفاظ عليها؛ إذ يكون كل طلب مستقلًا بذاته.
بالنسبة إلى WebSocket، يكون الاتصال مستمرًا. يرسل العميل رسالة عبر اتصال قائم. يجب أن يعكس الطابع الزمني للإرسال وقت كتابة الرسالة في المقبس، وليس وقت إنشاء الاتصال.
| الجانب | REST API | WebSocket API |
|---|---|---|
| تاريخ الإصدار | 16 نوفمبر 2026 | 19 نوفمبر 2026 |
| نموذج الاتصال | بلا حالة (لكل طلب) | مستمر (لكل اتصال) |
| توقيت الطابع الزمني | عند إعداد الطلب | عند كتابة الرسالة في المقبس |
| النطاق | تداول العقود Gate 3.0 فقط | تداول العقود Gate 3.0 فقط |
| ملاحظة التكامل | اضبط الرأسين في كل طلب | احسب الطوابع الزمنية لكل رسالة، وليس لكل اتصال |
تستفيد عمليات وضع الأوامر وإدارة الاشتراكات عبر WebSocket من قدرة التحقق من الوقت نفسها: إذ يخضع طلب اشتراك قديم أو رسالة أمر متأخرة للتحقق الزمني نفسه على جانب ME.
أكثر أخطاء التكامل شيوعًا هو إرسال طابع زمني بالمللي ثانية أو الثواني بدلًا من الميكروثانية. يكون الطابع الزمني بالمللي ثانية أصغر بثلاث رتب مقدار من الطابع الزمني بالميكروثانية. سيرى الخادم وقتًا منقضيًا سالبًا فعليًا أو بعيدًا جدًا في الماضي. اضرب دائمًا في 1,000,000 عند البدء من الثواني، أو في 1,000 عند البدء من المللي ثانية.
إذا كانت ساعة العميل متقدمة على ساعة الخادم أو متأخرة عنها بأكثر من نافذة المهلة، فسيتم رفض كل طلب. الحل هو مزامنة الساعة. إذا لم تتمكن من تشغيل NTP، فاحسب إزاحة من نقطة نهاية وقت خادم Gate وطبّقها قبل إنشاء الطابع الزمني للإرسال.
قد تكون نافذة قدرها 100000 ميكروثانية (0.1 ثانية) ضيقة جدًا لمسارات الشبكة عبر المناطق أو للعملاء ذوي زمن الاستجابة المتغير. إذا كنت ترى رفضًا متكررًا مع نافذة ضيقة، فوسّعها تدريجيًا حتى ينخفض معدل الرفض إلى مستوى مقبول. ابدأ بـ1000000 ميكروثانية (1 ثانية) لمعظم الاستراتيجيات.
توفر النافذة الكبيرة جدًا، مثل 60000000 ميكروثانية أو 60 ثانية، حماية محدودة من عمليات التنفيذ القديمة. في سوق عقود سريع الحركة، من شبه المؤكد أن يُنفذ طلب عمره 60 ثانية بسعر بعيد عن السوق الحالي. طابق النافذة مع تحمل استراتيجية التداول الفعلي لزمن الاستجابة.
إذا حذفت أيًا من الرأسين، فقد تتعامل API مع الطلب على أنه يفتقر إلى التحقق الزمني. يعتمد السلوك على نقطة النهاية وإعداداتها؛ راجع وثائق API الرسمية لنقطة النهاية المحددة التي تستدعيها. وكإجراء عام، اضبط الرأسين دائمًا معًا.
يضيف التحقق الزمني لعقود Gate API قدرة للتحقق من الوقت على جانب محرك المطابقة (ME) لواجهات برمجة تطبيقات تداول العقود. يرسل العميل X-Gate-Client-Send-Us (طابعًا زمنيًا بالميكروثانية لوقت إعداد الطلب) وX-Gate-Timeout-Window-Us (النافذة الصالحة القصوى بالميكروثانية). ينطبق هذا التحديث على بنية التداول Gate 3.0 فقط، ويوفر حماية من عمليات التنفيذ المتأخرة بسبب الشبكة، وانحراف الساعة، والطلبات المعاد تشغيلها.
يتطلب التكامل أربع خطوات: مزامنة ساعتك، وحساب الطابع الزمني للإرسال بالميكروثانية، وضبط الرأسين في كل طلب، وتنفيذ منطق إعادة المحاولة الذي يعيد حساب الطابع الزمني. طُرح دعم REST في 16 نوفمبر 2026، ويتبع دعم WebSocket في 19 نوفمبر 2026، ويغطيان واجهات تداول العقود Gate 3.0.
التحقق الزمني لعقود Gate API هو قدرة للتحقق من الوقت تضيفها Gate على جانب محرك المطابقة (ME) في واجهات برمجة تطبيقات تداول العقود الخاصة بها. يعمل رأسا الطلب X-Gate-Client-Send-Us وX-Gate-Timeout-Window-Us معًا لتأكيد إرسال طلب ضمن نافذة محددة. ينطبق التحديث على بنية التداول Gate 3.0 فقط.
يمكن أن تتغير أسعار سوق العقود خلال مللي ثانية. وقد يصل أمر متأخر إلى محرك المطابقة بعد وقت طويل من نية المتداول، مما يؤدي إلى تنفيذات غير مرغوبة. يمنح التحقق الزمني العميل طريقة تعريفية للقول: "اعتبر هذا الطلب غير صالح بعد N ميكروثانية"، مما يوفر حماية من تأخيرات الشبكة وانحراف الساعة والطلبات المعاد تشغيلها.
صُمم الرأسـان لاستخدامهما معًا. يوفر X-Gate-Client-Send-Us الطابع الزمني للإرسال، ويوفر X-Gate-Timeout-Window-Us نافذة الصلاحية. ويعني حذف أي منهما أن الخادم لا يمكنه إجراء المقارنة الزمنية. راجع وثائق API الرسمية لمعرفة المتطلبات المحددة لكل نقطة نهاية.
يعتمد السلوك الافتراضي عند حذف X-Gate-Timeout-Window-Us على إعدادات نقطة النهاية. تحدد وثائق Gate API الرسمية القيمة الافتراضية. ينبغي للعملاء الذين يحتاجون إلى تحكم صريح ضبط الرأس دائمًا بدلًا من الاعتماد على القيمة الافتراضية.
يستخدم كلا الرأسين الميكروثانية منذ حقبة Unix. تساوي الثانية الواحدة 1000000 ميكروثانية. ويساوي المللي ثانية الواحد 1000 ميكروثانية.
تعرض API خطأ يشير إلى فشل الطلب في التحقق الزمني على جانب محرك المطابقة. يتم توثيق رمز الخطأ الدقيق وتنسيق الرسالة في مرجع أخطاء Gate API الرسمي. ينبغي للعملاء التعامل مع هذا الخطأ عبر إعادة حساب الطابع الزمني وإعادة المحاولة.
يستمر العملاء الحاليون الذين لا يرسلون الرؤوس الجديدة في العمل وفق السلوك السابق. يطلب إعلان Gate الرسمي من مستخدمي Gate 3.0 API التحقق من منطق التكامل لديهم وتحديثه وفقًا لأحدث أسماء الحقول لضمان عمل ميزة التحقق الزمني بشكل صحيح.
تنطبق الآلية فقط على بنية التداول Gate 3.0 لواجهات API لتداول العقود (العقود الآجلة). ينص الإعلان الرسمي على أن البنى الأخرى لا تدعم هذه الميزة حاليًا. يخضع التداول الفوري والمحفظة ومجموعات API الأخرى لمواصفات منفصلة.
إخلاء المسؤولية: المحتوى أعلاه مخصص للأغراض المعلوماتية والتعليمية فقط، ولا يشكل نصيحة مالية أو استثمارية أو متعلقة بالتداول. ينطوي تداول العقود الآجلة والمشتقات على مخاطر كبيرة للخسارة. راجع وثائق Gate API الرسمية للاطلاع على أحدث مواصفات نقاط النهاية ورموز الأخطاء ومتطلبات الحقول.
فحوصات الجودة:
فحوصات الجودة:
* لا يُقصد من المعلومات أن تكون أو أن تشكل نصيحة مالية أو أي توصية أخرى من أي نوع تقدمها منصة Gate أو تصادق عليها .
* لا يجوز إعادة إنتاج هذه المقالة أو نقلها أو نسخها دون الرجوع إلى منصة Gate. المخالفة هي انتهاك لقانون حقوق الطبع والنشر وقد تخضع لإجراءات قانونية.





