.NET

Models

Các model dữ liệu trả về trong .NET SDK

Tất cả model nằm trong namespace SsiSdk.Models, là các sealed class với auto-property:

using SsiSdk.Models;

Xác thực

Token

TrườngKiểuMô tả
AccessTokenstringToken truy cập
TokenTypestringLoại token (mặc định "Bearer")
ExpiresAtlongThời điểm hết hạn (timestamp)
RefreshTokenstringToken làm mới
RefreshTokenExpiresAtlongThời điểm refresh token hết hạn

Account

Account

TrườngKiểuMô tả
AccountNostringSố tài khoản
AccountTypestringLoại tài khoản

Market Data

OhlcData

TrườngKiểuMô tả
SymbolstringMã chứng khoán
TradingDatestringNgày giao dịch
OpenPricedoubleGiá mở cửa
HighPricedoubleGiá cao nhất
LowPricedoubleGiá thấp nhất
ClosePricedoubleGiá đóng cửa
VolumeintKhối lượng
ValuedoubleGiá trị giao dịch

MarketIndexes

TrườngKiểuMô tả
IndexstringMã chỉ số
IndexNamestringTên chỉ số
Boardstring?Sàn

MarketIndexSummary

TrườngKiểuMô tả
IndexstringMã chỉ số
BoardstringSàn
TradingDatestringNgày giao dịch
IndexValuedoubleGiá trị chỉ số
IndexChangedoubleThay đổi
IndexChangePercentdoubleThay đổi (%)
TotalTradeintTổng KL giao dịch
TotalTradeValuedoubleTổng giá trị giao dịch
TotalAdvanceStockintSố mã tăng
TotalDeclineStockintSố mã giảm
TotalSteadyStockintSố mã đứng
TotalMatchintTổng khối lượng khớp
TotalMatchValuedoubleTổng giá trị khớp
TotalDealintTổng khối lượng thoả thuận
TotalDealValuedoubleTổng giá trị thoả thuận
TotalCeilingStockintSố CP trần
TotalFloorStockintSố CP sàn
TotalPropBuyintTổng KL mua tự doanh
TotalPropBuyValuedoubleTổng GT mua tự doanh
TotalPropSellintTổng KL bán tự doanh
TotalPropSellValuedoubleTổng GT bán tự doanh

SecuritiesInfo

TrườngKiểuMô tả
SymbolstringMã chứng khoán
Boardstring?Sàn
IndexstringChỉ số
SymbolNameVistringTên tiếng Việt
SymbolNameEnstringTên tiếng Anh
LotSizeintLô giao dịch
ListedSharesintSố CP niêm yết
IcbCodestring?Mã ngành ICB
IcbNamestring?Tên ngành ICB
MaturityDatestring?Ngày đáo hạn
FirstTradingDatestring?Ngày GD đầu tiên
LastTradingDatestring?Ngày GD cuối cùng
CwUnderlyingSymbolstring?Mã CK cơ sở CW
CwExercisePricedouble?Giá thực hiện CW
CwExecutionRatiodouble?Tỷ lệ thực hiện CW
IIndexdouble?Chỉ số I
INavdouble?Giá trị iNAV

SecuritiesSummary

TrườngKiểuMô tả
SymbolstringMã chứng khoán
TradingDatestringNgày giao dịch
PriceChangedoubleThay đổi giá
PriceChangePercentdoubleThay đổi giá (%)
OpenPricedoubleGiá mở cửa
HighPricedoubleGiá cao nhất
LowPricedoubleGiá thấp nhất
ClosePricedoubleGiá đóng cửa
AveragePricedoubleGiá trung bình
TotalMatchintTổng KL khớp
TotalMatchValuedoubleTổng giá trị khớp
TotalBuyintTổng KL mua
TotalTradeBuydoubleTổng GT mua
TotalSellintTổng KL bán
TotalTradeSelldoubleTổng GT bán

DownloadData

TrườngKiểuMô tả
DataList<Dictionary<string, object>>Dữ liệu raw dạng bảng
TotalCountintTổng số bản ghi

Portfolio

EquityAccountBalance

TrườngKiểuMô tả
AccountNostringSố tài khoản
AccountBalancedoubleSố dư tài khoản (tiền mặt khả dụng)
TotalDebtdoubleTổng nợ
InterestLoandoubleLãi vay
OverdueFeeLoandoublePhí vay quá hạn
WithdrawabledoubleTiền có thể rút
OnHoldCashdoubleTiền tạm giữ
SellUnmatched / BuyUnmatcheddoubleTiền bán/mua chờ khớp
SellT0 / SellT1 / SellT2doubleTiền bán T0/T1/T2
BuyT0 / BuyT1 / BuyT2doubleTiền mua T0/T1/T2
AdvanceCashT0 / AdvanceCashT1doubleỨng tiền T0/T1
HoldSubscriptiondoubleTiền giữ đăng ký

