Изменения типов полей, связанных с размером фьючерсов
Для повышения гибкости фьючерсной торговли и полной поддержки ордеров с дробным количеством 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 и обязательный переход на тип String
- Все торговые пары контрактов будут полностью поддерживать размещение ордеров с дробным количеством лотов.
- В определенный момент система по умолчанию будет возвращать тип String и изменит значение заголовка (X-Gate-Size-Decimal), переключив поведение обработки по умолчанию с 0 на 1, предоставив короткий переходный период для пользователей, не завершивших адаптацию.
- После переходного периода поле заголовка X-Gate-Size-Decimal будет официально выведено из использования, его настройка утратит силу.
- Все поля, связанные с количеством ордеров, будут использовать исключительно тип String для обеспечения точности и совместимости. Поддержка устаревшего типа Integer будет прекращена.
- Конкретная дата вступления в силу будет объявлена заранее в официальном уведомлении. Просим завершить все необходимые адаптации заблаговременно.
1.2 Подробное описание обновления этапа 1
- В REST и WebSocket API добавлено новое поле заголовка X-Gate-Size-Decimal для управления точностью полей, связанных с количеством.
| Параметр заголовка |
Описание |
Примечания |
| X-Gate-Size-Decimal = 1 |
типы полей, связанных с размером, изменяются с Integer на String |
1. Поддерживается получение данных с десятичными значениями. |
| X-Gate-Size-Decimal = 0 или не используется данный заголовок По умолчанию поле не используется. |
типы полей, связанных с размером, остаются Integer |
1. Не поддерживается получение данных с десятичными значениями.
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 Запрос информации о фьючерсах с поддержкой размещения ордеров с десятичным количеством
- Установить заголовок X-Gate-Size-Decimal=1
- Отправить запрос к endpoint информации о контракте
curl --location 'https://api.gateio.ws/api/v4/futures/usdt/contracts' \
--header 'X-Gate-Size-Decimal: 1'
- Возвращаемое поле order_size_min: если значение является десятичным, соответствующий фьючерс поддерживает размещение ордеров с десятичным количеством.
1.5 Дополнительная информация
Журнал обновлений API: https://www.gate.com/ru/docs/developers/apiv4/en/#changelog
По всем вопросам обращайтесь в техническую поддержку API или ознакомьтесь с документацией API. Благодарим за поддержку и понимание.
Команда Gate
18 декабря 2025 года
**Вход в мир крипто**
Торгуйте более чем 4,500 криптовалютами безопасно, быстро и удобно на Gate
**Действуйте сейчас**
Зарегистрируйтесь и получите до $10 000 приветственных бонусов
Пригласите друзей и заработайте 40% комиссии
**Будьте на связи**
Посетите официальный сайт Gate
Скачайте приложение Gate | Desktop
Подписывайтесь на X (Twitter) чтобы получать больше бонусов
Присоединяйтесь к нашему сообществу в Telegram для обсуждения актуальных тем
Взаимодействуйте с глобальным сообществом чтобы получать последние инсайты
**Прозрачность и безопасность**
Проверьте наши 100% подтверждение резервов
