Models
Các model dữ liệu và message streaming trong Go SDK
Tất cả model là Go struct. Import từ package tương ứng.
Cấu trúc Package
ssi-sdk-go/v3/
├── ssi/ → Auth, Data, Trading, Stream (import chính)
├── auth/ → Token
├── account/ → Account
├── market/ → OHLCData, MarketIndexes, MarketIndexSummary, SecuritiesInfo, SecuritiesSummary
├── trading/ → PlaceOrderResponse, ModifyOrderResponse, CancelOrderResponse, MaxBuySellResponse
├── portfolio/ → EquityAccountBalance, DerivativeAccountBalance, EquityPosition, DerivativePosition, Order
├── stream/ → TradeMessage, QuoteMessage, OrderStatusMessage, PortfolioMessage, ...
└── (root) → SSIError, APIError, AuthenticationError, ...Xác thực
Token
| Field | Kiểu | Mô tả |
|---|---|---|
AccessToken | string | Access token |
TokenType | string | Loại token (mặc định "Bearer") |
ExpiresAt | int64 | Timestamp hết hạn |
RefreshToken | string | Refresh token |
RefreshTokenExpiresAt | int64 | Timestamp hết hạn refresh token |
Tài khoản
Account
| Field | Kiểu | Mô tả |
|---|---|---|
AccountNo | string | Số tài khoản |
AccountType | string | Loại tài khoản |
Dữ liệu thị trường
OHLCData
| Field | Kiểu | Mô tả |
|---|---|---|
Symbol | string | Mã chứng khoán |
TradingDate | string | Ngày giao dịch |
OpenPrice | float64 | Giá mở |
HighPrice | float64 | Giá cao |
LowPrice | float64 | Giá thấp |
ClosePrice | float64 | Giá đóng |
Volume | int64 | Khối lượng |
Value | float64 | Giá trị giao dịch |
MarketIndexes
| Field | Kiểu | Mô tả |
|---|---|---|
Index | string | Mã chỉ số |
IndexName | string | Tên chỉ số |
Board | string | Sàn |
MarketIndexSummary
| Field | Kiểu | Mô tả |
|---|---|---|
Index | string | Mã chỉ số |
Board | string | Sàn |
TradingDate | string | Ngày giao dịch |
IndexValue | float64 | Giá trị chỉ số |
IndexChange | float64 | Thay đổi |
IndexChangePercent | float64 | Thay đổi (%) |
TotalTrade | int64 | Tổng khối lượng giao dịch |
TotalTradeValue | float64 | Tổng giá trị giao dịch |
TotalAdvanceStock | int | Số CP tăng |
TotalDeclineStock | int | Số CP giảm |
TotalSteadyStock | int | Số CP không đổi |
SecuritiesInfo
| Field | Kiểu | Mô tả |
|---|---|---|
Symbol | string | Mã chứng khoán |
Board | string | Sàn |
Index | string | Chỉ số |
SymbolNameVi | string | Tên tiếng Việt |
SymbolNameEn | string | Tên tiếng Anh |
LotSize | int | Lô giao dịch |
ListedShares | int64 | Số CP niêm yết |
IcbCode | string | Mã ICB |
IcbName | string | Tên ICB |
SecuritiesSummary
| Field | Kiểu | Mô tả |
|---|---|---|
Symbol | string | Mã chứng khoán |
TradingDate | string | Ngày giao dịch |
PriceChange | float64 | Thay đổi giá |
PriceChangePercent | float64 | Thay đổi giá (%) |
OpenPrice | float64 | Giá mở |
HighPrice | float64 | Giá cao |
LowPrice | float64 | Giá thấp |
ClosePrice | float64 | Giá đóng |
TotalMatch | int64 | Tổng khối lượng khớp |
TotalMatchValue | float64 | Tổng giá trị khớp |
Danh mục
EquityAccountBalance
Các field chính: AccountNo, AvailableCash, TotalDebt, Withdrawal, OnHoldCash, SellT0/SellT1/SellT2, BuyT0/BuyT1/BuyT2, BankBalance, BlockCash, LimitT0, TermDeposit.
DerivativeAccountBalance
Các field chính: AccountNo, AccountBalance, Fee, Commission, Interest, Loan, FloatingPL, TradingPL, TotalPL, Withdrawable, CashSSI, CashVSDC.
EquityPosition
| Field | Kiểu | Mô tả |
|---|---|---|
AccountNo | string | Số tài khoản |
Symbol | string | Mã chứng khoán |
Quantity | int | Tổng khối lượng |
SellableQuantity | int | Khối lượng bán được |
CostPrice | float64 | Giá vốn |
BuyingQuantity | int | Khối lượng đang mua |
SellingQuantity | int | Khối lượng đang bán |
MortgageQuantity | int | Khối lượng cầm cố |
DerivativePosition
| Field | Kiểu | Mô tả |
|---|---|---|
AccountNo | string | Số tài khoản |
Symbol | string | Mã hợp đồng |
Long / Short / Net | int | Vị thế Long / Short / Net |
BidAvgPrice / AskAvgPrice | float64 | Giá TB mua / bán |
FloatingPL / TradingPL | float64 | Lãi/lỗ |
Order
| Field | Kiểu | Mô tả |
|---|---|---|
AccountNo | string | Số tài khoản |
ClientRequestID | string | Client request ID |
OrderID | string | Order ID |
Symbol | string | Mã chứng khoán |
Side | string | Mua/Bán |
OrderType | string | Loại lệnh |
Price / AvgPrice | float64 | Giá đặt / Giá khớp TB |
Quantity | int | Khối lượng đặt |
OsQuantity | int | Khối lượng chờ |
FilledQuantity | int | Khối lượng khớp |
CancelQuantity | int | Khối lượng huỷ |
Status | string | Trạng thái lệnh |
InputTime / ModifyTime | string | Thời gian đặt / sửa |
Message | string | Thông báo |
Response giao dịch
PlaceOrderResponse
OrderID, ClientRequestID, Status
ModifyOrderResponse
ClientModifyID, OrderID, ClientRequestID, Status
CancelOrderResponse
ClientCancelID, OrderID, ClientRequestID, Status
MaxBuySellResponse
AccountNo, Symbol, MaxBuyQuantity, MaxSellQuantity, MarginRatio, PurchasePower
Message Streaming
TradeMessage
Type, TradingTime, Symbol, Price, Quantity, Side, TotalVolume
QuoteMessage
Type, TradingTime, Symbol, BidPrices, BidVolumes, AskPrices, AskVolumes
ForeignRoomMessage
Type, TradingTime, Symbol, TotalRoom, CurrentRoom, BuyQuantity, BuyValue, SellQuantity, SellValue
PutMessage
Type, TradingTime, Symbol, Price, Quantity, TotalQuantity, TotalValue
OddLotMessage
Type, TradingTime, Symbol, Price, Quantity, BidPrices, BidVolumes, AskPrices, AskVolumes
MarketStatusMessage
Market, Status, TradingDate
OrderStatusMessage
Type, AccountNo, ClientRequestID, OrderID, Symbol, Side, OrderType, Price, Quantity, OsQuantity, FilledQuantity, CancelQuantity, Status, InputTime, ModifyTime, Message
PortfolioMessage
Type, AccountNo, TotalAsset, CashBalance, StockValue
HeartbeatMessage
Method, Channel, Status, Message