DerivativeAccountBalance

TrườngKiểuMô tả
AccountNostringSố tài khoản
AccountBalancedoubleSố dư tài khoản
Fee / Commission / Interest / ExtInterestdoublePhí / Hoa hồng / Lãi
LoandoubleVay
DeliveryAmountdoubleGiá trị giao nhận
FloatingPL / TradingPL / TotalPLdoubleLãi/lỗ chưa thực hiện / giao dịch / tổng
WithdrawabledoubleTiền rút được
CashSSI / ValidNonCashSSI / CashWithdrawableSSIdoubleTiền mặt / tài sản phi tiền mặt hợp lệ / rút được (SSI)
CashVSDC / ValidNonCashVSDC / CashWithdrawableVSDCdoubleTương tự tại VSDC

EquityPosition

TrườngKiểuMô tả
AccountNostringSố tài khoản
SymbolstringMã chứng khoán
QuantityintTổng số lượng
SellableQuantityintSố lượng bán được
CostPricedoubleGiá vốn
BuyingQuantity / SellingQuantityintSL đang mua / đang bán
BoughtQuantity / SoldQuantityintKhối lượng đã mua / đã bán
MortgageQuantityintSL cầm cố
BlockQuantityintKhối lượng phong toả
DividendQuantityintKhối lượng cổ tức
T1SellQuantity / T2SellQuantityintKL bán T1 / T2
RestrictedQuantityintKhối lượng hạn chế

DerivativePosition

TrườngKiểuMô tả
AccountNostringSố tài khoản
SymbolstringMã hợp đồng
Long / Short / NetintVị thế mua / bán / ròng
BidAvgPrice / AskAvgPricedoubleGiá TB mua / bán
TradePricedoubleGiá giao dịch
FloatingPL / TradingPLdoubleLãi/lỗ

AllDerivativePosition

TrườngKiểuMô tả
OpenPositionsList<DerivativePosition>Vị thế đang mở
ClosedPositionsList<DerivativePosition>Vị thế đã đóng

Order

TrườngKiểuMô tả
AccountNostringSố tài khoản
ClientRequestIdstringID yêu cầu client
OrderIdstringID lệnh
SymbolstringMã chứng khoán
SidestringMua/Bán
OrderTypestringLoại lệnh
Price / AvgPricedoubleGiá đặt / Giá TB khớp
QuantityintSL đặt
OsQuantityintSL chờ
FilledQuantityintSL đã khớp
CancelQuantityintSL đã huỷ
StatusstringTrạng thái lệnh
InputTime / ModifyTimestringThời gian đặt / sửa
MessagestringThông báo

EquityPPMMR / DerivativePPMMR

Hai model chứa rất nhiều chỉ số ký quỹ chi tiết (margin ratio, limit, collateral, ...). Các trường thường dùng nhất:

TrườngKiểuMô tả
AccountNostringSố tài khoản
PurchasingPower (EquityPPMMR)doubleSức mua
WithdrawabledoubleTiền/tài sản rút được
MarginRatiodoubleTỷ lệ ký quỹ
TotalEquitydoubleTổng tài sản ròng
AccountBalance (DerivativePPMMR)doubleSố dư tài khoản phái sinh

Trading Responses

PlaceOrderResponse

OrderId, ClientRequestId, Status — đều string.

ModifyOrderResponse

ClientModifyId, OrderId, ClientRequestId, Status — đều string.

CancelOrderResponse

ClientCancelId, OrderId, ClientRequestId, Status — đều string.

MaxBuySellResponse

TrườngKiểuMô tả
AccountNostringSố tài khoản
SymbolstringMã chứng khoán
MaxBuyQuantityintSL mua tối đa
MaxSellQuantityintSL bán tối đa
MarginRatiostringTỷ lệ ký quỹ
PurchasePowerstringSức mua

Lệnh điều kiện (FCO)

FCOPlaceResponse

Kết quả đặt lệnh điều kiện — FCOID (string).

FCOCancelResponse

Kết quả huỷ lệnh điều kiện — FCOID (string).

FCOListResponse

Danh sách lệnh điều kiện (phân trang).

TrườngKiểuMô tả
PageIndexintTrang hiện tại
PageSizeintKích thước trang
ItemsCountintTổng số bản ghi
PagesCountintTổng số trang
FCOListList<FCOInfo>Danh sách lệnh FCO

