Thông báo của Gate về việc thay đổi loại trường số lượng lệnh Hợp đồng USDT vĩnh cửu và kế hoạch triển khai tính năng mới

Biến động về Loại Trường Liên Quan Quy mô Hợp đồng Futures
Nhằm nâng cao tính linh hoạt trong giao dịch futures và hỗ trợ đầy đủ cho lệnh với số lượng phân số, Gate sẽ triển khai nâng cấp theo từng giai đoạn đối với API hợp đồng USDT vĩnh cửu. Việc nâng cấp này sẽ ảnh hưởng đến logic phân tích các trường liên quan đến số lượng (quy mô) lệnh trên cả REST API và WebSocket. Quý khách vui lòng đánh giá và điều chỉnh logic chiến lược giao dịch của mình trước theo kế hoạch từng giai đoạn để đảm bảo hoạt động giao dịch không bị gián đoạn.

1.1 Tổng quan Kế hoạch Nâng cấp (Chia thành 3 Giai đoạn)

1. Giai đoạn 1: Nâng cấp Tương thích Loại Trường (Triển khai vào ngày 9 tháng 12 năm 2025)

Đã hoàn tất điều chỉnh cấu trúc dữ liệu nền tảng.
Đã thay đổi kiểu dữ liệu của các trường liên quan đến quy mô hợp đồng từ Integer sang String.
Hệ thống hiện đang ở chế độ tương thích. Bằng cách thêm trường X-Gate-Size-Decimal vào header yêu cầu, quá trình xử lý tương thích cho trường số lượng lô hợp đồng sẽ được thực hiện.

Tham số Header	Mô tả	Ghi chú
X-Gate-Size-Decimal = 1	Loại trường liên quan đến quy mô chuyển từ Integer sang String	1. Hỗ trợ nhận dữ liệu thập phân.
X-Gate-Size-Decimal = 0 Hoặc không sử dụng trường header này Mặc định, trường này không được sử dụng.	Loại trường liên quan đến quy mô vẫn là Integer	1. Không hỗ trợ nhận dữ liệu thập phân. 2. Xử lý độ chính xác - Làm tròn xuống về 0.

Nếu không thiết lập header X-Gate-Size-Decimal, trường quy mô sẽ tiếp tục nhận và trả về kiểu Integer theo mặc định.

2. Giai đoạn 2: Ra mắt Khả năng Đặt Lệnh Phân Số

Khả năng đặt lệnh phân số trên hợp đồng USDT vĩnh cửu dự kiến sẽ ra mắt vào ngày 30 tháng 12 năm 2025. Trong giai đoạn này, chỉ các khả năng hệ thống nền tảng và hỗ trợ API được kích hoạt. Chưa có hợp đồng nào thực tế mở để đặt lệnh phân số tại thời điểm này, và quy tắc đặt lệnh thực tế đối với người dùng vẫn giữ nguyên.
Từ cuối tháng 1 năm 2026, chức năng đặt lệnh phân số sẽ được triển khai dần cho các hợp đồng. Các hợp đồng cụ thể và thời gian triển khai sẽ được nền tảng thông báo trong các thông báo tiếp theo.
Đối với người dùng vẫn sử dụng loại trường cũ mà chưa thích ứng, có thể phát sinh các vấn đề sau:

Phân tích độ chính xác bất thường trong dữ liệu độ sâu hợp đồng.
Độ chính xác lệnh không nhất quán.
Độ chính xác bất thường trong các lệnh đã khớp.

Do đó, tất cả người dùng API cần hoàn tất việc thích ứng loại trường trước cuối tháng 1 năm 2026.

3. Giai đoạn 3: Kích hoạt toàn diện cho tất cả hợp đồng USDT-M và bắt buộc chuyển đổi sang loại trường String

Tất cả cặp giao dịch hợp đồng sẽ hỗ trợ đầy đủ đặt lệnh phân số.
Tại thời điểm quy định, hệ thống sẽ mặc định trả về kiểu String và điều chỉnh giá trị mặc định của header (X-Gate-Size-Decimal), chuyển hành vi phân tích mặc định từ 0 sang 1 nhằm cung cấp một khoảng thời gian chuyển tiếp ngắn cho người dùng chưa hoàn tất thích ứng.
Sau thời gian chuyển tiếp, trường header X-Gate-Size-Decimal sẽ chính thức bị loại bỏ, cấu hình này không còn hiệu lực.
Tất cả các trường liên quan đến số lượng lệnh sẽ thống nhất sử dụng kiểu String nhằm đảm bảo độ chính xác và khả năng tương thích. Loại Integer cũ sẽ không còn được hỗ trợ.
Ngày hiệu lực cụ thể sẽ được thông báo trước qua thông báo chính thức. Vui lòng đảm bảo hoàn tất thích ứng trước thời điểm này.

