Điều kiện sử dụng & Môi trường

Điều kiện sử dụng, môi trường triển khai, giờ giao dịch và giới hạn

Điều kiện sử dụng

Bảo mật API Key, API Secret và access token. Không chia sẻ, commit vào source code, hoặc để lộ credentials
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)

Tài khoản API có thể bị tạm khóa trong các trường hợp:

Liên hệ bộ phận hỗ trợ để khôi phục tài khoản.

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 chính cho dữ liệu thực và giao dịch thật.

Môi trường kiểm thử dành cho việc phát triển và tích hợp. Dữ liệu giả lập, giao dịch không ảnh hưởng tài khoản thật.

Thông tin kết nối môi trường UAT được cung cấp sau khi đăng ký. API Key của UAT và Production là riêng biệt.

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

Hệ thống áp dụng rate limit cho từng API Key. Thông tin rate limit được trả về trong response headers:

Header	Mô tả
`X-RATELIMIT-LIMIT`	Số request tối đa trong chu kỳ
`X-RATELIMIT-REMAINING`	Số request còn lại trong chu kỳ hiện tại
`X-RATELIMIT-RESET`	Thời điểm reset giới hạn

Khi vượt rate limit, API trả về HTTP 429 Too Many Requests. Đợi đến thời điểm X-RATELIMIT-RESET trước khi gọi tiếp.

Loại dữ liệu	Phạm vi
OHLCV daily	Từ ngày mã chứng khoán bắt đầu giao dịch
OHLCV intraday (1m, 5m, 15m, 30m, 1h)	1 năm gần nhất
Tải file CSV	Đường dẫn có hiệu lực trong 30 phút

Tiếp tục với Cách lấy API Key để tạo credentials đầu tiên.