Điều kiện sử dụng
Yêu cầu bắt buộc
- Có tài khoản giao dịch tại SSI
- Đăng ký FastConnect qua Developer Portal và được phê duyệt
- Đồng ý với điều khoản sử dụng dịch vụ
Trách nhiệm của người dùng
- Bảo mật credentials: Không chia sẻ, commit vào source code, hoặc để lộ API Key/Secret và access token
- Tuân thủ rate limits của hệ thống
- Tuân thủ quy định pháp luật về chứng khoán Việt Nam
- Không lạm dụng API (spam, tấn công, khai thác lỗ hổng)
Khi nào tài khoản bị khóa?
- Vi phạm điều khoản sử dụng
- Phát hiện hoạt động bất thường (security alert)
- Yêu cầu từ cơ quan quản lý (UBCKNN)
- Khách hàng yêu cầu khóa
⚠️ Cảnh báo quan trọng: Lệnh giao dịch qua API là lệnh thật, ảnh hưởng trực tiếp đến tài khoản chứng khoán. Kiểm tra kỹ logic trước khi triển khai lên production.
Môi trường
Giờ giao dịch
Cổ phiếu (HOSE/HNX)
Phái sinh
💡 API Market Data và WebSocket hoạt động 24/7. Ngoài giờ giao dịch, dữ liệu giá không cập nhật nhưng vẫn có thể truy vấn dữ liệu lịch sử.
Rate Limits
Hệ thống áp dụng giới hạn request cho từng API Key. Thông tin được trả về trong response headers:
Khi vượt rate limit: API trả về mã lỗi
HTTP 429 Too Many Requests. Cần đợi đến thời điểm X-RATELIMIT-RESET trước khi gọi tiếp.