> For the complete documentation index, see [llms.txt](https://guide.ssi.com.vn/ssi-products/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.ssi.com.vn/ssi-products/tieng-viet/fastconnect-trading/su-dung-client-mau.md).

# Sử dụng Client mẫu

## Python Client

### Cài đặt Client

#### Đường dẫn tải Client:

[https://github.com/SSI-Securities-Corporation/python-fctrading](https://github.com/SSI-Securities-Corporation/python-fctrading/releases/latest/download/fc-trading.py.zip)

#### Yêu cầu về Python

Yêu cầu cài đặt Python 3.x trở lên (có thể tải bản python.org/downloads/release/python-370/)

{% hint style="info" %}
**Lưu ý**: Nhớ tick Add system path khi cài đặt Python
{% endhint %}

#### Cài đặt Client

**Bước 1:** Giải nén file Client đã tải

**Bước 2:** Gõ cmd vào ô địa chỉ thư mục để khởi tạo command line

<figure><img src="/files/9phK4ywEUzEQZYEZA12j" alt=""><figcaption></figcaption></figure>

Màn hình hiển thị cửa sổ như sau:

<figure><img src="/files/SINx0N27fLk1FexroWJR" alt=""><figcaption></figcaption></figure>

**Bước 3:** Điền thông tin trong file fc\_config.py tại thư mục examples

![](/files/yRdvda9RbbDEFr09mZXY)

{% hint style="info" %}
**Lưu ý**: TwoFAType = 0: PIN và 1: OTP (SMS/ Email/ SmartOTP)
{% endhint %}

**Bước 4:** Chạy câu lệnh

```
pip install ssi-fctrading
```

{% hint style="info" %}
**Lưu ý**: Đối với khách hàng dùng mạng có proxy thì thực hiện các bước cấu hình proxy trước khi chạy câu lệnh cài đặt. Xem chi tiết [tại đây](broken://pages/1oRUqxT4JWWYDDgcecVY).&#x20;
{% endhint %}

<figure><img src="/files/6KUmKVVke00g5Omqmf3d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Lưu ý**:&#x20;

\+ Chỉ cài đặt 1 lần duy nhất. Lần tiếp chạy chỉ cần click douple vào file example\_api và example\_stream

* Đặt/sửa/hủy lệnh và truy vẫn thông tin tại link: <http://127.0.0.1:8000/docs> (khoanh đỏ trong ảnh)&#x20;
* Nghe streaming lệnh

\+ File example\_api và example\_streaming đã bao gồm hết các hàm trong link đính kèm
{% endhint %}

### Chạy Client

Sau khi cài đặt, trong thư mục sẽ có các file sau:

* <mark style="color:purple;">fc\_config.py</mark>: file chứa các cấu hình kết nối
* <mark style="color:purple;">example\_api</mark>: file chạy test các câu lệnh api
* <mark style="color:purple;">example\_stream</mark>: file test kết nối streaming

#### Cấu hình kết nối

Nhập thông tin consumerID, consumerSecret, privateKey của bạn vào file fc\_config.py. Nhập phương thức xác thực mà bạn đã đăng ký vào trường twoFAtype và lưu file. Lưu ý: Điền 0 nếu bạn dùng PIN. Điền 1 nếu bạn dùng SMS OTP/Email OTP/Smart OTP.

#### Chạy test api

Double click vào file example\_api, sau đó mở link: <http://127.0.0.1:8000/docs> để đặt lệnh và truy vấn thông tin lệnh.&#x20;

<figure><img src="/files/fFUFWdyHrMF0CLdvjeHD" alt=""><figcaption><p>Swagger đặt lệnh và truy vấn API</p></figcaption></figure>

#### Streaming

* Click douple vào file example\_stream để nghe Streaming lệnh. Thông tin như ảnh:

<figure><img src="/files/bxhrg8KdwjIAmiIsRueO" alt="" width="375"><figcaption><p>Streaming lệnh </p></figcaption></figure>

## Nodejs Client

### Cài đặt Client

#### Đường dẫn tải Client

[https://github.com/SSI-Securities-Corporation/node-fctrading](https://github.com/SSI-Securities-Corporation/python-fctrading/releases/latest/download/fc-trading.py.zip)

#### Yêu cầu về Node.js

* Máy tính cần có cài đặt Node.js (cài đặt từ bản v.10.15.3 trở lên)
* Kiểm tra máy tính đã cài đặt Node.js và version bằng câu lệnh: cmd node –version

![](/files/TCOlp2F9jUkkeHV1rEla)

#### Cài đặt Client

**Bước 1:** [Tải client](https://github.com/SSI-Securities-Corporation/python-fctrading/releases/latest/download/fc-trading.zip) từ đường dẫn và giải nén

**Bước 2:** Gõ cmd vào ô địa chỉ thư mục để khởi tạo command line

![](/files/OdnThCvVFgU1dn39QiDq)

**Bước 3:** Chạy câu lệnh sau để cài đặt

```
npm install ssi-fctrading
```

{% hint style="info" %}
**Lưu ý**: Đối với khách hàng dùng mạng có proxy thì thực hiện các bước cấu hình proxy trước khi chạy câu lệnh cài đặt. Xem chi tiết [tại đây](broken://pages/1oRUqxT4JWWYDDgcecVY).&#x20;
{% endhint %}

### Chạy Client

Sau khi cài đặt, trong thư mục sẽ có các file <mark style="color:blue;">index.js</mark>. File này chứa toàn bộ các thông tin kết nối, dữ liệu test và là file chạy chính. Bạn cần chỉnh cấu hình và dữ liệu phù hợp trước khi chạy. Các bước thực hiện chi tiết như sau:

#### Cấu hình kết nối

* Nhập giá trị ConsumerID, ConsumerSecret, PrivateKey tại mục config trong file index.js bằng bộ key kết nối của bạn.&#x20;
* Cấu hình phương thức bạn đang sử dụng vào trường TwoFAType. Nếu bạn dùng PIN, nhập 0. Nếu bạn dùng SMS OTP/Email OTP/SmartOTP, nhập 1.&#x20;

#### &#x20;                                ![](/files/CilF6x9lHSwy4Oh1TKS2)

#### Nhập thông tin tài khoản/lệnh

Trong file index.js, biến "mockStockData" chứa các thông tin dùng để đặt lệnh cơ sở và "mockDerivativeData" chứa các thông tin dùng để đặt lệnh phái sinh. Bạn cần chỉnh sửa thông tin cho phù hợp: số tài khoản đặt lệnh, loại lệnh, mã chứng khoán, giá, khối lượng... và thực hiện lưu file.&#x20;

#### Nhập mã xác thực

Nhập mã xác thực vào trường code ở 2 hàm “mockStockData” và “mockDeterativeData” trong file index.js và lưu file.&#x20;

&#x20;                       ![](/files/cf0VxmRd1f0611c3juza)

**Cách lấy mã xác thực:**

* Khách hàng sử dụng PIN để giao dịch, nhập mã PIN
* Khách hàng dùng SMS/Email OTP: mở trình duyệt và chạy localhost:3011/getOTP để lấy mã OTP.&#x20;

&#x20;                        ![](/files/KQ15lJwPPIj7T7FsMosL)

* Khách hàng dùng SmartOTP: lấy mã OTP trên ứng dụng SSI SmartOTP hoặc iBoard tùy theo bạn kích hoạt SmartOTP trên ứng dụng nào.&#x20;

#### Chạy ứng dụng

Mở cmd và chạy lại câu lệnh: node index.js

![](/files/YVW3ySsXa3uvRiksUZm9)

<figure><img src="/files/GWOViDlytpWroO5Xb5Rh" alt=""><figcaption></figcaption></figure>

#### Đặt lệnh và theo dõi streaming

* Mở trình duyệt và gõ câu lệnh sau: <mark style="color:blue;">localhost:3011/NewOrder</mark>
* Theo dõi streaming lệnh trên màn hình cmd trước đó đã chạy file index.js

&#x20;                   ![](/files/cb7k4M4N4ZcAdcHudAUM)

Bạn cũng có thể chạy thử các hàm truy vấn khác bằng cách gõ tương ứng tên các hàm có trong file index.js

Ví dụ để lấy sức mua của tài khoản, chạy câu lệnh <mark style="color:blue;">localhost:3011/maxBuyQty</mark>

&#x20;                  ![](/files/vmvIkofZAPrALAQInHtQ)

{% hint style="info" %}
Streaming trạng thái lệnh chỉ có khi đặt/sửa/hủy/khớp lệnh.

Streaming danh mục phái sinh chỉ có khi có khớp lệnh hoặc khi mã trong danh mục có thay đổi giá thị trường.&#x20;
{% endhint %}

## Client Java

### Cài đặt

#### Đường dẫn tải client

<https://github.com/SSI-Securities-Corporation/java-fctrading>

#### Cài đặt Java

Yêu cầu máy tính hoặc laptop cần cài đặt java

#### Cài đặt Client

**Bước 1:** Giải nén

**Bước 2:** Gõ cmd vào ô địa chỉ thư mục để khởi tạo command line

<figure><img src="/files/v8aHB6NhxkTa8lC4Uztr" alt=""><figcaption><p>Màn hình sau khi giải nén</p></figcaption></figure>

Màn hình hiển thị cửa sổ như sau:

<figure><img src="/files/ly6MHb68D4r9AKHHvZbP" alt=""><figcaption><p>Màn hình hiển thị khi gõ cmd</p></figcaption></figure>

**Bước 3:** Chạy câu lệnh cài đặt

```
java -jar <tensamplejava>.jar
```

<figure><img src="/files/KJ0wApLFXzSZDL45fvVL" alt=""><figcaption><p>Màn hình minh họa cài đặt thành công</p></figcaption></figure>

### Chạy Client

Trong thư mục vừa cài đặt thành công sẽ có các file sau:&#x20;

* <mark style="color:blue;">fctrading.json</mark> là file dùng để điền key kết nối và chạy thử API
* <mark style="color:blue;">samples-2.0.0</mark> là run file jar

#### Chạy API

Người dùng mở file <mark style="color:blue;">fctrading.json</mark> và điền bộ key kết nối&#x20;

<figure><img src="/files/bq4aJTA6Us8zf2p9shP1" alt=""><figcaption><p>Điền Key</p></figcaption></figure>

File  <mark style="color:blue;">fctrading.json</mark> chứa sẵn mẫu đầu vào cho các hàm. Người dùng có thể sử dụng luôn các đầu vào này để chạy hoặc chỉnh sửa đầu vào tùy nhu cầu.&#x20;

Nếu muốn chỉnh tham số đầu vào, người dùng mở file <mark style="color:blue;">fctrading.json</mark> (bằng Notepad ++…) và chỉnh sửa rồi lưu lại.&#x20;

<figure><img src="/files/2RcB5b8ROOP6DKBKnyfI" alt=""><figcaption><p>Điền thông tin Input</p></figcaption></figure>

Để chạy test thử các api, thực hiện các step sau:

**Bước 1:** Điền key kết nối và nhập thông tin input các hàm API muốn chạy -> Lưu

<figure><img src="/files/rA5rSjo6FGf5IbjO0n9E" alt=""><figcaption><p>Điền Key kết nối và thông tin input</p></figcaption></figure>

{% hint style="info" %}
**Lưu ý:**&#x20;

* code: Điền mã PIN nếu Khách hàng sử dụng phương thức xác thực là PIN
* Nếu khách hàng sử dụng phương thức xác thực OTP -> không bắt buộc điền
  {% endhint %}

**Bước 2:** Chạy Client và lựa chọn 1 + Thứ tự API tương ứng để kiểm tra dữ liệu API

<figure><img src="/files/1wBMYxHqYLtKs1p8R0pK" alt=""><figcaption><p>Kiểm tra dữ liệu API</p></figcaption></figure>

{% hint style="info" %}
**Lưu ý:** &#x20;

* Điền lại key kết nối hoặc thay đổi input API cần Lưu file và chọn số 35 để khởi tạo lại Client&#x20;
* Khởi tạo lại Client -> Chọn số 3 để Exit
* Nếu khách hàng sử dụng phương thức xác thực là OTP -> Khởi tạo lần đầu tiên hệ thống mặc định isSave = false và yêu cầu nhập OTP
* Phương thức xác thực OTP và isSave = false -> Trước khi giao dịch đều cần nhập mã OTP
  {% endhint %}

#### Kết nối streaming dữ liệu

Điền key kết nối và chọn số 2 để nghe FCTrading streaming -> Lưu

<figure><img src="/files/Q2MZjmKOc4FHa2dccIWJ" alt=""><figcaption><p>Thông tin kết nối streaming thành công</p></figcaption></figure>

## Client .Net

### Cài đặt

#### Đường dẫn tải client

[https://github.com/SSI-Securities-Corporation/dotnet-fctrading](https://github.com/SSI-Securities-Corporation/dotnet-fctrading/releases/latest/download/fc-trading-win64.net.zip)

#### Cài đặt Client

**Bước 1:** Giải nén

Màn hình giải nén hiển thị thông tin như sau:&#x20;

<figure><img src="/files/xxgoj0WMblj6iAsdEi28" alt=""><figcaption></figcaption></figure>

**Bước 2:** Mở Client

Double click vào icon dòng text "SSI.FCTrading.ClientExample"

<figure><img src="/files/nEWvb8diu4qmrnTVb2Uz" alt=""><figcaption></figcaption></figure>

Client hiển thị thông tin như sau:&#x20;

<figure><img src="/files/C2cHTMt3cJIEmGkieUku" alt=""><figcaption></figcaption></figure>

### Chạy Client

Trong thư mục vừa cài đặt thành công có file sau:&#x20;

* <mark style="color:blue;">data</mark> là file dùng để điền key kết nối và chạy thử API

<figure><img src="/files/pVkC0QyEKNBua9vJOqQS" alt=""><figcaption></figcaption></figure>

#### Chạy API

Người dùng mở file <mark style="color:blue;">data</mark> và điền bộ key kết nối&#x20;

<figure><img src="/files/2fJ3tLZmvS5nwZIdauzV" alt=""><figcaption></figcaption></figure>

File  <mark style="color:blue;">data</mark> chứa sẵn mẫu đầu vào cho các hàm. Người dùng có thể sử dụng luôn các đầu vào này để chạy hoặc chỉnh sửa đầu vào tùy nhu cầu.&#x20;

Nếu muốn chỉnh tham số đầu vào, người dùng mở file <mark style="color:blue;">data</mark> (bằng Notepad ++…) và chỉnh sửa rồi lưu lại.&#x20;

<figure><img src="/files/NR48KY8lTVayExoVGWzJ" alt=""><figcaption></figcaption></figure>

Để chạy test thử các api, thực hiện các step sau:

**Bước 1:** Điền key kết nối và nhập thông tin input các hàm API muốn chạy -> Lưu

<figure><img src="/files/8EikuKB7sKQ8dCUjFXgV" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Lưu ý:**&#x20;

* code: Điền mã PIN nếu Khách hàng sử dụng phương thức xác thực là PIN
* Nếu khách hàng sử dụng phương thức xác thực OTP -> không bắt buộc điền
  {% endhint %}

**Bước 2:** Chạy Client và lựa chọn 1 + Thứ tự API tương ứng để kiểm tra dữ liệu API

<figure><img src="/files/iKYX78XwjwaI29x2piTU" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Lưu ý:** &#x20;

* Điền lại key kết nối hoặc thay đổi input API cần Lưu file và chọn số 19 để khởi tạo lại Client&#x20;
* Khởi tạo lại Client -> Chọn số 3 để Exit
* Nếu khách hàng sử dụng phương thức xác thực là OTP -> Khởi tạo lần đầu tiên hệ thống mặc định isSave = false và yêu cầu nhập OTP (chọn số 1 để lấy OTP)
* Phương thức xác thực OTP và isSave = false -> Trước khi giao dịch đều cần nhập mã OTP
  {% endhint %}

#### Kết nối streaming dữ liệu

Điền key kết nối và chọn số 2 để nghe FCTrading streaming -> Lưu

<figure><img src="/files/HHtwMHoECF3a4WlYQ1cI" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guide.ssi.com.vn/ssi-products/tieng-viet/fastconnect-trading/su-dung-client-mau.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.