1.2 Giải thích Chi tiết về Nâng cấp Giai đoạn 1

1.Cả REST và WebSocket API đều đã bổ sung trường header mới, X-Gate-Size-Decimal, để kiểm soát độ chính xác của các trường liên quan đến số lượng.

Tham số Header	Mô tả	Ghi chú
X-Gate-Size-Decimal = 1	Loại trường liên quan đến quy mô chuyển từ Integer sang String	1. Hỗ trợ nhận dữ liệu thập phân.
X-Gate-Size-Decimal = 0 Hoặc không sử dụng trường header này Mặc định, trường này không được sử dụng.	Loại trường liên quan đến quy mô vẫn là Integer	1. Không hỗ trợ nhận dữ liệu thập phân. 2. Xử lý độ chính xác - Làm tròn xuống về 0.

Khuyến nghị: Khách hàng nên nhanh chóng thích ứng với thay đổi loại trường quy mô hợp đồng. Khi hợp đồng chính thức hỗ trợ đặt lệnh phân số, quý khách có thể trải nghiệm và sử dụng chức năng này ngay lập tức.

2.Ví dụ tham khảo thiết lập Header

Rest

# Thiết lập header yêu cầu 
headers = 
{ 
'KEY': API_KEY,
'Timestamp': timestamp,
'SIGN': signature,
# Kích hoạt quy mô thập phân
'X-Gate-Size-Decimal': '1',
'Content-Type': 'application/json',
'Accept': 'application/json'
}

Websocket

# Thiết lập header yêu cầu
# Kích hoạt quy mô thập phân
headers['X-Gate-Size-Decimal'] = '1'

1.3 Biến động Loại Trường Quy mô Futures trong Tương lai

1. Các trường liên quan đến Rest

