Lịch sử phiên bản

Tính năng (API):

• WebSocket API phát hành chính thức — đặt/sửa/hủy lệnh, lệnh điều kiện (FCO) và tra cứu tài khoản (vị thế, sức mua/bán, số dư, sổ lệnh) ngay trên một kết nối WebSocket, kèm đăng ký nhận thông báo lệnh và tài khoản. Yêu cầu scope riêng với prefix tradingws:*:*.
• Batch Order mới — đặt hoặc hủy tối đa 50 lệnh trong một lần gọi, qua REST (trade-order-batch-place, trade-order-batch-cancel) hoặc WebSocket API (order.batchNew, order.batchCancel). Có chống replay (batchRequestTime), idempotency theo batchRequestId và chữ ký trên toàn bộ request.
• Corporate Actions API mới — truy vấn sự kiện quyền của doanh nghiệp (cổ tức, thưởng cổ phiếu, phát hành thêm...) theo mã chứng khoán và khoảng thời gian.
• Topic WebSocket trade.index mới — nhận giá trị chỉ số theo thời gian thực. Subscribe trade.vn30 chỉ trả về các mã thuộc rổ VN30; dùng trade.index.VN30 để nhận giá trị của chính chỉ số. Xem Sub/Unsub Market Data.
• Topic WebSocket indexsummary mới — nhận thông tin tổng hợp của chỉ số theo thời gian thực: giá trị và mức thay đổi, số mã tăng/giảm/đứng giá/trần/sàn, tổng khối lượng và giá trị giao dịch khớp lệnh, thỏa thuận. Cần scope stream:DATA:indexsummary.

SDK:

• Python v3.3.2 (20/10/2026)
• .NET v3.3.2 (20/10/2026)
• Node.js v3.3.2 (20/10/2026)
• Go v3.3.2 (20/10/2026)
• Thay đổi breaking: Trading WebSocket không còn là thử nghiệm và chuyển vào API chính thức của cả 4 SDK. Python: from ssi_sdk.experimental import ... đổi thành from ssi_sdk import .... .NET: using SsiSdk.Experimental; đổi thành using SsiSdk;. Node.js: @ssi.developer/ssi-sdk/experimental đổi thành @ssi.developer/ssi-sdk. Go: package .../v3/experimental đổi thành .../v3/tradingws. Namespace cũ đã bị xóa, không có alias, nên cần sửa lại import khi nâng cấp. Tên hàm, signature và hành vi giữ nguyên.
• Bổ sung Corporate Actions (sự kiện quyền) vào Market Data service của cả 4 SDK (hôm nay và khoảng ngày quá khứ tối đa 5 ngày), xem Corporate Actions API.
• Tutorials: thêm bài 19 — Corporate Actions và cập nhật các sample Trading WebSocket theo import mới.

Portal:

• Bổ sung tài liệu và đặc tả cho WebSocket API, Batch Order, API Corporate Actions và các topic trade.index, indexsummary trên Developer Portal.

Tính năng (API):

• Nâng cấp kênh WebSocket giao dịch — nền tảng cho WebSocket API mới: đặt/sửa/hủy lệnh, lệnh điều kiện (FCO) và tra cứu tài khoản qua WebSocket.
• Kết nối WebSocket được gia hạn tự động khi client gửi ping đều đặn.
• Gửi email thông báo khi kết nối FastConnect API hết hạn.

SDK:

• Python v3.2.1 (27/08/2026)
• .NET v3.2.1 (27/08/2026)
• Node.js v3.2.1 (27/08/2026)
• Go v3.2.1 (27/08/2026) — sửa thiếu field trong SecuritiesSummary

Portal:

• Không có thay đổi Portal trong phiên bản này.

Tính năng (API):

• Hỗ trợ Push OTP Approval.
• Master Data API mới — lấy dữ liệu tham chiếu đầu ngày.

SDK:

• Python v3.2.0 (12/08/2026)
• .NET v3.2.0 (12/08/2026)
• Node.js v3.2.0 (12/08/2026) — cập nhật cơ chế quản lý token
• Go v3.2.0 (12/08/2026)

Portal:

