Skip to main content
​
Thêm POST Handoff Smart OTP và GET Volume Profile

​
🚀 Added

  • [REST API]: Thêm endpoint mới
    • POST Handoff Smart OTP: Gửi yêu cầu nhận mã Smart OTP qua hình thức xác thực trên app DNSE, chỉ áp dụng cho các tài khoản đang sử dụng phương thức xác thực lớp thứ hai là Smart OTP. Thông báo xác nhận chỉ gửi về thiết bị đăng ký Smart OTP của tài khoản.
    • GET Volume Profile (Lịch sử khớp lệnh theo bước giá): Thống kê khối lượng mua và bán chủ động tại từng mức giá trong ngày giao dịch.
​
Thêm GET Loans và Reverse Position; bổ sung POST /market/instruments

​
🚀 Added

  • [REST API]: Thêm endpoint mới

​
🧩 Update

​
Thêm PNL Configs cho tiểu khoản, Market Index, và Top cổ phiếu ảnh hưởng chỉ số qua WebSocket

​
🚀 Added

​
🧩 Update

​
Ra mắt SANDBOX tách biệt; nâng giới hạn WebSocket lên 10 connections và 200 streams

​
🚀 Added

  • [SANDBOX]: Ra mắt môi trường thử nghiệm tách biệt cho OpenAPI DNSE — cho phép người dùng và đối tác tích hợp kiểm thử toàn bộ luồng giao dịch mà không ảnh hưởng đến tài khoản thực. Base URL Sandbox: https://sb-openapi.dnse.com.vn Chi tiết hướng dẫn tại đây

​
🧩 Update

  • [WEBSOCKET] Cập nhật giới hạn kết nối: Tối đa 10 connections/user và 200 streams/connection
​
Thêm Get Expected Price; mở rộng giao dịch Trái phiếu; Breaking Changes API version 2026-07-23

​
🚀 Added

​
🧩 Update

[REST API]
  • Cập nhật GET account balances (Thông tin tiền):
    • Response trả thêm bond.totalValue, egg.totalValue
  • Cập nhật các Endpoint mở rộng giao dịch Trái phiếu (marketType=BOND):
  • Cập nhật POST Order (Đặt lệnh)
    • Bổ sung Endpoint mới POST /accounts/{accountNo}/orders
    • Endpoint mới mở rộng hỗ trợ các loại lệnh:
    • Endpoint cũ POST /accounts/orders tiếp tục hoạt động đầy đủ và không bị ảnh hưởng, chỉ hỗ trợ lệnh thường cơ sở và lệnh thường phái sinh.
  • Cập nhật GET Position by Id (Chi tiết vị thế theo ID)
    • Bổ sung Endpoint mới GET /positions/{positionId}
    • Endpoint cũ GET /accounts/positions/{positionId} tiếp tục được hỗ trợ để đảm bảo tương thích ngược.
  • Cập nhật GET PNL Configs (Cấu hình chốt lời, cắt lỗ của vị thế)
    • Bổ sung Endpoint mới GET /positions/{positionId}/pnl-configs
    • Endpoint cũ GET /accounts/positions/{positionId}/pnl-configs tiếp tục được hỗ trợ để đảm bảo tương thích ngược.
  • Cập nhật POST PNL Configs (Cài đặt chốt lời, cắt lỗ của vị thế)
    • Bổ sung Endpoint mới POST /positions/{positionId}/pnl-configs
    • Endpoint cũ POST /accounts/positions/{positionId}/pnl-configs tiếp tục được hỗ trợ để đảm bảo tương thích ngược.
  • Cập nhật POST Close Position (Đóng vị thế)
    • Bổ sung Endpoint mới POST /positions/{positionId}/close
    • Endpoint cũ POST /accounts/positions/{positionId}/close tiếp tục được hỗ trợ để đảm bảo tương thích ngược. :::warning[Khuyến nghị tích hợp] Người dùng nên tích hợp Endpoint mới để sử dụng các tính năng mới được cập nhật. :::

​
🚨 Breaking Changes