Loại giao diện	Endpoint	Trường	Ghi chú
Công khai	1. Truy vấn thông tin tất cả hợp đồng Futures GET /futures/settle/contracts 2. Truy vấn thông tin một hợp đồng Futures GET /futures/settle/contracts/contract	Quy mô lệnh tối thiểu được phép của hợp đồng 'order_size_min' Quy mô lệnh tối đa được phép của hợp đồng 'order_size_max' Khối lượng giao dịch tích lũy lịch sử 'trade_size' Quy mô tổng vị thế Long hiện tại 'position_size'	1. Sử dụng trường header X-Gate-Size-Decimal=1 , kiểu của các trường trên sẽ chuyển từ Integer sang String . 2. Khách hàng cần điều chỉnh kiểu nhận dữ liệu cho các trường này.
Công khai	1. Truy vấn thông tin độ sâu thị trường Futures GET /futures/settle/order_book	Quy mô 's'
Công khai	1. Lịch sử giao dịch thị trường Futures GET /futures/settle/trades	Quy mô giao dịch 'size'
Công khai	1. Biểu đồ nến thị trường Futures GET /futures/settle/candlesticks	Quy mô khối lượng (quy mô hợp đồng) 'v'
Công khai	1. Thống kê thị trường Futures GET /futures/settle/contract_stats	Quy mô thanh lý Long (hợp đồng) 'long_liq_size' Quy mô thanh lý Short (hợp đồng) 'short_liq_size' Tổng lãi suất mở (hợp đồng) 'open_interest' Tỷ lệ vị thế Long/Short của nhà giao dịch hàng đầu 'top_lsr_size' Quy mô Long của nhà giao dịch hàng đầu 'top_long_size' Quy mô Short của nhà giao dịch hàng đầu 'top_short_size' Quy mô Long của Taker hàng đầu 'long_taker_size' Quy mô Short của Taker hàng đầu 'short_taker_size'
Công khai	1. Truy vấn lịch sử lệnh thanh lý GET /futures/settle/liq_orders	Quy mô vị thế 'size' Giá lệnh thanh lý 'order_size' Quy mô Maker lệnh thanh lý hệ thống 'left'
Riêng tư	1. Lấy danh sách vị thế người dùng GET /futures/settle/positions 2. Lấy thông tin một vị thế GET /futures/settle/positions/contract 3. Cập nhật ký quỹ vị thế POST /futures/settle/positions/contract/margin 4. Cập nhật đòn bẩy vị thế POST /futures/settle/positions/contract/leverage 5. Chuyển đổi chế độ ký quỹ vị thế POST /futures/settle/positions/cross_mode 6. Chuyển đổi giữa chế độ Cross và Isolated dưới chế độ phòng hộ POST /futures/settle/dual_comp/positions/cross_mode 7. Cập nhật hạn mức rủi ro vị thế POST /futures/settle/positions/contract/risk_limit 8. Thiết lập chế độ vị thế POST /futures/settle/dual_mode 9. Lấy thông tin vị thế trong chế độ phòng hộ GET /futures/settle/dual_comp/positions/contract 10. Cập nhật ký quỹ vị thế trong chế độ phòng hộ POST /futures/settle/dual_comp/positions/contract/margin 11. Cập nhật đòn bẩy vị thế trong chế độ phòng hộ POST /futures/settle/dual_comp/positions/contract/leverage 12. Cập nhật hạn mức rủi ro vị thế trong chế độ phòng hộ POST /futures/settle/dual_comp/positions/contract/risk_limit	Quy mô vị thế 'size'
Riêng tư	1. Đặt lệnh hợp đồng Futures POST /futures/settle/orders 2. Truy vấn danh sách lệnh Futures GET /futures/settle/orders 1. Huỷ tất cả lệnh trạng thái 'open' DELETE /futures/settle/orders 2. Truy vấn danh sách lệnh Futures theo khoảng thời gian GET /futures/settle/orders_timerange 3. Đặt lệnh Futures hàng loạt POST /futures/settle/batch_orders 4. Truy vấn chi tiết một lệnh GET /futures/settle/orders/order_id 5. Huỷ một lệnh DELETE /futures/settle/orders/order_id 6. Sửa một lệnh PUT /futures/settle/orders/order_id 7. Đặt lệnh BBO hợp đồng theo cấp độ POST /futures/settle/bbo_orders	Quy mô giao dịch. 'size' Quy mô hiển thị lệnh tảng băng 'iceberg' Số lượng chưa khớp 'left'
Riêng tư	1. Truy vấn lịch sử giao dịch cá nhân GET /futures/settle/my_trades 2. Truy vấn lịch sử giao dịch cá nhân theo khoảng thời gian GET /futures/settle/my_trades_timerange	Quy mô giao dịch 'size' Quy mô vị thế đã đóng: 'close_size'
Riêng tư	1. Truy vấn lịch sử đóng vị thế GET /futures/settle/position_close	Quy mô giao dịch tối đa 'max_size' Khối lượng vị thế đã đóng tích lũy 'accum_size'
Riêng tư	1. Truy vấn lịch sử thanh lý GET /futures/settle/liquidates	Quy mô vị thế 'size' Quy mô lệnh thanh lý chờ xử lý 'left'
Riêng tư	1. Truy vấn thông tin lệnh tự động ADL GET /futures/settle/auto_deleverages	Quy mô giao dịch 'trade_size' Quy mô vị thế sau ADL 'position_size'
Riêng tư	1. Truy vấn danh sách lệnh tự động GET /futures/settle/price_orders 2. Huỷ tất cả lệnh tự động DELETE /futures/settle/price_orders 3. Truy vấn chi tiết một lệnh tự động GET /futures/settle/price_orders/order_id 4. Huỷ một lệnh tự động DELETE /futures/settle/price_orders/order_id 5. Sửa một lệnh tự động PUT /futures/settle/price_orders/order_id	Trường mới: 'amount' (kiểu string).	1. Trường mới: amount (kiểu string). 2. Trường cũ size (int ) và trường mới amount (string) sẽ tương thích song song.

2. Các trường liên quan đến Websocket

