> 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-data/su-dung-client-mau.md).

# Sử dụng Client mẫu

Đường dẫn dịch vụ

Hiện FastConnect Data được truy cập qua các url sau:

* URL api: <mark style="color:blue;"><https://fc-data.ssi.com.vn/v2.0/Market></mark>
* URL streaming giá đối với Nodejs: <mark style="color:blue;">wss\://fc-datahub.ssi.com.vn/v2.0</mark>
* URL streaming giá đối với Python/ .Net: <mark style="color:blue;"><https://fc-datahub.ssi.com.vn></mark>
* URL api Java/ .Net: <mark style="color:blue;"><https://fc-data.ssi.com.vn/></mark>
* URL streaming giá đối với Java: <mark style="color:blue;"><https://fc-datahub.ssi.com.vn/></mark>

{% hint style="info" %}
SSI cung cấp sample code cho ba ngôn ngữ lập trình là **Python,** **Nodejs, Java** và **.Net**. Tên thường gọi là **Client Python, Client Nodejs, Client Java** và **.Net**.
{% endhint %}

## Client Python

### Cài đặt

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

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

#### Cài đặt 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 ý**: Bạn nhớ tick Add system path khi setup Python
{% endhint %}

#### 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/4GIRnF57fQp8NOM68ohL" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/GNTGI0snCkohwhghQzlj" alt=""><figcaption><p>Cửa sổ cmd</p></figcaption></figure>

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

```
pip install ssi-fc-data
```

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

