Валідація часу для ф’ючерсів у Gate API — це можливість перевірки часу, яку Gate додає на рівні механізму зіставлення заявок (ME) у свої API для контрактної торгівлі. Два HTTP-заголовки працюють разом, щоб підтвердити, що запит було надіслано в межах визначеного часового вікна. Клієнт установлює X-Gate-Client-Send-Us як позначку часу надсилання в мікросекундах, а X-Gate-Timeout-Window-Us — як максимальне допустиме вікно, також у мікросекундах. Це оновлення застосовується лише до торгової архітектури Gate 3.0.
Механізм усуває конкретний ризик в алгоритмічній торгівлі: запит, який перебуває в мережевій черзі, повторна спроба повільного клієнта або розсинхронізація годинника можуть призвести до того, що запит надійде до механізму зіставлення заявок значно пізніше, ніж передбачав трейдер. На динамічних ринках контрактної торгівлі відкладений ордер за неправильною ціною створює ризик прослизання та небажаного виконання. Валідація часу надає клієнту декларативний спосіб вказати: «вважати цей запит недійсним через N мікросекунд», переносячи контроль строку дії на рівень ME, а не покладаючись лише на мережевий час.
API 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 API буде запущено 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) для API контрактної торгівлі. Клієнт надсилає 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) у свої API для контрактної торгівлі. Два заголовки запиту — 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 користувачів API Gate 3.0 просять перевірити й оновити логіку інтеграції відповідно до найновіших назв полів, щоб функція валідації часу працювала належним чином.
Механізм застосовується лише до API контрактної (ф’ючерсної) торгівлі в торговій архітектурі Gate 3.0. В офіційному оголошенні зазначено, що інші архітектури наразі не підтримують цю функцію. Для спотової торгівлі, гаманців та інших груп API застосовуються окремі специфікації.
Відмова від відповідальності: Наведений вище матеріал призначений виключно для інформаційних і освітніх цілей та не є фінансовою, інвестиційною або торговою порадою. Торгівля ф’ючерсами та деривативами пов’язана зі значним ризиком збитків. Переглядайте офіційну документацію Gate API, щоб отримати найактуальніші специфікації ендпоїнтів, коди помилок і вимоги до полів.
* Ця інформація не є фінансовою порадою чи будь-якою іншою рекомендацією, запропонованою чи схваленою Gate.
* Цю статтю заборонено відтворювати, передавати чи копіювати без посилання на Gate. Порушення є порушенням Закону про авторське право і може бути предметом судового розгляду.





