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

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

2025-12-18 11:53:58 UTC 25098 Số lượt đọc

[//]:content-type-MARKDOWN-DONOT-DELETE
**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.

* 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**

1. 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.

2. 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.

3. Đố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**

1. 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.
2. 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.
3. 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.
4. 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ợ.
5. 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.

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**

### 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.

<sp>
Đội ngũ Gate
18 tháng 12 năm 2025
<sp>
**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 %Amount_of_Currency% loại tiền điện tử trên Gate
**Hành động ngay**
<a href="https://www.gate.com/vi/signup" target="_blank">Đăng ký</a> và nhận phần thưởng chào mừng lên tới 10.000 USD
<a href="https://www.gate.com/vi/referral" target="_blank">Mời bạn bè</a> và nhận hoa hồng lên tới 40%
**Kết nối cùng Gate**
<a href="https://www.gate.com/vi/" target="_blank">Truy cập trang web chính thức của Gate</a>
<a href="https://www.gate.com/vi/mobileapp?ch=ann48788" target="_blank">Tải Ứng dụng Gate | Máy tính để bàn</a>
<a href="https://x.com/Gate" rel="nofollow noopener noreferrer" target="_blank">Theo dõi chúng tôi trên X (Twitter)</a> để nhận thêm nhiều phần thưởng
<a href="https://t.me/GateCom_EN" rel="nofollow noopener noreferrer" target="_blank">Tham gia cộng đồng Telegram</a> để thảo luận chủ đề nóng
<a href="https://www.gate.com/vi/community" target="_blank">Kết nối với cộng đồng toàn cầu</a> để cập nhật thông tin mới nhất
**Minh bạch & An toàn**
<a href="https://www.gate.com/vi/proof-of-reserves" target="_blank">Kiểm tra 100% bằng chứng dự trữ của chúng tôi</a>

Lưu ý: Đây là bản dịch bằng máy hoặc do con người dịch từ văn bản gốc tiếng Anh nên có thể có sai sót trong bản dịch. Nhấn vào đây để xem bản gốc tiếng Anh.

Thay đổi & Thời gian bắt đầu-kết thúc Biểu đồ

Màu sắc tăng giảm

Pay With

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

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

Chọn ngôn ngữ và khu vực

Chọn khu vực của bạn

Tiền pháp định