Thay đổi về loại trường liên quan đến Quy mô Hợp đồng Futures
Nhằm nâng cao tính linh hoạt của giao dịch futures và hỗ trợ đầy đủ cho các lệnh với số lượng thập phân, Gate sẽ triển khai nâng cấp theo từng giai đoạn cho các 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 lệnh (quy mô) 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 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ị ảnh hưởng.
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 ngày 9 tháng 12 năm 2025)
- Đã hoàn tất điều chỉnh cấu trúc dữ liệu cơ sở.
- Đã thay đổi kiểu dữ liệu của các trường liên quan đến số lượng 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 của yêu cầu, quá trình xử lý tương thích cho trường số lượng 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 header X-Gate-Size-Decimal không được thiết lập, trường size 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 Số lượng Thập phân
-
Hệ thống sẽ ra mắt khả năng đặt lệnh số lượng thập phân cho hợp đồng USDT vĩnh cửu dự kiến 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ở cho đặt lệnh số lượng thập phân vào thời điểm này, và quy tắc đặt lệnh thực tế cho người dùng vẫn giữ nguyên.
-
Bắt đầu từ cuối tháng 1 năm 2026, chức năng đặt lệnh số lượng thập phân sẽ được triển khai dần cho các hợp đồng. Các hợp đồng và thời gian triển khai cụ thể 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 ở các lệnh đã khớp.
Do đó, tất cả người dùng API được nhắc nhở hoàn thành việc thích ứng loại trường càng sớm càng tốt trước cuối tháng 1 năm 2026.
3. Giai đoạn 3: Kích hoạt Toàn bộ cho Tất cả Hợp đồng USDT-M và Bắt buộc Chuyển sang Kiểu Trường String
- Tất cả các cặp giao dịch hợp đồng sẽ hỗ trợ đầy đủ đặt lệnh số lượng thập phân.
- Tại thời điểm được chỉ đị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 để cung cấp một giai đoạn chuyển tiếp ngắn cho những người dùng chưa hoàn tất thích ứng.
- Sau giai đoạn chuyển tiếp, trường header X-Gate-Size-Decimal sẽ chính thức bị loại bỏ và 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 để đảm bảo độ chính xác và tính tương thích. Kiểu 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. Quý khách vui lòng đảm bảo hoàn thành việc 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 số lượng hợp đồng. Khi hợp đồng chính thức hỗ trợ đặt lệnh số lượng thập phân, có thể nhanh chóng trải nghiệm và sử dụng chức năng này.
2.Ví dụ Tham khảo về Thiết lập Header
Rest
# Thiết lập header yêu cầu
headers =
{
'KEY': API_KEY,
'Timestamp': timestamp,
'SIGN': signature,
# Bật hỗ trợ size 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
# Bật hỗ trợ size thập phân
headers['X-Gate-Size-Decimal'] = '1'
1.3 Thay đổi 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
GET /futures/settle/contracts/contract
|
Kích thước lệnh tối thiểu cho phép của hợp đồng 'order_size_min' Kích thước lệnh tối đa cho 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' Tổng vị thế long hiện tại 'position_size' |
1. Khi 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 cho các trường này.
|
| Công khai |
1. Truy vấn độ 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 đồ K-line thị trường futures
GET /futures/settle/candlesticks |
quy mô volume (quy mô hợp đồng)
'v' |
|
| Công khai |
1. Thống kê futures
GET /futures/settle/contract_stats
|
Quy mô thanh lý vị thế Long (hợp đồng) 'long_liq_size' Quy mô thanh lý vị thế Short (hợp đồng) 'short_liq_size' Tổng khối lượng mở (hợp đồng) 'open_interest' Tỷ lệ vị thế Long/Short nhà giao dịch hàng đầu 'top_lsr_size' Quy mô vị thế Long nhà giao dịch hàng đầu
'top_long_size'
Quy mô vị thế Short nhà giao dịch hàng đầu 'top_short_size' Quy mô vị thế Long Taker hàng đầu 'long_taker_size'
Quy mô vị thế Short 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 vị thế đơn
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 futures
POST /futures/settle/orders
2. Truy vấn danh sách lệnh futures
GET /futures/settle/orders
3. Hủy tất cả lệnh trạng thái 'open'
DELETE /futures/settle/orders
4. Truy vấn danh sách lệnh futures theo phạm vi thời gian
GET /futures/settle/orders_timerange
5. Đặt lệnh futures hàng loạt
POST /futures/settle/batch_orders
6. Truy vấn chi tiết lệnh đơn
GET /futures/settle/orders/order_id
7. Hủy lệnh đơn
DELETE /futures/settle/orders/order_id
8. Sửa lệnh đơn
PUT /futures/settle/orders/order_id
9. Đặt lệnh BBO hợp đồng theo cấp
POST /futures/settle/bbo_orders |
Số lượng 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 phạm vi 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' Tổng khối lượng vị thế đã đóng '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ý đang chờ 'left' |
|
| Riêng tư |
1. Truy vấn thông tin lệnh ADL tự động giảm đòn bẩy GET /futures/settle/auto_deleverges
|
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. Hủy tất cả lệnh tự động
DELETE /futures/settle/price_orders
3. Truy vấn chi tiết lệnh tự động đơn
GET /futures/settle/price_orders/order_id
4. Hủy lệnh tự động đơn
DELETE /futures/settle/price_orders/order_id
5. Sửa lệnh tự động đơn
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.
|
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. Khi 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 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 candlestick
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 khối lượng mở 'open_interest' |
|
| Riêng tư |
1. Kênh lệnh riêng tư
futures.orders |
Quy mô hiển thị 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_deleverges |
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. |
| 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. Khi 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 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. Hủy lệnh
futures.order_cancel
4. Hủy 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ị 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 tới 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 biết 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 sự ủng hộ và thấu hiểu của quý khách.
Đội ngũ Gate
18 tháng 12 năm 2025
**Cổng giao dịch tiền điện tử**
Giao dịch an toàn, nhanh chóng và dễ dàng hơn 4,500 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 USD
Mời bạn bè và nhận hoa hồng lên tới 40%
**Kết nối cùng Gate**
Truy cập trang web chính thức của Gate
Tải Ứng dụng Gate | Máy tính để bàn
Theo dõi chúng tôi trên X (Twitter) để nhận thêm nhiều phần thưởng
Tham gia cộng đồng Telegram để thảo luận chủ đề nóng
Kết nối vớ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 100% bằng chứng dự trữ của chúng tôi
