Giới thiệu SSI SDK

Khi nào nên dùng SDK?

SDK giúp đội ngũ triển khai FastConnect nhanh hơn khi cần chuẩn hoá xác thực, gọi API, WebSocket streaming, và quản lý retry theo cùng một mẫu tích hợp. Thay vì tự xử lý token management, ký request, rate limiting, và error recovery, SDK lo các phần này để bạn tập trung vào logic nghiệp vụ.

Kiến trúc Client

Tất cả SDK dùng chung kiến trúc modular client:

Config → Auth → authenticate(otp) → Data / Trading / Stream

Client	Mô tả	Cần OTP
Auth	Xác thực & quản lý token. Entry point cho tất cả client khác.	-
Data	Dữ liệu thị trường — OHLC, chỉ số, thông tin & tổng hợp chứng khoán.	Không
Trading	Đặt/sửa/huỷ lệnh, thông tin tài khoản, danh mục, PPMMR.	Có
Stream	Streaming WebSocket realtime — dữ liệu thị trường & sự kiện giao dịch.	Có

Bộ SDK hiện có

SDK	Runtime	Cài đặt	Mã nguồn
Python SDK	Python 3.10+	`pip install ssi-sdk`	GitHub
Go SDK	Go 1.22+	`go get github.com/SSI-Securities-Inc/ssi-sdk-go/v3`	GitHub

Python

Hỗ trợ cả sync và async (Auth/AsyncAuth, Data/AsyncData, v.v.). Phù hợp cho data pipeline, automation, và Jupyter notebook.

from ssi_sdk import Auth, Data, Config

config = Config(
    client_id="YOUR_CLIENT_ID",
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
)

with Auth(config) as auth:
    auth.authenticate()

    with Data(auth) as data:
        ohlc = data.market_data.get_ohlc_1minute("SSI")
        print(ohlc)

Go

Dùng goroutines cho concurrency — không cần biến thể async riêng. Phù hợp cho dịch vụ hiệu năng cao và realtime.

import "github.com/SSI-Securities-Inc/ssi-sdk-go/v3/ssi"

config := ssi.NewConfig("YOUR_CLIENT_ID")
config.APIKey    = "YOUR_API_KEY"
config.APISecret = "YOUR_API_SECRET"

auth := ssi.NewAuth(config)
defer auth.Close()

if _, err := auth.Authenticate(""); err != nil {
    log.Fatal(err)
}

data := ssi.NewData(auth)
ohlc, err := data.MarketData.GetOHLC1Minute("SSI")

So sánh tính năng

Tính năng	Python	Go
REST API	Có	Có
WebSocket Streaming	Có	Có
Async support	`async`/`await`	goroutines
Dọn dẹp tài nguyên	`with` / `async with`	`defer`
Xử lý lỗi	Exception hierarchy	Type switch trên `error`
Rate limiting	Tích hợp sẵn	Tích hợp sẵn
Auto retry	Tích hợp sẵn	Tích hợp sẵn
Token auto-refresh	Tích hợp sẵn	Tích hợp sẵn

Quy trình tích hợp khuyến nghị

Cài đặt SDK phù hợp với ngôn ngữ hệ thống.
Cấu hình credentials (client_id, api_key, api_secret, private_key).
Xác thực — OTP không bắt buộc cho dữ liệu thị trường, bắt buộc cho giao dịch & streaming.
Khởi tạo client cần dùng (Data, Trading, hoặc Stream).
Gọi API hoặc subscribe các luồng dữ liệu realtime.

Trường hợp sử dụng

Trường hợp	Client	OTP
Dữ liệu thị trường (OHLC, chỉ số, chứng khoán)	`Data`	Không
Đặt/sửa/huỷ lệnh	`Trading`	Có
Thông tin tài khoản & danh mục	`Trading`	Có
Streaming WebSocket realtime	`Stream`	Có

Trên trang này