[REST API] API version: 2026-07-23
  • Cập nhật endpoint DELETE Orders (Hủy lệnh)
    • Hỗ trợ hủy lệnh thường Trái phiếu (truyền marketType=BOND và orderCategory=NORMAL)
    • Hỗ trợ hủy lệnh STOP Cơ sở và Phái sinh (orderCategory=STOP)
    • Hỗ trợ hủy lệnh OCO Phái sinh (orderCategory=OCO)
    • Trường orderId trong Request và Response thay đổi kiểu dữ liệu từ integer → string
  • Cập nhật endpoint GET Orders (Sổ lệnh)
    • Request yêu cầu truyền pageIndex, pageSize
    • Response trả thêm thông tin phân trang
    • Hỗ trợ truy vấn sổ lệnh thường Trái phiếu (truyền marketType=BOND và orderCategory=NORMAL)
    • Hỗ trợ truy vấn sổ lệnh STOP Cơ sở và Phái sinh (orderCategory=STOP)
    • Hỗ trợ truy vấn sổ lệnh OCO Phái sinh (orderCategory=OCO)
    • Trường orderId trong response thay đổi kiểu dữ liệu từ integer → string
  • Cập nhật endpoint GET Order Detail (Chi tiết lệnh theo ID)
    • Hỗ trợ truy vấn chi tiết lệnh thường Trái phiếu (truyền marketType=BOND và orderCategory=NORMAL)
    • Response bỏ trường reports :::warning[Khuyến nghị tích hợp] Để sử dụng các tính năng mới, client cần nâng cấp lên API version: 2026-23-07 và chú ý cập nhật logic parse orderId sang string.
      Client giữ nguyên Header version cũ hoặc không truyền Header version sẽ vẫn tiếp tục được hỗ trợ tính năng cũ và không bị ảnh hưởng.
      Hoặc dử dụng DNSE sample SDK phiên bản 2.0.0 trở lên. :::
​
Executions hỗ trợ chi tiết trạng thái lệnh cổ phiếu (STOCK)

​
🧩 Update

​
Thêm Get Session và Position Event for Broker qua WebSocket

​
🚀 Added

​
Thêm Get Foreign Trading; sửa lỗi kết nối WebSocket

​
🚀 Added

​
🛠️ Maintenance

  • [Websocket] Sửa lỗi xử lý kết nối và cải thiện độ ổn định.
​
Thêm Order Event for Broker và Estimate VN30 Data qua WebSocket

​
🧩 Update

​
Thêm PNL Configs cho vị thế; bổ sung investorId vào Get list care by

​
🚀 Added

​
🧩 Update

  • [REST API] Cập nhật endpoint Get list care by
    • Response trả thêm investorId
​
Thêm Corporate Action History và Quotes (latest & history); bổ sung pp0Buy, pp0Short vào Get PPSE

​
🚀 Added

​
🧩 Update

​
Chuẩn hóa timezone sang UTC+7, thêm milliseconds; sửa lỗi WebSocket

​
🧩 Update

​
🛠️ Maintenance

  • [Websocket] Sửa lỗi xử lý kết nối và cải thiện độ ổn định.
​
Áp dụng API Versioning; thêm Position Event; bổ sung averageClosePrice

​
🚀 Added

  • [PLATFORM] API Versioning Chính thức áp dụng cơ chế quản lý phiên bản API cho OpenAPI theo định dạng date-based versioning. Tham khảo chi tiết tại API Versioning
  • [WEBSOCKET] Thêm function mới: Position Event (Dữ liệu vị thế thời gian thực) : Cung cấp thông tin chi tiết về vị thế đang nắm giữ trên tài khoản người dùng theo thời gian thực.

​
🧩 Update

​
🛠️ Maintenance

  • [Websocket] Sửa lỗi xử lý dữ liệu, tối ưu hiệu năng và cải thiện độ ổn định
​
Thêm Get list care by (Môi giới/SACO) và Order Event qua WebSocket

​
🚀 Added

​
Thêm Working Dates; bổ sung listingDate, finalTradeDate vào Secdef

​
🚀 Added

​
🧩 Update

​
Thêm OHLC Closed, Foreign Investor, Executions, Close Price; Breaking Changes WebSocket (snake_case → camelCase)

​
🚀 Added

​
🧩 Update

  • [REST API] Cập nhật endpoint Thông tin tiền
    • Response trả thêm secureAmount, orderSecured

​
🚨 Breaking Changes

  • [Websocket] Cấu trúc dữ liệu trả về được thay đổi từ snake_case (VD: board_id) sang camelCase (VD: boardId)
    • Áp dụng cho các trường trong dữ liệu WebSocket - Client cần cập nhật lại mapping các trường theo định dạng mới
  • [Websocket] Một số trường enum được thay đổi kiểu dữ liệu từ integer (VD:board_Id: 2, 5, 9) sang string (VD: boarId: G1, G4, T1). - Áp dụng cho nhiều trường trong các payload WebSocket - Client cần cập nhật logic parse dữ liệu tương ứng
  • Cập nhật định nghĩa enum
    • Tham khảo trang Enum Market Data để xem giá trị và format mới nhất.