Giới Hạn Tần Suất (Rate Limits)

API áp dụng giới hạn tần suất theo từng APIKey và từng Endpoint. Giới hạn tần suất được định nghĩa bởi:

Tên API	Endpoint	Rate / giờ	Quota / ngày
Xác thực	POST /auth/token	60	500
Xác thực	POST /auth/refresh	120	1,000
Đặt lệnh	POST /orders	3,600	50,000
Sửa lệnh	PUT /orders/	3,600	50,000
Hủy lệnh	DELETE /orders/	3,600	50,000
Trạng thái lệnh	GET /orders/	7,200	100,000
Danh sách lệnh	GET /orders	1,800	20,000
Thông tin tài khoản	GET /accounts/	1,800	20,000
Số dư tài khoản	GET /accounts//balance	3,600	40,000
Thông tin danh mục	GET /portfolio/	1,800	20,000
Vị thế nắm giữ	GET /portfolio//positions	1,800	20,000
Giá cổ phiếu gần nhất	GET /marketdata/quote/	18,000	200,000
Sổ lệnh giao dịch	GET /marketdata/orderbook/	10,000	100,000
Lịch sử giá	GET /marketdata/history/	3,600	30,000
Danh sách chứng khoán	GET /instruments	3,600	20,000
Danh sách ký hiệu	GET /symbols	3,600	20,000
WebSocket - Dữ liệu thị trường	WS /ws/marketdata	60 kết nối	500 kết nối
WebSocket - Thông báo lệnh	WS /ws/orders	60 kết nối	500 kết nối

Khi vượt quá giới hạn, hệ thống sẽ trả về HTTP 429 (Too Many Requests)

429
Too Many Requests
{
    "error": "Rate Limit Exceeded",
    "message": "Too many request"
}

Phân bổ các cuộc gọi API một cách đều đặn trong các khoảng thời gian để tránh vượt quá giới hạn tần suất
Lưu trữ dữ liệu ít thay đổi trong cache phía client để giảm các request không cần thiết
Ưu tiên sử dụng các API hỗ trợ xử lý dữ liệu hàng loạt trong một lần gọi khi có sẵn
Sử dụng kết nối WebSocket cho dữ liệu real-time để giảm số lượng HTTP request
Triển khai chiến lược exponential backoff khi nhận được response 429
Cân nhắc hợp nhất các request trong những thời gian cao điểm
Thiết lập giám sát và cảnh báo cho các vi phạm giới hạn tần suất

Rate limit