Sub/Unsub Market Data

Theo dõi và hủy theo dõi dữ liệu thị trường qua WebSocket FastConnect.

​

Tổng quan

Kênh DATA trả về 6 nhóm thông tin thị trường:

Topic	Mô tả
trade	Thông tin khớp lệnh
quote	Thông tin bid/ask
room	Thông tin room ngoại
put	Khớp lệnh thỏa thuận
oddlot	Giao dịch lô lẻ
market	Thông tin đầu ngày và cờ phiên

​

Topic pattern

trade.[index/exchange/symbol-symbol/*]@[tick/1m/5m]
quote.[index/exchange/symbol-symbol/*]@[tick/1m/5m]
room.[index/exchange/symbol-symbol/*]@[tick/1m/5m]
put.[index/exchange/symbol-symbol/*]@[tick/1m/5m]
oddlot.[index/exchange/symbol-symbol/*]@[tick/1m/5m]
market.[index/exchange/symbol-symbol/*]

• Nhiều mã nối bằng dấu - (ví dụ ACB-SSI-GVR-KDH); * cho toàn bộ mã trong phạm vi quyền.
• Không truyền @interval thì mặc định là tick. Riêng topic market không có interval.

Interval hợp lệ hiện tại là tick, 1m, 5m (không có 3m).

​

Subscribe market data

{
  "method": "SUBSCRIBE",
  "channel": "DATA",
  "topics": ["trade.SSI", "trade.ACB-SSI-GVR-KDH", "trade.vn30", "trade.hose"]
}

• trade.SSI — đăng ký nhận message khớp của một mã SSI
• trade.ACB-SSI-GVR-KDH — đăng ký nhận message khớp của nhiều mã ACB, SSI, GVR, KDH
• trade.vn30 — đăng ký nhận message khớp của toàn bộ các mã thuộc rổ VN30
• trade.hose — đăng ký nhận message khớp của toàn bộ các mã thuộc sàn HOSE

Cú pháp tương tự áp dụng cho quote, room, put, oddlot, market — chỉ thay tiền tố topic (ví dụ quote.SSI, room.vn30, market.hose).

​

Unsubscribe market data

{
  "method": "UNSUBSCRIBE",
  "channel": "DATA",
  "topics": ["trade.SSI", "quote.SSI"]
}

---

​

I. Trade — thông tin khớp lệnh

Field	Name	Type	Description
s	symbol	String	Mã chứng khoán
t	tradingTime	String	YYYY/MM/DD HH:mi:ss
p	price	String	Giá khớp
q	quantity	String	Khối lượng khớp
a	avgPrice	String	Giá khớp trung bình
si	side	String	B: Buy Up (mua chủ động) / S: Sell Down (bán chủ động)
o	openPrice	String	Giá mở cửa
h	highPrice	String	Giá cao nhất
l	lowPrice	String	Giá thấp nhất
v	totalVol	String	Tổng khối lượng khớp trong ngày

Sample output:

{
  "s": "SSI",
  "t": "2026/07/29 09:15:32",
  "p": "45.50",
  "q": "1000",
  "a": "45.35",
  "si": "B",
  "o": "45.00",
  "h": "45.80",
  "l": "44.90",
  "v": "1250000"
}

​

II. Room — thông tin room ngoại

Field	Name	Type	Description
s	symbol	String	Mã chứng khoán
t	tradingtime	String	YYYY/MM/DD HH:mi:ss
tr	totalRoom	String	Tổng room ngoại
cr	currentRoom	String	Room ngoại còn lại
bq	buyQuantity	String	Khối lượng mua của khối ngoại
bv	buyValue	String	Giá trị mua của khối ngoại
sq	sellQuantity	String	Khối lượng bán của khối ngoại
sv	sellValue	String	Giá trị bán của khối ngoại

Sample output:

{
  "s": "SSI",
  "t": "2026/07/29 09:15:32",
  "tr": "1500000",
  "cr": "980000",
  "bq": "5000",
  "bv": "227500000",
  "sq": "3000",
  "sv": "136500000"
}

​

III. Quote — thông tin bid/ask

Field	Type	Description
s	String	Mã chứng khoán
t	String	tradingtime, YYYY/MM/DD HH:mi:ss
bids	List<String[2]>	Danh sách mức giá mua [price, quantity]. Bản nâng cấp sau sẽ chỉ trả ra các giá trị thay đổi.
asks	List<String[2]>	Danh sách mức giá bán [price, quantity]. Bản nâng cấp sau sẽ chỉ trả ra các giá trị thay đổi.

Sample output:

{
  "s": "SSI",
  "t": "2026/07/29 09:15:32",
  "bids": [
    ["45.45", "3200"],
    ["45.40", "1500"],
    ["45.35", "4200"],
    ["45.30", "2100"],
    ["45.25", "3300"]
  ],
  "asks": [
    ["45.50", "2800"],
    ["45.55", "1900"],
    ["45.60", "3600"],
    ["45.65", "2200"],
    ["45.70", "4100"]
  ]
}

​

IV. Put — khớp lệnh thỏa thuận

Field	Name	Type	Description
s	symbol	String	Mã chứng khoán
t	tradingtime	String	YYYY/MM/DD HH:mi:ss
p	price	String	Giá khớp thỏa thuận
q	quantity	String	Khối lượng khớp thỏa thuận
tq	TotalQuantity	String	Tổng khối lượng thỏa thuận trong ngày
tv	TotalValue	String	Tổng giá trị thỏa thuận trong ngày

Sample output:

{
  "s": "SSI",
  "t": "2026/07/29 10:05:12",
  "p": "45.00",
  "q": "50000",
  "tq": "350000",
  "tv": "15750000000"
}

​

V. Oddlot — giao dịch lô lẻ

Field	Name	Type	Description
s	symbol	String	Mã chứng khoán
t	tradingtime	String	YYYY/MM/DD HH:mi:ss
p	price	String	Giá khớp lô lẻ
q	quantity	String	Khối lượng khớp lô lẻ
bids	List<String[2]>	Danh sách mức giá mua lô lẻ [price, quantity]
asks	List<String[2]>	Danh sách mức giá bán lô lẻ [price, quantity]

Sample output:

{
  "s": "SSI",
  "t": "2026/07/29 09:16:05",
  "p": "45.50",
  "q": "80",
  "bids": [
    ["45.45", "50"],
    ["45.40", "30"]
  ],
  "asks": [
    ["45.55", "40"],
    ["45.60", "20"]
  ]
}

​

VI. Market — thông tin đầu ngày và phiên

Cú pháp subscribe không có interval: market.[index/exchange/symbol-symbol/*].

Market streaming data:

Field	Name	Type	Description
s	symbol	String	Mã chứng khoán
b	board	String	HOSE, HNX, UPCOM
t	tradingDate	String	YYYY/MM/DD
ce	ceilingPrice	String	Giá trần
fl	floorPrice	String	Giá sàn
ref	refPrice	String	Giá tham chiếu

Sample output:

{
  "s": "SSI",
  "b": "HOSE",
  "t": "2026/07/29",
  "ce": "48.50",
  "fl": "42.10",
  "ref": "45.30"
}

Market flag (message cờ phiên):

Field	Name	Type	Description
b	board	String	HOSE, HNX, UPCOM, DERIVATIVES
t	tradingTime	String	YYYY/MM/DD HH:mm:ss
f	flag	String	Cờ phiên: ATO, LO, ATC, v.v.

Sample output:

{
  "b": "HOSE",
  "t": "2026/07/29 09:00:00",
  "f": "ATO"
}

---