Оголошення Gate щодо зміни типу поля кількості ордеру у безстрокових контрактах USDT та плану впровадження нової функції

Зміни у типах полів, пов’язаних із розміром ф’ючерсів
З метою підвищення гнучкості ф’ючерсної торгівлі та повної підтримки ордерів з дробовою кількістю Gate впроваджує поетапне оновлення API безстрокових контрактів USDT. Це оновлення вплине на логіку обробки полів, що стосуються розміру ордера (size), як у 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	Size 's'
Публічний	1. Записи угод ринку ф’ючерсів GET /futures/settle/trades	Розмір угоди 'size'
Публічний	1. Графік K-line ринку ф’ючерсів GET /futures/settle/candlesticks	обсяг size (розмір контракту) '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	Найкращий розмір bid 'A' Найкращий розмір ask '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	[price,size] '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/uk/docs/developers/apiv4/en/#changelog
З усіх питань звертайтеся до технічної підтримки API або ознайомтеся з документацією API. Дякуємо за вашу підтримку та розуміння

Gate Team 18 грудня 2025 року **Gateway to Crypto** Торгуйте понад 4,400 криптовалютами безпечно, швидко та зручно на Gate **Дійте зараз** Зареєструйтеся та отримайте до $10 000 вітальних нагород Запросіть друзів і отримайте 40% комісійних **Залишайтеся на зв’язку** Відвідайте офіційний сайт Gate Завантажте додаток Gate | Desktop Підписуйтеся на X (Twitter), щоб отримати більше бонусів Приєднуйтесь до нашої спільноти в Telegram для обговорення актуальних тем Долучайтеся до нашої глобальної спільноти для отримання останніх новин **Прозорість та безпека** Перевірте наш 100% Proof of Reserves