• Thông báo hết hạn dịch vụ và tự động gia hạn khi khách hàng xác nhận.
• Kiểm tra trạng thái hết hạn/tạm ngưng dịch vụ theo điều khoản sử dụng đã đăng ký.
• API Key tự động chuyển trạng thái tạm ngưng nếu không sử dụng trong 3 tháng liên tục.

Tính năng (API):

• Thống nhất mã lỗi (ErrCode) giữa các nhóm API.
• Tách thông báo thay đổi danh mục (portfolio) thành 1 topic WebSocket riêng.
• Tự động chuyển sang truy vấn database khi dữ liệu cache tạm thời không có (cache miss).
• Khắc phục một số lỗi rò rỉ thông tin trong response.
• Chuẩn hóa lại toàn bộ luồng lệnh điều kiện (FCO).
• Ẩn tài khoản đặc biệt khỏi kết quả trả về của API tra cứu thông tin tài khoản.

SDK:

• Python v3.1.1 (28/07/2026)
• .NET v3.1.1 (29/07/2026) — hỗ trợ lệnh điều kiện (FCO)
• Node.js v3.1.1 (29/07/2026)
• Go v3.1.1 (29/07/2026) — hỗ trợ lệnh điều kiện (FCO)

Portal:

• Bổ sung tài liệu và đặc tả API mới nhất trên Developer Portal.
• Thay đổi quyền (scope) hoặc trạng thái API Key được áp dụng ngay cho các kết nối đang mở.
• Thông báo trước 14 ngày khi điều khoản dịch vụ sắp đến hạn gia hạn.
• Cập nhật lại trang đăng ký dịch vụ.
• Trang thông tin tài khoản không còn hiển thị các tài khoản đặc biệt.

Tính năng (API):

• Sửa lỗi: order.amend — cho phép sửa lệnh chỉ bằng orderId.

SDK:

• Python v3.1.0 (21/07/2026) — hỗ trợ lệnh điều kiện (FCO)

Portal:

• Không có thay đổi Portal trong phiên bản này.

Tính năng (API):

• query.position bổ sung tham số querySummary cho tài khoản phái sinh.
• Đặt lệnh phái sinh luôn trả về orderId trong response.
• Khắc phục một số lỗi ở Market Data API và kênh streaming dữ liệu thị trường.

SDK:

• Python v3.0.4 (24/06/2026), v3.0.5 (26/06/2026)
• .NET v3.0.5 (02/07/2026)
• Node.js v3.0.5 (26/06/2026)
• Go v3.0.4 (25/06/2026), v3.0.5 (26/06/2026)

Portal:

• Cập nhật giao diện Portal theo chuẩn thiết kế mới.

Tính năng (API):

• Ra mắt nhóm API Lệnh điều kiện (FCO).
• order.cancel chỉ chấp nhận một trong hai tham số.

SDK:

• Không có bản SDK mới trong giai đoạn này.

Portal:

• Giao diện Developer Portal mới.
• Tự quản lý scope và API Key cá nhân trực tiếp trên Portal.

Tính năng (API):

• Hỗ trợ header Accept-Language (en/vi).
• Bổ sung quy tắc kiểm tra khi sửa lệnh (CBTT).
• Xử lý message khớp lệnh một phần/toàn phần (PF, FF) và portfolio qua streaming.

SDK:

• Không có bản SDK mới trong giai đoạn này.

Portal:

• Ra mắt Developer Portal — tài liệu API, hướng dẫn, SDK, sample code.
• Dựng nền tảng cơ bản cho Developer Portal.

Ngày phát hành: 20/04/2026

Tính năng (API):

• Trading API — đặt/sửa/hủy lệnh, tra cứu tài khoản.
• Market Data API — dữ liệu thị trường, chỉ số, OHLC.
• WebSocket — streaming dữ liệu thị trường và sự kiện giao dịch.
• Tách riêng board DERIVATIVES cho tài khoản phái sinh.

SDK:

• Go v3.0.0 (27/05/2026) — phiên bản đầu tiên

Portal:

• Đăng ký qua link mời, kích hoạt tài khoản kèm xác thực OTP.