FCOInfo

Thông tin chi tiết một lệnh điều kiện.

TrườngKiểuMô tả
FCOIDstringMã lệnh FCO
ClientIDstringUsername / Client ID
AccountNostringSố tài khoản
QuantityintKhối lượng đặt
PricestringGiá đặt
PriceSlipdoubleĐộ trượt giá
SymbolstringMã chứng khoán
TypestringLoại lệnh điều kiện (xem FCOType)
FromDatestringNgày bắt đầu hiệu lực
ToDatestringNgày kết thúc hiệu lực
MatchedQuantityintKhối lượng đã khớp
IsPlaceOrderboolĐã đẩy lệnh vào sổ hay chưa
StatusstringTrạng thái lệnh FCO (xem FCOStatus)
DetailstringChi tiết trạng thái
ParamsFCOParams?Tham số kích hoạt lệnh FCO

FCOParams

Tham số kích hoạt của lệnh điều kiện.

TrườngKiểuMô tả
StopPricedoubleGiá dừng / giá kích hoạt
SidestringChiều lệnh (Mua/Bán)
ActivePricedoubleGiá kích hoạt (Trailing Stop)
TrailingAmountdoubleKhoảng bám sát (Trailing Amount)
TPActivePricedoubleGiá kích hoạt chốt lời (Take Profit)
SLActivePricedoubleGiá kích hoạt cắt lỗ (Stop Loss)
TPPricestringGiá chốt lời
SLPricestringGiá cắt lỗ
TPSlipdoubleTrượt giá chốt lời
SLSlipdoubleTrượt giá cắt lỗ
OperatorstringToán tử so sánh kích hoạt (xem FCOOperator)

FCOOrderBookResponse

Nhật ký khớp lệnh FCO (phân trang).

TrườngKiểuMô tả
PageIndexintTrang hiện tại
PageSizeintKích thước trang
ItemsCountintTổng số bản ghi
PagesCountintTổng số trang
OrderBookList<FCOOrder>Danh sách nhật ký lệnh FCO

FCOOrder

Nhật ký giao dịch / thực thi của lệnh FCO.

TrườngKiểuMô tả
FCOIDstringMã lệnh FCO gốc
AccountNostringSố tài khoản
QuantitydoubleKhối lượng
PricestringGiá đặt
SymbolstringMã chứng khoán
SidestringChiều lệnh
OrderTypestringLoại lệnh con
IsMainOrderboolLà lệnh chính
IsAttachedOrderboolLà lệnh kèm theo
CreatedTime / UpdatedTimestringThời gian tạo / cập nhật
UniqueIDstringID duy nhất
OrderIDstringMã lệnh trên sàn
MatchedQuantitydoubleKhối lượng đã khớp
OSQuantitydoubleKhối lượng chờ khớp
AvgPricedoubleGiá khớp trung bình
StatusstringTrạng thái lệnh con
DetailstringChi tiết

Streaming Messages

TradeMessage

Type, TradingTime, Symbol, Price, Quantity, Side, TotalVolume

IntervalMessage

TrườngKiểuMô tả
TypestringLoại dữ liệu
IntervalTimestringThời gian interval
TradingTimestringThời gian giao dịch
SymbolstringMã chứng khoán
Open / High / Low / ClosedoubleGiá OHLC
VolumeintKhối lượng

QuoteMessage

Type, TradingTime, Symbol, BidPrices: List<double>, BidVolumes: List<int>, AskPrices: List<double>, AskVolumes: List<int>

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

FCOOrderUpdateMessage

Cập nhật trạng thái lệnh điều kiện FCO (streaming, nhận qua SetOnTrading khi EventType == "fcoEvent", hoặc qua topic fco_order.*/fco.*).

TrườngKiểuMô tả
FCOIDstringMã lệnh FCO
ProcessStatusstringTrạng thái xử lý lệnh FCO (INIT, WAIT, WC, TER, ... — xem FCOStatus)
MatchedQuantityintKhối lượng đã khớp
IsPlaceOrderboolĐã đẩy lệnh vào sổ hay chưa
SymbolstringMã chứng khoán
QuantityintKhối lượng đặt
PricestringGiá đặt
AccountNostringSố tài khoản
UpdatedTimestringThời gian cập nhật
StatusstringMã trạng thái
MessagestringThông báo chi tiết / lý do kích hoạt
UsernamestringUsername đặt lệnh
EventTypestringLoại sự kiện ("fcoEvent")
FCOTypestringLoại lệnh điều kiện (gtd, stop, ... — xem FCOType)

HeartbeatMessage

Method, Channel, Status, Message

Trên trang này