Xác thực thời gian Futures API của Gate là một tính năng xác minh thời gian mà Gate bổ sung ở phía công cụ khớp lệnh (ME) của các API giao dịch hợp đồng. Hai tiêu đề HTTP phối hợp để xác nhận rằng một yêu cầu đã được gửi trong một khoảng thời gian xác định. Máy khách đặt X-Gate-Client-Send-Us thành dấu thời gian gửi tính bằng micro giây và X-Gate-Timeout-Window-Us thành khoảng thời gian hợp lệ tối đa, cũng tính bằng micro giây. Bản cập nhật này chỉ áp dụng cho kiến trúc giao dịch Gate 3.0.
Cơ chế này giải quyết một rủi ro cụ thể trong giao dịch thuật toán: một yêu cầu nằm trong hàng đợi mạng, một lần thử lại chậm từ máy khách hoặc sự sai lệch đồng hồ có thể đến công cụ khớp lệnh rất lâu sau thời điểm nhà giao dịch dự định. Trong các thị trường giao dịch hợp đồng biến động nhanh, một lệnh bị chậm ở mức giá không phù hợp có thể tạo ra rủi ro trượt giá và khớp lệnh không mong muốn. Tính năng xác thực thời gian cho phép máy khách khai báo rằng "coi yêu cầu này là không hợp lệ sau N micro giây", đưa quyền kiểm soát thời điểm hết hạn lên lớp ME thay vì chỉ dựa vào thời gian mạng.
Các API giao dịch hợp đồng của Gate hiện hỗ trợ hai tiêu đề yêu cầu để xác thực thời gian ở phía công cụ khớp lệnh (ME): X-Gate-Client-Send-Us và X-Gate-Timeout-Window-Us, cả hai đều tính bằng micro giây.
X-Gate-Client-Send-Us chứa dấu thời gian gửi của máy khách, tính bằng micro giây kể từ mốc Unix. Máy chủ so sánh giá trị này với đồng hồ của chính máy chủ tại thời điểm nhận yêu cầu.
X-Gate-Timeout-Window-Us xác định khoảng thời gian hợp lệ tối đa cho yêu cầu, tính bằng micro giây. Nếu thời gian trôi qua giữa dấu thời gian gửi và thời điểm máy chủ nhận yêu cầu vượt quá khoảng này, yêu cầu sẽ bị từ chối.
Các điểm cuối REST được triển khai vào ngày 16 tháng 11 năm 2026. Hỗ trợ API WebSocket sẽ được triển khai vào ngày 19 tháng 11 năm 2026.
Cơ chế này chỉ áp dụng cho kiến trúc giao dịch Gate 3.0 đối với các giao diện giao dịch hợp đồng (hợp đồng tương lai); các kiến trúc khác hiện chưa hỗ trợ tính năng này. Các bước tích hợp gồm: đồng bộ hóa đồng hồ, tính dấu thời gian gửi theo micro giây, đặt cả hai tiêu đề, đồng thời kiểm tra và cập nhật logic tích hợp API theo tên trường mới nhất.
Xác thực thời gian Futures API của Gate là một cặp tiêu đề HTTP cho phép máy khách khai báo khoảng thời gian mà một yêu cầu vẫn còn hiệu lực. Cơ chế này hoạt động ở cấp độ truyền tải trước khi công cụ khớp lệnh xử lý yêu cầu. Máy chủ đọc cả hai tiêu đề trên mỗi lệnh gọi API hợp đồng đến, tính chênh lệch giữa thời điểm nhận của máy chủ và dấu thời gian gửi do máy khách khai báo, rồi so sánh kết quả với khoảng thời gian chờ đã khai báo.
X-Gate-Client-Send-Us chứa dấu thời gian, tính bằng micro giây kể từ mốc Unix, tại thời điểm máy khách gửi yêu cầu. Giá trị 1794794400123456 tương ứng với một thời điểm cụ thể ở cấp độ micro giây. Đơn vị là micro giây, không phải mili giây hoặc giây, đây là một lỗi tích hợp phổ biến dẫn đến lỗi "dấu thời gian quá cũ" hoặc "dấu thời gian vượt quá thời điểm hiện tại".
Tiêu đề này cho máy chủ biết thời điểm yêu cầu rời khỏi máy khách. Sau đó, máy chủ tính thời gian đã trôi qua bằng cách lấy dấu thời gian nhận của máy chủ trừ đi giá trị này. Nếu đồng hồ của máy khách không được đồng bộ đáng kể với máy chủ, thời gian đã trôi qua được tính toán sẽ không chính xác, ngay cả khi độ trễ mạng vẫn bình thường.
X-Gate-Timeout-Window-Us xác định khoảng thời gian hợp lệ tối đa cho yêu cầu, tính bằng micro giây. Máy chủ từ chối mọi yêu cầu có thời gian đã trôi qua vượt quá khoảng này. Giá trị 5000000 tương ứng với năm giây. Giá trị 500000 tương ứng với nửa giây, là khoảng thời gian chặt chẽ hơn, phù hợp với việc đặt lệnh nhạy cảm với độ trễ.
Tiêu đề này cho phép máy khách kiểm soát rõ ràng mức độ cũ của một yêu cầu vẫn được chấp nhận. Khoảng thời gian chặt chẽ giúp giảm rủi ro thực hiện lệnh trong điều kiện thị trường đã lỗi thời. Khoảng thời gian rộng hơn chấp nhận sự biến động của mạng và sai lệch đồng hồ, nhưng cũng cho phép giá thị trường có thêm thời gian để biến động giữa ý định của máy khách và thời điểm máy chủ thực hiện.
Trong thị trường hợp đồng và hợp đồng tương lai, giá có thể biến động trong vài mili giây. Một lệnh được dự định thực hiện tại mức giá hiện tại có thể đến muộn vài giây, khi thị trường đã thay đổi. Nếu không có xác thực thời gian, API không thể biết liệu máy khách có chủ định trì hoãn hay yêu cầu đã bị phát lại, sao chép hoặc bị kẹt trong hàng đợi.
Xác thực thời gian xử lý ba tình huống cụ thể:
Độ trễ mạng tăng đột biến. Một yêu cầu mất nhiều thời gian hơn dự kiến để đến máy chủ có thể bị từ chối trước khi công cụ khớp lệnh xử lý, ngăn chặn việc khớp lệnh ở mức giá mà nhà giao dịch không còn chấp nhận.
Sai lệch đồng hồ của máy khách. Nếu đồng hồ hệ thống của máy khách nhanh hơn hoặc chậm hơn máy chủ, thời gian đã trôi qua được tính toán sẽ bị sai lệch. Máy khách có thể phát hiện điều này từ phản hồi lỗi và điều chỉnh việc đồng bộ hóa đồng hồ.
Yêu cầu bị phát lại hoặc sao chép. Một yêu cầu bị chặn và phát lại sau khi khoảng thời gian hiệu lực đã hết sẽ bị từ chối vì máy chủ nhận thấy thời gian đã trôi qua vượt quá khoảng đã khai báo. Điều này bổ sung một lớp bảo vệ trước một số kiểu tấn công phát lại, ngoài xác thực dựa trên chữ ký.
Thông báo chính thức nêu rõ rằng bản cập nhật này tăng cường khả năng xác minh thời gian ở phía công cụ khớp lệnh (ME) đối với các yêu cầu giao dịch hợp đồng. Người dùng kiến trúc giao dịch Gate 3.0 nên xem xét và cập nhật logic tích hợp API theo tên trường mới nhất để đảm bảo tính năng xác thực thời gian hoạt động chính xác.
Trước khi đặt tiêu đề dấu thời gian, hãy đảm bảo đồng hồ của máy khách được đồng bộ hóa với nguồn thời gian đáng tin cậy. Sử dụng NTP hoặc truy vấn điểm cuối thời gian máy chủ của Gate và ghi lại độ lệch giữa đồng hồ cục bộ và máy chủ. Việc đồng bộ hóa lại định kỳ giúp duy trì sai lệch trong giới hạn chấp nhận được. Hầu hết cấu hình NTP tiêu chuẩn duy trì sai lệch dưới vài mili giây, nằm trong khoảng thời gian chờ thông thường từ 1 – 5 giây.
Khi chuẩn bị từng yêu cầu, hãy ghi nhận thời gian hiện tại theo micro giây kể từ mốc Unix. Hầu hết ngôn ngữ lập trình đều hỗ trợ trực tiếp việc này:
import time
send_us = int(time.time() * 1_000_000)
const sendUs = Date.now() * 1000;
Ghi giá trị này vào tiêu đề X-Gate-Client-Send-Us.
Chọn một khoảng thời gian phù hợp với mức độ chấp nhận độ trễ của chiến lược. Đối với các chiến lược tạo lập thị trường hoặc giao dịch lướt sóng cần kiểm soát chặt chẽ, 500000 micro giây (0,5 giây) là hợp lý. Đối với các chiến lược chậm hơn như giao dịch lưới hoặc tái cân bằng danh mục đầu tư, 5000000 micro giây (5 giây) mang lại khả năng chấp nhận độ trễ cao hơn.
Ghi giá trị này vào tiêu đề X-Gate-Timeout-Window-Us.
Khi máy chủ từ chối một yêu cầu vì thời gian đã trôi qua vượt quá khoảng thời gian chờ, API sẽ trả về phản hồi lỗi. Máy khách của bạn nên:
Không sử dụng lại các tiêu đề ban đầu cho một lần thử lại. Mỗi yêu cầu mới phải chứa dấu thời gian và khoảng thời gian chờ mới.
Theo thời gian, đồng hồ của máy khách có thể sai lệch so với máy chủ. Hãy lên lịch đồng bộ NTP định kỳ hoặc truy vấn điểm cuối thời gian máy chủ của Gate và điều chỉnh độ lệch của bạn. Bạn cũng có thể thêm một bước kiểm tra tình trạng đơn giản vào bảng điều khiển hoặc bảng thông tin giám sát để báo cáo độ lệch giữa thời gian cục bộ và thời gian máy chủ trong mỗi lần triển khai. Theo dõi tỷ lệ lỗi xác thực thời gian như một chỉ báo về tình trạng vận hành, vì tỷ lệ lỗi tăng thường cho thấy sai lệch đồng hồ thay vì sự cố mạng.
Các điểm cuối REST được triển khai trước vào ngày 16 tháng 11 năm 2026. Hỗ trợ WebSocket sẽ được triển khai vào ngày 19 tháng 11 năm 2026. Cả hai chỉ áp dụng cho kiến trúc giao dịch Gate 3.0; các kiến trúc khác hiện chưa hỗ trợ tính năng này.
Mỗi yêu cầu HTTP chứa độc lập cả hai tiêu đề. Máy khách tính dấu thời gian gửi vào thời điểm chuẩn bị yêu cầu. Không có trạng thái kết nối cần duy trì, mỗi yêu cầu là độc lập.
Đối với WebSocket, kết nối được duy trì liên tục. Máy khách gửi một thông điệp qua kết nối đã được thiết lập. Dấu thời gian gửi phải phản ánh thời điểm thông điệp được ghi vào socket, không phải thời điểm kết nối được thiết lập.
| Khía cạnh | API REST | API WebSocket |
|---|---|---|
| Ngày phát hành | ngày 16 tháng 11 năm 2026 | ngày 19 tháng 11 năm 2026 |
| Mô hình kết nối | Không trạng thái (mỗi yêu cầu) | Duy trì liên tục (mỗi kết nối) |
| Thời điểm ghi dấu thời gian | Khi chuẩn bị yêu cầu | Khi ghi thông điệp vào socket |
| Phạm vi | Chỉ giao dịch hợp đồng Gate 3.0 | Chỉ giao dịch hợp đồng Gate 3.0 |
| Lưu ý tích hợp | Đặt cả hai tiêu đề trên mọi yêu cầu | Tính dấu thời gian cho từng thông điệp, không phải từng kết nối |
Việc đặt lệnh và quản lý đăng ký qua WebSocket hưởng lợi từ cùng khả năng xác minh thời gian: một yêu cầu đăng ký đã cũ hoặc một thông điệp lệnh bị chậm sẽ chịu cùng cơ chế xác thực thời gian ở phía ME.
Lỗi tích hợp thường gặp nhất là gửi dấu thời gian theo mili giây hoặc giây thay vì micro giây. Dấu thời gian theo mili giây nhỏ hơn dấu thời gian theo micro giây ba bậc độ lớn. Máy chủ sẽ nhận thấy thời gian đã trôi qua thực tế là âm hoặc rất xa trong quá khứ. Luôn nhân với 1.000.000 khi bắt đầu từ giây hoặc nhân với 1.000 khi bắt đầu từ mili giây.
Nếu đồng hồ của máy khách nhanh hơn hoặc chậm hơn máy chủ quá khoảng thời gian chờ, mọi yêu cầu sẽ bị từ chối. Cách khắc phục là đồng bộ hóa đồng hồ. Nếu bạn không thể chạy NTP, hãy tính độ lệch từ điểm cuối thời gian máy chủ của Gate và áp dụng độ lệch đó trước khi tạo dấu thời gian gửi.
Khoảng thời gian 100000 micro giây (0,1 giây) có thể quá chặt đối với đường truyền mạng liên vùng hoặc máy khách có độ trễ biến động. Nếu bạn thường xuyên gặp lỗi từ chối với khoảng thời gian chặt, hãy tăng dần khoảng này cho đến khi tỷ lệ từ chối giảm xuống mức chấp nhận được. Hãy bắt đầu với 1000000 micro giây (1 giây) cho hầu hết chiến lược.
Một khoảng thời gian quá dài, ví dụ 60000000 micro giây hoặc 60 giây, cung cấp rất ít khả năng bảo vệ trước các lệnh thực hiện đã cũ. Trong một thị trường hợp đồng biến động nhanh, một yêu cầu đã cũ 60 giây gần như chắc chắn sẽ được thực hiện ở mức giá rất khác so với thị trường hiện tại. Hãy điều chỉnh khoảng thời gian theo mức độ chấp nhận độ trễ thực tế của chiến lược.
Nếu bạn bỏ qua một trong hai tiêu đề, API có thể xem yêu cầu là không có xác thực thời gian. Hành vi phụ thuộc vào điểm cuối và cấu hình của điểm cuối đó, hãy tham khảo tài liệu API chính thức cho điểm cuối cụ thể mà bạn đang gọi. Theo thông lệ chung, hãy luôn đặt đồng thời cả hai tiêu đề.
Xác thực thời gian Futures API của Gate bổ sung khả năng xác minh thời gian ở phía công cụ khớp lệnh (ME) của các API giao dịch hợp đồng. Máy khách gửi X-Gate-Client-Send-Us, là dấu thời gian theo micro giây của thời điểm yêu cầu được chuẩn bị, và X-Gate-Timeout-Window-Us, là khoảng thời gian hợp lệ tối đa tính bằng micro giây. Bản cập nhật này chỉ áp dụng cho kiến trúc giao dịch Gate 3.0, giúp bảo vệ trước việc thực hiện lệnh bị chậm do mạng, sai lệch đồng hồ và các yêu cầu bị phát lại.
Việc tích hợp yêu cầu bốn bước: đồng bộ hóa đồng hồ, tính dấu thời gian gửi theo micro giây, đặt cả hai tiêu đề trên mỗi yêu cầu và triển khai logic thử lại có tính lại dấu thời gian. Hỗ trợ REST được triển khai vào ngày 16 tháng 11 năm 2026 và WebSocket sẽ được triển khai vào ngày 19 tháng 11 năm 2026, áp dụng cho các giao diện giao dịch hợp đồng Gate 3.0.
Xác thực thời gian Futures API của Gate là một tính năng xác minh thời gian mà Gate bổ sung ở phía công cụ khớp lệnh (ME) của các API giao dịch hợp đồng. Hai tiêu đề yêu cầu, X-Gate-Client-Send-Us và X-Gate-Timeout-Window-Us, phối hợp để xác nhận rằng một yêu cầu đã được gửi trong một khoảng thời gian xác định. Bản cập nhật này chỉ áp dụng cho kiến trúc giao dịch Gate 3.0.
Giá trên thị trường hợp đồng có thể thay đổi trong vài mili giây. Một lệnh bị chậm có thể đến công cụ khớp lệnh rất lâu sau thời điểm nhà giao dịch dự định, dẫn đến các lệnh khớp không mong muốn. Tính năng xác thực thời gian cho phép máy khách khai báo rằng "coi yêu cầu này là không hợp lệ sau N micro giây", giúp bảo vệ trước tình trạng chậm mạng, sai lệch đồng hồ và các yêu cầu bị phát lại.
Hai tiêu đề được thiết kế để sử dụng cùng nhau. X-Gate-Client-Send-Us cung cấp dấu thời gian gửi và X-Gate-Timeout-Window-Us cung cấp khoảng thời gian hiệu lực. Nếu bỏ qua một trong hai tiêu đề, máy chủ không thể thực hiện so sánh thời gian. Hãy tham khảo tài liệu API chính thức để biết yêu cầu cụ thể của từng điểm cuối.
Hành vi mặc định khi bỏ qua X-Gate-Timeout-Window-Us phụ thuộc vào cấu hình của điểm cuối. Tài liệu API chính thức của Gate quy định giá trị mặc định. Máy khách cần kiểm soát rõ ràng nên luôn đặt tiêu đề này thay vì dựa vào giá trị mặc định.
Cả hai tiêu đề đều sử dụng micro giây kể từ mốc Unix. Một giây bằng 1000000 micro giây. Một mili giây bằng 1000 micro giây.
API trả về lỗi cho biết yêu cầu không vượt qua xác thực thời gian ở phía công cụ khớp lệnh. Mã lỗi và định dạng thông báo chính xác được ghi trong tài liệu tham chiếu lỗi API chính thức của Gate. Máy khách nên xử lý lỗi này bằng cách tính lại dấu thời gian và thử lại.
Các máy khách hiện có không gửi tiêu đề mới vẫn tiếp tục hoạt động theo hành vi trước đây. Thông báo chính thức của Gate yêu cầu người dùng API Gate 3.0 kiểm tra và cập nhật logic tích hợp theo tên trường mới nhất để đảm bảo tính năng xác thực thời gian hoạt động chính xác.
Cơ chế này chỉ áp dụng cho các API giao dịch hợp đồng (hợp đồng tương lai) thuộc kiến trúc giao dịch Gate 3.0. Thông báo chính thức nêu rõ rằng các kiến trúc khác hiện chưa hỗ trợ tính năng này. Giao dịch giao ngay, ví và các nhóm API khác tuân theo những quy định riêng.
Tuyên bố miễn trừ trách nhiệm: Nội dung trên chỉ nhằm mục đích cung cấp thông tin và giáo dục, không cấu thành lời khuyên tài chính, đầu tư hoặc giao dịch. Giao dịch hợp đồng tương lai và phái sinh tiềm ẩn rủi ro thua lỗ đáng kể. Hãy tham khảo tài liệu API chính thức của Gate để biết thông số kỹ thuật điểm cuối, mã lỗi và yêu cầu trường mới nhất.
* Đầu tư có rủi ro, phải thận trọng khi tham gia thị trường. Thông tin không nhằm mục đích và không cấu thành lời khuyên tài chính hay bất kỳ đề xuất nào khác thuộc bất kỳ hình thức nào được cung cấp hoặc xác nhận bởi Gate.
* Không được phép sao chép, truyền tải hoặc đạo nhái bài viết này mà không có sự cho phép của Gate. Vi phạm là hành vi vi phạm Luật Bản quyền và có thể phải chịu sự xử lý theo pháp luật.





