Cài đặt & Thiết lập

Yêu cầu môi trường

Go >=1.22
Truy cập mạng tới REST API và WebSocket endpoints
ClientID, APIKey, APISecret từ SSI
PrivateKey để ký lệnh giao dịch
OTP cho luồng xác thực Trading/Stream

Cài đặt

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

Cấu hình

Tạo đối tượng Config với thông tin xác thực:

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"
config.PrivateKey = "YOUR_PRIVATE_KEY"

Luồng khởi tạo

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

Tạo Config với ssi.NewConfig(clientID).
Khởi tạo Auth với ssi.NewAuth(config).
Gọi auth.Authenticate(otp) — truyền chuỗi rỗng "" nếu chỉ dùng dữ liệu thị trường.
Khởi tạo client cần dùng (Data, Trading, Stream) với auth.
Với Stream, gọi s.Connect() trước khi subscribe.
Dùng defer auth.Close() và defer s.Disconnect() để dọn dẹp tài nguyên.

Ví dụ theo trường hợp sử dụng

Chỉ lấy dữ liệu thị trường (không cần OTP)

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

Giao dịch (cần OTP)

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

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

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

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

t := ssi.NewTrading(auth)
accounts, err := t.Account.GetAccountInfo()

Streaming realtime (cần OTP)

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

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

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

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

s := ssi.NewStream(auth)
defer s.Disconnect()

s.Streaming.SetOnData(func(msg interface{}) {
    fmt.Println(msg)
})

if err := s.Connect(); err != nil {
    log.Fatal(err)
}

s.Streaming.SubscribeSymbolTrade([]string{"SSI"}, nil)
s.Wait(nil)

Mẹo

Xác thực trước khi gọi API có bảo vệ bằng token.
Với streaming, gọi s.Connect() sau khi xác thực thành công.
Dùng config.LogLevel = "DEBUG" để gỡ lỗi.
Lưu credentials (APIKey, APISecret, PrivateKey) trong biến môi trường hoặc secret manager.
Luôn dùng defer auth.Close() và defer s.Disconnect() để dọn dẹp đúng cách.

Trên trang này