> ## Documentation Index > Fetch the complete documentation index at: https://hoalulab.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Nhật ký thay đổi ### 🚀 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. ### 🚀 Added * **\[REST API]**: Thêm endpoint mới * **GET Loans (Danh sách khoản vay)**: Lấy danh sách các khoản vay trên tiểu khoản, hiện tại áp dụng cho giao dịch cơ sở (STOCK) * **Reverse Position (Đảo vị thế)**: Đóng toàn bộ vị thế phái sinh hiện tại và mở ngay vị thế mới theo hướng ngược lại, chỉ áp dụng cho phái sinh (DERIVATIVE) ### 🧩 Update * Cập nhật **Get Instruments (Chi tiết mã chứng khoán)** * Bổ sung Endpoint mới `POST /market/instruments` ### 🚀 Added * **\[REST API]**: Thêm endpoint mới * **GET PNL Configs Account (Cấu hình chốt lời, cắt lỗ của tiểu khoản)**: Lấy cấu hình chốt lời, cắt lỗ của tiểu khoản (`accountNo`), chỉ áp dụng cho phái sinh (DERIVATIVE) * **PATCH PNL Configs Account (Cài đặt chốt lời, cắt lỗ cho tiểu khoản)**: Cài đặt chốt lời, cắt lỗ cho tiểu khoản (`accountNo`), chỉ áp dụng cho phái sinh (DERIVATIVE) * **GET Market Index (Lịch sử chỉ số)**: Lấy dữ liệu lịch sử các chỉ số thị trường * **\[WEBSOCKET]** * Thêm function mới: **Top cổ phiếu ảnh hưởng chỉ số (Market Index Influence)**: Cung cấp dữ liệu thống kê top các cổ phiếu có mức độ ảnh hưởng tới các chỉ số thị trường theo từng khung thời gian xác định ### 🧩 Update * **\[REST API]**: * Cập nhật **GET order detail (Chi tiết lệnh theo Id)**: Hỗ trợ truy vấn chi tiết lệnh dừng có điều kiện (`STOP`) và lệnh OCO ### 🚀 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 ### 🚀 Added * **\[REST API]** Thêm Endpoint mới **Get Expected Price (Giá dự khớp)**: Truy vấn thông tin giá dự khớp của mã chứng khoán trong phiên khớp lệnh định kỳ. ### 🧩 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`): * **GET Loan Package (Gói vay)** : Hỗ trợ truy vấn gói vay đặt lệnh Trái phiếu * **GET PPSE (Sức mua/sức bán)**: Hỗ trợ truy vấn sức mua đặt lệnh Trái phiếu * **PUT Orders (Sửa lệnh)**: Hỗ trợ sửa lệnh thường Trái phiếu * 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: | orderCategory | NORMAL | STOP | OCO | | - | :-: | :-: | :-: | | STOCK (cơ sở) | ✅ | ✅ | ❌ | | DERIVATIVE (phái sinh) | ✅ | ✅ | ✅ | | BOND (trái phiếu) | ✅ | ❌ | ❌ | * 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](https://github.com/dnse-tech/openapi-sdk) phiên bản **2.0.0** trở lên. ::: ### 🧩 Update * \[REST API] Cập nhật endpoint **Executions (Chi tiết trạng thái lệnh)** * Hỗ trợ chi tiết trạng thái lệnh cổ phiếu với `marketType` = `STOCK` ### 🚀 Added * \[REST API] Thêm Endpoint mới **Get Session (Thông tin phiên)**: Truy vấn thông tin phiên giao dịch. * \[WEBSOCKET] Thêm function mới: * **Postion Event for Broker (Dữ liệu vị thế của tài khoản khách hàng theo thời gian thực)** : Cung cấp thông tin chi tiết về vị thế trên tài khoản khách hàng thuộc quyền quản lý theo thời gian thực cho người dùng là Môi giới tại DNSE. * **Session (Thông tin phiên)** : Cung cấp thông tin chi tiết về phiên giao dịch hiện tại. ### 🚀 Added * \[REST API] Thêm Endpoint mới **Get Foreign Trading (Dữ liệu NĐT nước ngoài)**: Truy vấn thông tin dữ liệu nhà đầu tư nước ngoài. ### 🛠️ Maintenance * \[Websocket] Sửa lỗi xử lý kết nối và cải thiện độ ổn định. ### 🧩 Update * \[WEBSOCKET] Thêm function mới: * **Order Event for Broker (Dữ liệu lệnh của tài khoản khách hàng theo thời gian thực)** : Cung cấp thông tin chi tiết về lệnh giao dịch trên tài khoản khách hàng thuộc quyền quản lý theo thời gian thực cho người dùng là Môi giới tại DNSE. * **Estimate VN30 Data (Dữ liệu chỉ số VN30 dự tính)** : Cung cấp thông tin dữ liệu về chỉ số VN30 dự tính trong phiên giao dịch. ### 🚀 Added * \[REST API] Thêm Endpoint mới: * **Get PNL Configs (Cấu hình chốt lời, cắt lỗ của vị thế)** : Trả ra cấu hình cài đặt chốt lời, cắt lỗ của vị thế đang nắm giữ. * **Post PNL Configs (Cài đặt cấu hình chốt lời, cắt lỗ cho vị thế)** : Cài đặt cấu hình cài đặt chốt lời, cắt lỗ cho vị thế đang nắm giữ. ### 🧩 Update * \[REST API] Cập nhật endpoint **Get list care by** * Response trả thêm `investorId` ### 🚀 Added * \[REST API] Thêm Endpoint mới: * **Get Corporate Action History (Lịch sử sự kiện quyền)** : Trả ra danh sách sự kiện quyền chứng khoán trên tài khoản khách hàng. * **Get Latest Quotes (Dữ liệu bid/ask gần nhất)** : Trả ra dữ liệu chào mua, chào bán gần nhất của mã chứng khoán * **Get Quotes (Lịch sử bid/ask)** : Trả ra lịch sử chào mua, chào bán của mã chứng khoán. ### 🧩 Update * \[REST API] Cập nhật endpoint **Get PPSE (Sức mua, sức bán)** * Response trả thêm `pp0Buy`, `pp0Short` ### 🧩 Update * \[REST API] Cập nhật endpoint **Get Secdef (Thông tin giao dịch chứng khoán)** * Response trả thêm `time` (định dạng `yyyy-MM-dd'T'HH:mm:ss.SSS | UTC+7`) * \[REST API] Cập nhật trường `time` trong response của các endpoint **Get Close Price (Giá đóng cửa)**, **Get Trades (Lịch sử khớp lệnh)**, **Get Latest Trades (Dữ liệu khớp gần nhất)** * Thay đổi timezone từ `UTC` sang `UTC+7` * Bổ sung độ chính xác đến milliseconds (`yyyy-MM-dd'T'HH:mm:ss.SSS`) ### 🛠️ Maintenance * \[Websocket] Sửa lỗi xử lý kết nối và cải thiện độ ổn định. ### 🚀 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 * \[REST API] Cập nhật endpoint **Get Positions (Vị thế nắm giữ)** * Response trả thêm `averageClosePrice` ### 🛠️ 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 ### 🚀 Added * \[REST API] Thêm Endpoint mới: * **/Get list care by (Danh sách tiểu khoản quản lý)** : Trả ra danh sách tiểu khoản giao dịch thuộc quyền quản lý của người dùng là Môi giới/SACO tại DNSE. * \[Websocket] Thêm function mới: * **Order Event (Dữ liệu lệnh thời gian thực)** : Cung cấp thông tin chi tiết về lệnh giao dịch trên tài khoản người dùng theo thời gian thực. ### 🚀 Added * \[REST API] Thêm Endpoint mới: * **Working Dates (Ngày làm việc)**: Trả ra danh sách ngày làm việc trong vòng 1 năm tính từ ngày hiện tại. ### 🧩 Update * \[Websocket] Function **Security Definition (Thông tin giao dịch chứng khoán)** * Payload trả thêm `listingDate`, `finalTradeDate` * \[REST API] Cập nhật endpoint **Thông tin giao dịch chứng khoán** * Response trả thêm `listingDate`, `finalTradeDate` ### 🚀 Added * \[Websocket] Thêm function mới: * **OHLC Closed (OHLC đóng nến)**: Cung cấp dữ liệu nến đã đóng theo từng khung thời gian. * **Foreign Investor (Giao dịch nhà đầu tư nước ngoài)**: Cung cấp dữ liệu giao dịch của nhà đầu tư nước ngoài theo từng mã chứng khoán. * \[REST API] Thêm Endpoint mới: * **Executions (Chi tiết trạng thái lệnh)**: Trả về lịch sử các lần cập nhật trạng thái hay khớp từng phần của một lệnh giao dịch, áp dụng cho phái sinh. * **Close Price (Giá đóng cửa)**: Trả về dữ liệu giá đóng cửa của mã chứng khoán ### 🧩 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.