Анонс Gate об изменении типа поля количества ордеров в бессрочных контрактах USDT и плане внедрения новых функций

Изменения в типах полей, связанных с размером фьючерсов
В целях повышения гибкости фьючерсной торговли и полного внедрения поддержки ордеров с дробным количеством Gate проведет поэтапное обновление API бессрочных контрактов USDT. Данное обновление затронет логику обработки полей, связанных с количеством (размером) ордера, как в REST API, так и в WebSocket. Рекомендуем заранее проанализировать и скорректировать вашу стратегию согласно этапам обновления, чтобы избежать сбоев в торговле.

1.1 Обзор плана обновления (разделен на 3 этапа)

1. Этап 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 не установлен, поле size по умолчанию продолжит принимать и возвращать тип Integer.

2. Этап 2: Внедрение возможности размещения ордеров с дробным количеством

1. Запуск возможности размещения ордеров с дробным количеством лотов по бессрочным контрактам USDT запланирован на 30 декабря 2025 года. На данном этапе будут активированы только базовые возможности системы и поддержка API. Практически ни один контракт не будет открыт для размещения ордеров с дробным количеством, правила размещения ордеров для пользователей останутся прежними.

2. С конца января 2026 года функция размещения ордеров с дробным количеством будет постепенно внедряться для отдельных контрактов. Перечень контрактов и сроки внедрения будут опубликованы платформой в последующих уведомлениях.

3. Для пользователей, продолжающих использовать старый тип поля без адаптации, возможны следующие проблемы:

• Некорректная обработка точности в данных глубины контракта.
• Несоответствие точности ордеров.
• Некорректная точность в исполненных ордерах.

Всем пользователям API настоятельно рекомендуется завершить адаптацию типов полей до конца января 2026 года.

3. Этап 3: Полное внедрение для всех бессрочных контрактов USDT и обязательный переход на тип поля String

1. Все торговые пары контрактов будут полностью поддерживать размещение ордеров с дробным количеством лотов.
2. В определенный момент система по умолчанию начнет возвращать тип String и изменит значение заголовка (X-Gate-Size-Decimal), переключив стандартную логику обработки с 0 на 1, предоставив короткий переходный период для пользователей, не завершивших адаптацию.
3. По завершении переходного периода заголовок X-Gate-Size-Decimal будет официально выведен из обращения, его настройка перестанет действовать.
4. Все поля, связанные с количеством ордеров, будут использовать только тип String для обеспечения точности и совместимости. Тип Integer поддерживаться не будет.
5. Точная дата вступления изменений в силу будет объявлена дополнительно в официальном уведомлении. Пожалуйста, завершите все необходимые адаптации заранее.

1.2 Подробное описание обновления этапа 1

1.В REST и WebSocket API добавлено новое поле заголовка X-Gate-Size-Decimal для управления точностью полей, связанных с количеством.

Параметр заголовка	Описание	Примечания
X-Gate-Size-Decimal = 1	типы полей, связанных с размером, изменяются с Integer на String	1. Поддержка получения данных с десятичными знаками.
X-Gate-Size-Decimal = 0 или не используется данное поле По умолчанию поле не применяется.	типы полей, связанных с размером, остаются Integer	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

Тип интерфейса	Endpoint	Поле	Примечания
Публичный	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. K-line график фьючерсного рынка 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. Отмена всех ордеров со статусом 'open' 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' Размер позиции после 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	Размер ожидающих на стороне ask 'a.s' Размер ожидающих на стороне bid 'b.s'
Публичный	1. Канал полной глубины futures.order_book	Размер ожидающих на стороне ask a.s Размер ожидающих на стороне bid b.s
Публичный	1. Канал Depth 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. Массовая отмена по ID 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.Выполните запрос к endpoint информации о контракте

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/ru/docs/developers/apiv4/en/#changelog
По вопросам обращайтесь в техническую поддержку API или ознакомьтесь с документацией API. Благодарим за вашу поддержку и понимание

Команда Gate 18 декабря 2025 года **Вход в мир крипто** Торгуйте более чем 4,300 криптовалютами безопасно, быстро и удобно на Gate **Начните прямо сейчас** Зарегистрируйтесь и получите до $10 000 приветственных наград Приглашайте друзей и получайте комиссию 40% **Оставайтесь на связи** Посетите официальный сайт Gate Скачайте приложение Gate | Desktop Подписывайтесь на нас в X (Twitter), чтобы получать больше бонусов Присоединяйтесь к нашему Telegram-сообществу для обсуждения актуальных тем Взаимодействуйте с глобальным сообществом и получайте последние новости **Прозрачность и безопасность** Проверьте наши 100% Proof of Reserves