MXV

Đặt lệnh mới

post/mxv/orders

Request

Query parameters

accountType0 | 1 | 2

(0 = FUTURE, 1 = NANO, 2 = MXV)

Request body

symbolstring required

Mã hợp đồng (VD: CP2COH25)

sidestring required

Phía giao dịch: 1 = Mua, 2 = Bán

quantityinteger required

Số lượng lệnh (phải > 0)

orderTypestring

Loại lệnh: 1 = Thị trường, 2 = Giới hạn, 3 = Dừng, 4 = Dừng-Giới hạn. Mặc định: 2

timeInForcestring

Thời gian hiệu lực của lệnh đặt: 0 = Trong ngày, 1 = GTC (Cho đến khi hủy), 6 = GTD (Cho đến ngày). Mặc định: 0

pricenumber double

Giá (bắt buộc cho lệnh GIỚI HẠN và DỪNG-GIỚI HẠN)

stopPricenumber double

Giá dừng (bắt buộc cho lệnh DỪNG và DỪNG-GIỚI HẠN)

expireDatestring

Ngày hết hạn theo định dạng YYYYMMDD (bắt buộc cho lệnh GTD)

Response

OK

successboolean

Indicates if the operation was successful

cl_ord_idstring

ClOrdID (Client Order ID: ID tạo bởi TVKD)

order_idstring

OrderID (ID tạo bởi sàn)

messagestring

Success message

errorstring

Câu lỗi DÀNH CHO KHÁCH HÀNG (app hiện nguyên văn). Lấy từ MXVUserMessages hoặc từ FIX service (đã là câu tiếng Việt cho KH từ 23/09/2026). Không bao giờ chứa mã tag FIX, mã HTTP, exception.

error_detailstring

Nguyên văn kỹ thuật (tag 58 của Sở, lý do FIX service tự chặn, body lỗi HTTP…). Đọc được từ FIX service nhưng KHÔNG serialize ra app — chỉ ghi Event Log để đối soát.

Changes

No recorded changes to this operation across all 5 revisions of this API.