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

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

2025-12-18 11:53:58 UTC 25098 Прочли

[//]:content-type-MARKDOWN-DONOT-DELETE
**Изменения типов полей, связанных с размером фьючерсов**
Для повышения гибкости фьючерсной торговли и полной поддержки ордеров с дробным количеством Gate проведет поэтапное обновление API бессрочных контрактов USDT. Это обновление затронет логику обработки полей, связанных с количеством ордера (размером), как в REST API, так и в WebSocket. Просим заранее оценить и скорректировать вашу стратегию согласно поэтапному плану, чтобы обеспечить бесперебойную торговлю.

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

**1. Этап 1: Обновление совместимости типов полей (запущено 9 декабря 2025 года)**

- Завершены корректировки базовой структуры данных.
- Изменен тип данных полей, связанных с количеством контрактов, с Integer на String.
- Система работает в режиме совместимости. При включении поля X-Gate-Size-Decimal в заголовке запроса обеспечивается совместимая обработка поля количества лотов контракта.

* Если заголовок X-Gate-Size-Decimal не установлен, поле размера по умолчанию продолжит принимать и возвращать тип 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 для управления точностью полей, связанных с количеством.

Рекомендация: Клиентам следует оперативно адаптироваться к изменению типов полей количества контрактов. После официальной поддержки размещения ордеров с дробным количеством, вы сможете быстро воспользоваться данной функцией.

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-линий рынка фьючерсов 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 | Ожидаемый размер на стороне ask 'a.s' Ожидаемый размер на стороне bid 'b.s' | |
| Публичный | 1. Канал полной глубины futures.order_book | Ожидаемый размер на стороне ask a.s Ожидаемый размер на стороне bid b.s | |
| Публичный | 1. Канал глубины V2 futures.obu | [цена, размер] 'size' Может отправлять дробный размер | |
| Публичный | 1. Канал K-линий 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. Благодарим за поддержку и понимание.

<sp>
Команда Gate
18 декабря 2025 года
<sp>
**Вход в мир крипто**
Торгуйте более чем %Amount_of_Currency% криптовалютами безопасно, быстро и удобно на Gate
**Действуйте сейчас**
<a href="https://www.gate.com/ru/signup" target="_blank">Зарегистрируйтесь</a> и получите до $10 000 приветственных бонусов
<a href="https://www.gate.com/ru/referral" target="_blank">Пригласите друзей</a> и заработайте 40% комиссии
**Будьте на связи**
<a href="https://www.gate.com/ru/" target="_blank">Посетите официальный сайт Gate</a>
<a href="https://www.gate.com/ru/mobileapp?ch=ann48788" target="_blank">Скачайте приложение Gate | Desktop</a>
<a href="https://x.com/Gate" rel="nofollow noopener noreferrer" target="_blank">Подписывайтесь на X (Twitter)</a> чтобы получать больше бонусов
<a href="https://t.me/GateCom_EN" rel="nofollow noopener noreferrer" target="_blank">Присоединяйтесь к нашему сообществу в Telegram</a> для обсуждения актуальных тем
<a href="https://www.gate.com/ru/community" target="_blank">Взаимодействуйте с глобальным сообществом</a> чтобы получать последние инсайты
**Прозрачность и безопасность**
<a href="https://www.gate.com/ru/proof-of-reserves" target="_blank">Проверьте наши 100% подтверждение резервов</a>

Примечание: Это перевод оригинального английского текста, выполненный машиной или человеком, поэтому в переводе могут быть неточности. Нажмите здесь, чтобы увидеть оригинальный английский текст.

Изменение и время начала-окончания графика

Цвета обозначения роста и падения

Pay With

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

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

Выберите язык и регион

Выберите свой регион

Фиатные Валюты