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

# Giới thiệu SSI FastConnect API

> SSI FastConnect API - Document Summary & Technical Reference.

## 1. FastConnect API là gì?

**FastConnect API** là nền tảng kết nối giao dịch chuẩn hóa của Công ty Cổ phần Chứng khoán SSI (SSI). Nền tảng cho phép khách hàng cá nhân, công ty Fintech, Quant / Algo Traders và các nhà phát triển ứng dụng truy cập trực tiếp vào hệ thống giao dịch và dữ liệu thị trường chứng khoán Việt Nam với độ trễ thấp và mức độ bảo mật cao.

***

## 2. Các Nhóm Tính Năng Chính

FastConnect API được chia thành **4 nhóm tính năng chính**:

### 2.1. Authentication (Xác thực & Cấp quyền)

* **Cơ chế:** Sử dụng cặp `API Key` + `API Secret` để lấy Bearer Token (chuẩn JWT).
* **Phân quyền Token:**
  * **Token Market Data:** Gọi endpoint `/api/v3/auth/token` với `apiKey` và `apiSecret` để truy cập dữ liệu thị trường.
  * **Token Trading:** Yêu cầu gọi thêm `/api/v3/auth/requestOtp` (SMS/Email) và gửi kèm mã `otp` để cấp quyền đặt/sửa/hủy lệnh.
* **Duy trì phiên:** Sử dụng endpoint `/api/v3/auth/refresh` để làm mới token khi hết hạn.

### 2.2. Market Data (Dữ liệu thị trường)

Cung cấp truy xuất dữ liệu thị trường thông qua REST API (định dạng JSON hoặc CSV):

* **Danh sách chứng khoán:** Tra cứu mã cổ phiếu/chứng khoán theo các sàn (HOSE, HNX, UPCOM) hoặc chỉ số.
* **Dữ liệu giao dịch:** Thông tin tổng hợp theo ngày (giá khớp, khối lượng, giá trị).
* **Dữ liệu nến OHLCV:** Truy xuất dữ liệu lịch sử và nến theo các khung thời gian (`1m`, `5m`, `15m`, `30m`, `1h`, `1d`).
* **Chỉ số thị trường:** Danh sách và thông số biến động chỉ số (VNINDEX, VN30, HNXIndex...).
* **Tải file dữ liệu:** Tải file CSV dữ liệu thô phục vụ phân tích / backtest.

### 2.3. Trading (Giao dịch & Quản lý tài khoản)

Hỗ trợ đầy đủ các thao tác đặt lệnh và quản lý tài khoản đầu tư:

* **Đặt lệnh:** Đặt lệnh Mua/Bán với các loại lệnh phổ biến (`LO`, `MP`, `ATO`, `ATC`).
* **Quản lý lệnh:** Sửa giá/khối lượng hoặc hủy các lệnh đang chờ khớp.
* **Sổ lệnh:** Tra cứu lịch sử lệnh chi tiết theo tài khoản, trạng thái lệnh và thời gian.
* **Danh mục vị thế:** Kiểm tra cổ phiếu và vị thế phái sinh đang nắm giữ.
* **Số dư & Ký quỹ:** Kiểm tra số dư tiền mặt, sức mua, dư nợ ký quỹ, tiền chờ thanh toán (\$T+0 / T+1 / T+2\$), tỷ lệ \$PP/MMR\$ và khối lượng đặt lệnh tối đa.

### 2.4. WebSocket Streaming (Dữ liệu thời gian thực)

Hỗ trợ stream dữ liệu thời gian thực qua giao thức WebSocket tại `wss://stream.ssi.com.vn`:

* **Market Data Channels:**
  * `F:STOCK`: Dữ liệu khớp lệnh / sổ lệnh cổ phiếu.
  * `F:INDEX`: Cập nhật biến động chỉ số thị trường.
  * `F:DERIVATIVE`: Dữ liệu thị trường phái sinh.
* **Trading Channels:**
  * `T:ORDER`: Cập nhật trạng thái lệnh (chờ, khớp, hủy).
  * `T:ACCOUNT`: Cập nhật biến động số dư / tài khoản.
  * `T:POSITION`: Cập nhật vị thế danh mục realtime.
* **Cơ chế Duy trì kết nối (Heartbeat):** Server gửi tin nhắn `ping` mỗi 30 giây; Client phải phản hồi `pong` để duy trì kết nối WebSocket.

***

## 3. Thông Số Kỹ Thuật Tổng Quan

| Tiêu chí | Chi tiết |
| :- | :- |
| **Giao thức hỗ trợ** | REST API (JSON), WebSocket Streaming (`wss://stream.ssi.com.vn`) |
| **Xác thực** | API Key + API Secret \$ |
| ightarrow\$ JWT Bearer Token (giao dịch cần OTP) | |
| **Định dạng dữ liệu** | JSON, CSV |
| **Ngôn ngữ / SDKs** | Node.js, Python, Java, C#, Go |
| **Kiểm soát Tần suất (Rate Limits)** | Theo dõi qua Response Headers: `X-RATELIMIT-LIMIT`, `X-RATELIMIT-REMAINING`, `X-RATELIMIT-RESET` |

***

## 4. Đối Tượng Sử Dụng Chính

1. **Trader Cá nhân:** Tự động hóa chiến lược giao dịch và quản lý danh mục.
2. **Công ty Fintech:** Tích hợp tính năng giao dịch, robo-advisor vào ứng dụng số.
3. **Quant & Algo Traders:** Lấy dữ liệu lịch sử/realtime để backtest và chạy bot tự động.
4. **Developers:** Xây dựng ứng dụng tài chính / bảng giá chứng khoán riêng.


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