Проверка времени для фьючерсного API Gate — это функция верификации времени, которую 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 в соответствии с актуальными названиями полей.
Проверка времени для фьючерсного API Gate представляет собой два 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 для конкретного вызываемого эндпоинта. В качестве общего правила всегда устанавливайте оба заголовка вместе.
Проверка времени для фьючерсного API Gate добавляет функцию верификации времени на стороне механизма сопоставления заявок (ME) в API для торговли контрактами. Клиент отправляет X-Gate-Client-Send-Us, временную метку в микросекундах, указывающую время подготовки запроса, и X-Gate-Timeout-Window-Us, максимальное допустимое окно в микросекундах. Это обновление применяется только к торговой архитектуре Gate 3.0 и защищает от исполнений с сетевой задержкой, рассинхронизации часов и воспроизведённых запросов.
Интеграция включает четыре шага: синхронизировать часы, вычислить время отправки в микросекундах, установить оба заголовка в каждом запросе и реализовать логику повторных попыток с пересчётом временной метки. Поддержка REST выпущена 16 ноября 2026 года, а WebSocket появится 19 ноября 2026 года. Функция распространяется на интерфейсы торговли контрактами Gate 3.0.
Проверка времени для фьючерсного API Gate — это функция верификации времени, которую 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. Нарушение является нарушением Закона об авторском праве и может повлечь за собой судебное разбирательство.





