Runbooks
Danh sách kiểm tra đầy đủ về mức độ sẵn sàng của desk và các bài kiểm tra chứng nhận tích hợp.
Danh Sách Kiểm Tra Mức Độ Sẵn Sàng Của Desk
Trước khi đi vào hoạt động chính thức, hãy xác minh:
Kết Nối API
- Đã kiểm tra các endpoint staging
- Đã cấu hình các endpoint production (khi khả dụng)
- Endpoint kiểm tra sức khỏe (health check) phản hồi bình thường
- Kết nối WebSocket ổn định
Xác Thực
- Ký EIP-712 hoạt động bình thường
- Đã cấu hình ủy quyền agent (nếu áp dụng)
- Đã triển khai quản lý nonce
- Đã kiểm tra xác minh chữ ký
Hệ Thống Báo Giá
- Đã kiểm tra đặt lệnh hàng loạt (bulk order)
- Đã xác minh đối soát vòng đời lệnh
- Đã triển khai theo dõi khớp lệnh (fill)
- Đã kiểm tra chức năng hủy lệnh
Kiểm Soát Rủi Ro
- Đã cấu hình và kiểm tra MMP
- Đã hiểu rõ mô hình ký quỹ
- Đã xác minh các hạn chế theo tier
- Đã triển khai giám sát danh mục đầu tư
Giám Sát
- Đã đăng ký các feed WebSocket
- Đã tự động hóa đối soát lệnh/khớp lệnh
- Đã cấu hình kiểm tra sức khỏe
- Đã thiết lập cảnh báo
Kill Switch
- Có khả năng hủy tất cả các lệnh
- Có khả năng ngắt kết nối ngay lập tức
- Đã lập tài liệu quy trình khẩn cấp
Phòng Hộ (Hedging)
- Đã xác minh tích hợp với perp trên Hyperliquid
- Đã triển khai chiến lược phòng hộ delta
- Đã hiểu rõ cách tính ký quỹ cho perp
Thanh Toán
- Đã kiểm tra xử lý ngày đáo hạn
- Đã xác minh thanh toán vị thế
- Đã hiểu rõ nguồn giá tham chiếu
Các Bài Kiểm Tra Chứng Nhận Tích Hợp
Bài Kiểm Tra 1: Đặt Lệnh
Các bước:
- Đặt một lệnh đơn qua
POST /order - Xác minh trạng thái lệnh:
ACKED→OPEN - Kiểm tra lệnh xuất hiện trong
GET /orders?wallet=... - Xác minh đã nhận được
order_updatestừ WebSocket
Kết quả mong đợi: Lệnh được đặt thành công, nhận được cập nhật trạng thái
Bài Kiểm Tra 2: Đặt Lệnh Hàng Loạt
Các bước:
- Đặt 10 lệnh qua
POST /bulk_order - Xác minh tất cả các lệnh được chấp nhận
- Kiểm tra trạng thái lệnh qua REST và WS
- Xác minh không có lỗi chữ ký/xác thực
Kết quả mong đợi: Tất cả các lệnh được đặt thành công
Bài Kiểm Tra 3: Theo Dõi Khớp Lệnh
Các bước:
- Đặt một lệnh sẽ được khớp
- Theo dõi kênh
fillstrên WebSocket - Xác minh đã nhận được thông tin khớp lệnh với
order_idchính xác - Kiểm tra thông tin khớp lệnh xuất hiện trong
GET /fills?wallet=... - Xác minh trạng thái lệnh được cập nhật thành
FILLED
Kết quả mong đợi: Khớp lệnh được theo dõi chính xác, trạng thái lệnh được cập nhật
Bài Kiểm Tra 4: Theo Dõi Khớp Lệnh Một Phần
Các bước:
- Đặt một lệnh sẽ được khớp một phần
- Theo dõi kênh
fillstrên WebSocket (không phảiorder_updates) - Xác minh đã nhận được thông tin khớp lệnh một phần
- Tổng hợp các khớp lệnh theo
order_idđể tính khối lượng đã khớp - Xác minh trạng thái lệnh vẫn là
OPEN(không phảiPARTIALLY_FILLEDtrên WS)
Kết quả mong đợi: Khớp lệnh một phần được theo dõi qua kênh fills, trạng thái lệnh chính xác
Bài Kiểm Tra 5: Hủy Lệnh
Các bước:
- Đặt lệnh qua
POST /order - Hủy lệnh qua
DELETE /order - Xác minh trạng thái lệnh:
CANCELED - Kiểm tra đã nhận được
order_updatestừ WebSocket
Kết quả mong đợi: Lệnh được hủy thành công, nhận được cập nhật trạng thái
Bài Kiểm Tra 6: Kích Hoạt MMP
Các bước:
- Cấu hình MMP qua
POST /mmp-config - Đặt các lệnh có bật MMP
- Kích hoạt MMP bằng cách vượt quá các giới hạn
- Xác minh các lệnh bị hủy với lý do MMP
- Kiểm tra các lệnh có bật MMP khác cũng bị hủy
Kết quả mong đợi: MMP kích hoạt chính xác, các lệnh bị hủy
Bài Kiểm Tra 7: Từ Chối Do Ký Quỹ
Các bước:
- Đặt lệnh vượt quá mức ký quỹ
- Xác minh lệnh bị từ chối với lý do "Insufficient margin"
- Kiểm tra lý do từ chối bao gồm các giá trị: yêu cầu, khả dụng và mức thiếu hụt
- Xác minh trạng thái lệnh:
REJECTED
Kết quả mong đợi: Lệnh bị từ chối với lý do rõ ràng
Bài Kiểm Tra 8: Hạn Chế Theo Tier
Các bước:
- Sử dụng ví được cấu hình chỉ cho phép vị thế mua (long-only)
- Thử đặt lệnh bán mà không có vị thế mua / long
- Xác minh lệnh bị từ chối với lý do liên quan đến tier
- Đặt lệnh mua (phải thành công)
- Đặt lệnh bán để đóng vị thế (phải thành công)
Kết quả mong đợi: Các hạn chế theo tier được thực thi chính xác
Bài Kiểm Tra 9: Kết Nối Lại WebSocket
Các bước:
- Kết nối với WebSocket
- Đăng ký các kênh
- Ngắt kết nối WebSocket
- Kết nối lại với exponential backoff
- Đăng ký lại các kênh
- Truy vấn REST để cập nhật các thông tin đã bỏ lỡ
Kết quả mong đợi: Kết nối lại hoạt động bình thường, trạng thái được khôi phục
Bài Kiểm Tra 10: Đối Soát Danh Mục Đầu Tư
Các bước:
- Đặt lệnh và khớp lệnh
- Kiểm tra danh mục đầu tư qua
GET /portfolio?wallet=... - Xác minh các vị thế khớp với các fill
- Kiểm tra mức sử dụng ký quỹ chính xác
- Đối soát với các cập nhật
portfoliotừ WebSocket
Kết quả mong đợi: Trạng thái danh mục đầu tư chính xác, đối soát thành công
Mức Độ Sẵn Sàng Production
Danh Sách Kiểm Tra Trước Production
- Tất cả các bài kiểm tra tích hợp đã đạt
- Đã cấu hình giám sát và cảnh báo
- Đã kiểm tra kill switch
- Đã lập tài liệu quy trình khẩn cấp
- Đội ngũ đã được đào tạo về ứng phó sự cố
- Đã xác định các đầu mối hỗ trợ
Danh Sách Kiểm Tra Go-Live
- Môi trường staging đã được kiểm tra đầy đủ
- Đã xác minh các endpoint production
- Các dashboard giám sát đã sẵn sàng
- Đã cấu hình cảnh báo
- Đã thiết lập lịch trực on-call cho đội ngũ
- Đã rà soát tài liệu
Tài Liệu Tham Khảo
- Bắt đầu nhanh: Quickstart
- Tài liệu API: REST API
- Lỗi và từ chối: Errors
- Playbook xử lý sự cố: Incidents