{% 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. Chi tiết [tại đây](broken://pages/1oRUqxT4JWWYDDgcecVY).
{% endhint %}

### 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;">config.py</mark> là file lưu các cấu hình kết nối đến dịch vụ (ConsumerID, ConsumerSecret và PrivateKey). Bạn sẽ cần nhập các thông tin kết nối lấy được trên iBoard ở bước [Đăng ký dịch vụ](/ssi-products/tieng-viet/dang-ky-dich-vu.md) vào đây trước khi chạy thử client.&#x20;
* <mark style="color:blue;">test\_Req\_Res.py</mark> là file dùng để chạy thử các api
* <mark style="color:blue;">test\_Streaming.py</mark> là file dùng để chạy thử kết nối streaming

#### Chạy API

File  <mark style="color:blue;">**test\_Req\_Res.py**</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 test\_Req\_Res.py (bằng Notepad ++…) và chỉnh sửa rồi lưu lại.&#x20;

<figure><img src="/files/ZHJKO1bvUjOJi8Fnj6Lc" alt=""><figcaption><p>Minh họa tham số đầu vào trong file </p></figcaption></figure>

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

**Bước 1:** Chạy câu lệnh:&#x20;

```
python test_Req_Res.py
```

**Bước 2:** Nhập input cho hàm cần truy vấn từ số 11 -> 18

<figure><img src="/files/WFFelbgCTWwBNxfoLQho" alt=""><figcaption><p>Minh họa màn hình gọi hàm truy vấn thành công</p></figcaption></figure>

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

**Bước 1:** Chạy file test\_Streaming.py bằng câu lệnh: python test\_Streaming.py

**Bước 2:** Nhập loại dữ liệu cần cập nhật streaming là một trong các giá trị sau: &#x20;

* ALL: Tất cả dữ liệu
* F: Trạng thái mã chứng khoán
* X: Dữ liệu giá mua bán tốt nhất
* R: Room giao dịch nước ngoài
* MI: Dữ liệu chỉ số
* B: Dữ liệu OHLC realtime

{% hint style="info" %}
Xem mô tả từng loại dữ liệu streaming chi tiết tại mục [2. Streaming FastConnect Data](https://guide.ssi.com.vn/ssi-products/tieng-viet/fastconnect-data/pages/gcBDFec4YHSZxNZH6pir#2.-streaming-fastconnect-data)
{% endhint %}

Ví dụ, muốn nhận thông tin streaming cập nhật chỉ số VN30, người dùng cần nhập thông tin là MI:VN30

<figure><img src="/files/gqgC6mFMbGBKtnGkGKDK" alt=""><figcaption><p>Streaming chỉ số VN30</p></figcaption></figure>

{% hint style="info" %}
Lưu ý: Khi nhập dữ liệu streaming là ALL, lượng dữ liệu trả ra lớn, có thể gây chậm phía client
{% endhint %}

## Client Nodejs

### Cài đặt

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

[https://github.com/SSI-Securities-Corporation/node-fcdata](https://github.com/SSI-Securities-Corporation/node-fcdata/releases/latest/download/fc-data.zip)

Hoặc người dùng có thể đăng nhập iBoard, vào mục Dịch vụ API/Quản lý dịch vụ và click tải Client từ đây (xem ảnh minh họa bên dưới).&#x20;

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

#### Cài đặt Nodejs

Máy tính cần cài đặt Nodejs version v.10.15.3 trở lên.&#x20;

Để kiểm tra máy tính đã cài đặt Nodejs và version đã cài, chạy câu lệnh

```
cmd node –v
```

<figure><img src="/files/WiuhBKcNXFHT4FxQFeax" alt="" width="383"><figcaption><p>Kiểm tra version Nodejs</p></figcaption></figure>

#### Cài đặt Nodejs 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/xFhlSdHe9rEv5ayiazPF" alt=""><figcaption></figcaption></figure>

**Bước 3:** Cài đặt Client bằng cách chạy câu lệnh sau

```
npm install ssi-fcdata
```

Màn hình trả hết quả như ảnh

<figure><img src="/files/F1EuoffwRyEDZN8szqy9" alt=""><figcaption><p>Minh họa cài đặt Client thành công</p></figcaption></figure>

{% 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 hướng dẫn [tại đây](broken://pages/4bjHVCLeGBBYxvyJtCH3).&#x20;
{% endhint %}

### 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;">config.js</mark>: là file lưu các cấu hình kết nối đến dịch vụ (Đường dẫn dịch vụ, ConsumerID, ConsumerSecret và PrivateKey). Bạn sẽ cần nhập các thông tin kết nối lấy được trên iBoard ở bước [Đăng ký dịch vụ](/ssi-products/tieng-viet/dang-ky-dich-vu.md) vào đây trước khi chạy thử client.&#x20;
* <mark style="color:blue;">main.js</mark> là file dùng để chạy thử các api và nhận streaming giá

#### **Thay cấu hình kết nối vào config.js**

Người dùng sử dụng thông tin kết nối lấy trên iBoard và thay vào file rồi lưu file.

* ConsumerId
* ConsumerSecret

<figure><img src="/files/lC0rerKJB93VPqub2l1S" alt=""><figcaption><p>Điền file config.js</p></figcaption></figure>

#### Chạy test

File  main.js 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 main.js (bằng Notepad ++…) và chỉnh sửa rồi lưu lại. &#x20;

Để chạy test, thực hiện quy trình sau:

**Bước 1:** mở cmd và chạy câu lệnh&#x20;

```
node main.js
```

Sau khi chạy thành công, màn hình sẽ hiển thị thông báo:&#x20;

&#x20;                                Example app listinging on port \<số port>!

**Người dùng lưu ý số port này để sử dụng ở bước tiếp theo.**

Ví dụ, ở màn hình dưới, app được chạy ở port <mark style="color:blue;">**3020**</mark>.&#x20;

<figure><img src="/files/RI4RaLwEsFGBTYdwxQJh" alt=""><figcaption><p>Minh họa chạy client thành công</p></figcaption></figure>

**Bước 2:** Mở trình duyệt và gõ đường dẫn sau

```
http://localhost:<port hiển thị trên màn hình chạy main.js>/<tên hàm cần truy vấn>
```

Thông tin được trả ra ngay trên màn hình trình duyệt.&#x20;

**Ví dụ:**&#x20;

Lấy danh sách các mã sàn HOSE, sử dụng hàm Securities, người dùng thực hiện như sau:

* Mở file main.js, tìm đến hàm Securities, điền HOSE vào trường market và lưu thay đổi vào file.&#x20;

<figure><img src="/files/smVNudsE5jFzdDGp4LMg" alt=""><figcaption><p>Minh họa sửa đầu vào của hàm trong file main.js</p></figcaption></figure>

* Mở trình duyệt và chạy câu lệnh: <http://localhost:3020/Securities>

<figure><img src="/files/iXftwCCqVHo4gCR8jMLe" alt=""><figcaption><p>Minh họa dữ liệu trả ra của hàm Securities</p></figcaption></figure>

#### Streaming Market data

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

![](/files/ybAl9ca1DYJ2V8ZGxwu8)

Bước 3: Vào file main.js xuống dòng 183 điền kênh muốn truy vấn -> Save

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

## Client Java

### Cài đặt

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

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

#### 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/XWQ0zt4Z7eB5Fz0ODTuq" 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/ftVva2TDNBiwsWRo7HzO" 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/jr5tENUYh9RpIaR6DP0T" 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;">fcdata.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;">fcdata.json</mark> và điền bộ key kết nối&#x20;

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

File  <mark style="color:blue;">fcdata.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;">fcdata.json</mark> (bằng Notepad ++…) và chỉnh sửa rồi lưu lại.&#x20;

<figure><img src="/files/7xSiujtmVC60jxOGlky4" alt=""><figcaption><p>Điền các tham số đầu vào trong file</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/5Bs4LCAZB81YpRnPbtIZ" alt=""><figcaption></figcaption></figure>

**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/6xqoIJoTwiCpTUo5Cd7e" 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ố 9 để khởi tạo lại Client&#x20;
* Khởi tạo lại Client -> Chọn số 3 để Exit
  {% endhint %}

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

**Bước 1:** Điền key kết nối và nhập thông tin input stream (trường channels) muốn nghe -> Lưu

{% hint style="info" %}
Xem mô tả từng loại dữ liệu streaming chi tiết tại mục [2. Streaming FastConnect Data](https://guide.ssi.com.vn/ssi-products/tieng-viet/fastconnect-data/pages/gcBDFec4YHSZxNZH6pir#2.-streaming-fastconnect-data)
{% endhint %}

<figure><img src="/files/WOCpiTmjMHAyGCZTVgLW" alt=""><figcaption><p>Điền key lựa chọn stream muốn nghe</p></figcaption></figure>

**Bước 2:** Chạy Client và lựa chọn 2 để nghe stream như ảnh

<figure><img src="/files/K4WvLLgoWRmrxbyinMu7" alt=""><figcaption><p>Màn hình hiển thị stream</p></figcaption></figure>

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

* &#x20;Điền lại key kết nối hoặc thay đổi thông tin nghe stream cần Lưu file và chọn số 9 để khởi tạo lại Client&#x20;
* Khởi tạo lại Client -> Chọn số 3 để Exit
  {% endhint %}

## Client .NET

### Cài đặt

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

<https://github.com/SSI-Securities-Corporation/dotnet-fcdata/releases/latest/download/fc-data-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/HG8I6FfEAO5diydQOgqU" alt=""><figcaption><p>Màn hình sau khi giải nén</p></figcaption></figure>

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

Double click vào icon dòng text "DotnetClientTest"

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

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

<figure><img src="/files/CxzX9RmSgPp9AlpQC51b" alt=""><figcaption><p>Client 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 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/GlNDdiDL1POyrsJjtII6" alt=""><figcaption><p>màn hình hiển thị file data</p></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/tvsEaapsiFD3lznzS14K" alt=""><figcaption></figcaption></figure>

File  <mark style="color:blue;">fcdata</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;">fcdata</mark> (bằng Notepad ++…) và chỉnh sửa rồi lưu lại.&#x20;

<figure><img src="/files/I0bgAvorQtEGU6qCppVk" alt=""><figcaption><p>Thay đổi 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/smaEGNoBNkTeTZQ3ZjHB" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/f7DkCgqKBu7hF5j3sKcX" 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ố 10 để khởi tạo lại Client&#x20;
* Khởi tạo lại Client -> Chọn số 3 để Exit
  {% endhint %}

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

**Bước 1:** Điền key kết nối và nhập thông tin input stream (trường channels) muốn nghe -> Lưu

{% hint style="info" %}
Xem mô tả từng loại dữ liệu streaming chi tiết tại mục [2. Streaming FastConnect Data](https://guide.ssi.com.vn/ssi-products/tieng-viet/fastconnect-data/pages/gcBDFec4YHSZxNZH6pir#2.-streaming-fastconnect-data)
{% endhint %}

<figure><img src="/files/gGB3X7Libv3EtfQ6dlK1" alt=""><figcaption><p>Điền stream muốn nghe</p></figcaption></figure>

**Bước 2:** Chạy Client và lựa chọn 1 để nghe stream như ảnh

<figure><img src="/files/3FGgVb1ArJC54eml5z96" alt=""><figcaption><p>Thông tin stream</p></figcaption></figure>

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

* &#x20;Điền lại key kết nối hoặc thay đổi thông tin nghe stream cần Lưu file và chọn số 10 để khởi tạo lại Client&#x20;
* Khởi tạo lại Client -> Chọn số 3 để Exit
  {% endhint %}