Loại kênh	Kênh	Trường	Ghi chú
Công khai	1. Kênh giao dịch công khai futures.trades	Quy mô khớp 'size'	1. Sử dụng trường header X-Gate-Size-Decimal=1 , kiểu của các trường trên sẽ chuyển từ Integer sang String . 2. Khách hàng cần điều chỉnh kiểu nhận dữ liệu cho các trường này.
Công khai	1. Kênh ticker futures.tickers	Tổng quy mô 'total_size'
Công khai	1. Kênh BBO futures.book_ticker	Quy mô giá mua tốt nhất 'A' Quy mô giá bán tốt nhất 'B'
Công khai	1. Kênh cập nhật độ sâu futures.order_book_update	Quy mô chờ bán 'a.s' Quy mô chờ mua 'b.s'
Công khai	1. Kênh độ sâu đầy đủ futures.order_book	Quy mô chờ bán a.s Quy mô chờ mua b.s
Công khai	1. Kênh độ sâu V2 futures.obu	[giá,quy mô] 'size' Có thể đẩy quy mô thập phân
Công khai	1. Kênh nến futures.candlesticks	Khối lượng 'v'
Công khai	1. Kênh thanh lý công khai futures.public_liquidates	Quy mô lệnh thanh lý 'size'
Công khai	1. Kênh thống kê hợp đồng futures.contract_stats	Quy mô thanh lý Long 'long_liq_size' Quy mô thanh lý Short 'short_liq_size' Tổng lãi suất mở 'open_interest'
Riêng tư	1. Kênh lệnh riêng tư futures.orders	Quy mô hiển thị lệnh tảng băng 'iceberg' Quy mô còn lại có thể giao dịch 'left' Quy mô lệnh 'size'
Riêng tư	1. Kênh giao dịch riêng tư futures.usertrades	Quy mô khớp 'size'
Riêng tư	1. Kênh ADL riêng tư futures.auto_deleverages	Quy mô vị thế 'position_size' Quy mô giao dịch 'trade_size'
Riêng tư	1. Kênh vị thế futures.positions	Quy mô vị thế 'size'
Riêng tư	1. Kênh lệnh kích hoạt giá futures.autoorders	Trường mới: 'amount' (kiểu string).	1. Trường mới: amount (kiểu string). 2. Trường cũ size ( kiểu Integer ) và trường mới amount (String) sẽ tương thích song song.
Riêng tư	1. Kênh lệnh thanh lý futures.liquidates	Quy mô còn lại có thể giao dịch 'left' Quy mô vị thế 'size'	1. Sử dụng trường header X-Gate-Size-Decimal=1 , kiểu của các trường trên sẽ chuyển từ Integer sang String . 2. Khách hàng cần điều chỉnh kiểu nhận dữ liệu cho các trường này.
Riêng tư	1. Đặt lệnh futures.order_place 2. Đặt lệnh hàng loạt futures.order_batch_place 3. Huỷ lệnh futures.order_cancel 4. Huỷ hàng loạt theo ID futures.order_cancel_cp 5. Sửa lệnh futures.order_amend 6. Truy vấn danh sách lệnh futures.order_list 7. Truy vấn chi tiết lệnh futures.order_status	Quy mô lệnh 'size' Quy mô còn lại có thể giao dịch 'left' Quy mô hiển thị lệnh tảng băng 'iceberg'

1.4 Truy vấn thông tin Futures hỗ trợ đặt lệnh thập phân

1.Thiết lập Header X-Gate-Size-Decimal=1
2.Gửi yêu cầu đến endpoint Thông tin Hợp đồng

curl --location 'https://api.gateio.ws/api/v4/futures/usdt/contracts' \ 
--header 'X-Gate-Size-Decimal: 1'

3.Trường trả về order_size_min: Nếu giá trị là số thập phân, điều đó cho thấy hợp đồng Futures tương ứng hỗ trợ đặt lệnh thập phân.

1.5 Thông tin bổ sung

Nhật ký cập nhật API: https://www.gate.com/vi/docs/developers/apiv4/en/#changelog
Nếu có bất kỳ thắc mắc nào, vui lòng liên hệ bộ phận hỗ trợ kỹ thuật API hoặc tham khảo tài liệu API. Xin cảm ơn quý khách đã đồng hành và ủng hộ!

Đội ngũ Gate 18 tháng 12 năm 2025 **Gateway to Crypto** Giao dịch an toàn, nhanh chóng và dễ dàng hơn 4,400 loại tiền điện tử trên Gate **Hành động ngay** Đăng ký và nhận phần thưởng chào mừng lên tới $10.000 Mời bạn bè và nhận hoa hồng 40% **Kết nối cùng Gate** Truy cập website chính thức của Gate Tải Ứng dụng Gate | Desktop Theo dõi chúng tôi trên X (Twitter) để nhận thêm phần thưởng Tham gia cộng đồng Telegram để thảo luận các chủ đề nóng Kết nối cộng đồng toàn cầu để cập nhật thông tin mới nhất **Minh bạch & An toàn** Kiểm tra bằng chứng dự trữ 100% của chúng tôi