Зміни у типах полів, пов’язаних із розміром ф’ючерсів
З метою підвищення гнучкості ф’ючерсної торгівлі та повної підтримки ордерів із дробовою кількістю, 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 не встановлено, поле розміру за замовчуванням приймає та повертає тип Integer.
2. Етап 2: Запуск можливості оформлення ордерів із дробовою кількістю
-
Можливість оформлення ордерів із дробовою кількістю лотів для безстрокових контрактів USDT запланована на запуск 30 грудня 2025 року. На цьому етапі буде активовано лише базові можливості системи та підтримку API. Жоден контракт на цьому етапі фактично не буде відкритий для оформлення ордерів із дробовою кількістю, і чинні правила оформлення ордерів для користувачів залишаться без змін.
-
Починаючи з кінця січня 2026 року, функціональність оформлення ордерів із дробовою кількістю буде поступово впроваджуватися для контрактів. Конкретні контракти та строки впровадження будуть оголошені платформою у подальших повідомленнях.
-
Для користувачів, які продовжують використовувати старий тип полів без адаптації, можуть виникнути такі проблеми:
- Некоректний розбір точності у даних глибини контракту.
- Непослідовна точність ордерів.
- Некоректна точність у виконаних ордерах.
Тому всім користувачам API рекомендується максимально завершити адаптацію типів полів до кінця січня 2026 року.
3. Етап 3: Повне впровадження для всіх безстрокових контрактів USDT-M та обов’язковий перехід на тип полів String
- Всі торгові пари контрактів повністю підтримуватимуть оформлення ордерів із дробовою кількістю лотів.
- У визначений час система за замовчуванням повертатиме тип String і змінить значення за замовчуванням для заголовка (X-Gate-Size-Decimal), переключивши поведінку розбору за замовчуванням із 0 на 1, щоб надати короткий перехідний період для користувачів, які ще не завершили адаптацію.
- Після завершення перехідного періоду поле заголовка X-Gate-Size-Decimal буде офіційно скасовано, і його налаштування більше не матимуть сили.
- Всі поля, пов’язані з кількістю ордерів, будуть уніфіковано використовувати тип String для забезпечення точності та сумісності. Тип Integer більше не підтримуватиметься.
- Конкретна дата набуття чинності буде оголошена заздалегідь через офіційне повідомлення. Будь ласка, переконайтеся, що всі адаптації завершені завчасно.
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. Графік К-ліній ф’ючерсного ринку
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 '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_deleverges
|
Розмір угоди '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 |
Розмір очікування на стороні аск 'a.s'
Розмір очікування на стороні бід 'b.s' |
|
| Публічний |
1. Канал повної глибини
futures.order_book
|
Розмір очікування на стороні аск
a.s
Розмір очікування на стороні бід
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 '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 'iceberg' |
|
1.4 Запит інформації про ф’ючерси, які підтримують розміщення ордерів із десятковим розміром
1.Встановіть заголовок X-Gate-Size-Decimal=1
2.Виконайте запит до endpoint Contract Information
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
18 грудня 2025 року
**Шлях до криптовалюти**
Торгуйте понад 4,500 криптовалютами безпечно, швидко та зручно на Gate
**Дійте зараз**
Зареєструйтеся та отримайте до $10 000 вітальних бонусів
Запрошуйте друзів та отримуйте 40% комісії
**Залишайтеся на зв’язку**
Відвідайте офіційний сайт Gate
Завантажте застосунок Gate | Десктоп
Підписуйтеся на нас у X (Twitter), щоб отримати більше бонусів
Приєднуйтеся до нашої спільноти у Telegram для обговорення актуальних тем
Долучайтеся до нашої глобальної спільноти для отримання останніх інсайтів
**Прозорість і безпека**
Перевірте наші 100% підтвердження резервів
