> ## Documentation Index
> Fetch the complete documentation index at: https://hoalulab.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Đ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

### 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

| Môi trường | REST API | WebSocket | Developer Portal |
| - | - | - | - |
| **Production** (Dữ liệu thật) | `https://api.ssi.com.vn` | `wss://stream.ssi.com.vn` | `https://developers.ssi.com.vn` |
| **UAT** (Kiểm thử) | Thông báo sau khi sẵn sàng | Thông báo sau khi sẵn sàng | Thông báo sau khi sẵn sàng |

## Giờ giao dịch

### Cổ phiếu (HOSE/HNX)

| Phiên | Giờ | Loại lệnh |
| - | - | - |
| **ATO** | 09:00 - 09:15 | ATO, LO |
| **Liên tục sáng** | 09:15 - 11:30 | LO, MP |
| **Nghỉ trưa** | 11:30 - 13:00 | Không giao dịch |
| **Liên tục chiều** | 13:00 - 14:30 | LO, MP |
| **ATC** | 14:30 - 14:45 | ATC, LO |

### Phái sinh

| Phiên | Giờ |
| - | - |
| **ATO** | 08:45 - 09:00 |
| **Liên tục sáng** | 09:00 - 11:30 |
| **Nghỉ trưa** | 11:30 - 13:00 |
| **Liên tục chiều** | 13:00 - 14:30 |
| **ATC** | 14:30 - 14:45 |

> 💡 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**:

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

## Giới hạn dữ liệu

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

## Bước tiếp theo

Sau khi nắm rõ các điều kiện và môi trường, bạn có thể chuyển sang [hướng dẫn tạo API Key](https://developers.ssi.com.vn/docs/getting-started/api-keys) để bắt đầu tích hợp.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.