Đặt lệnh

POST /accounts/{accountNo}/orders/{orderId}

Đặt lệnh

cURL

curl --request POST \
  --url https://openapi.dnse.com.vn/accounts/{accountNo}/orders/{orderId} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --header 'X-Aux-Date: <x-aux-date>' \
  --header 'X-Signature: <x-signature>' \
  --header 'trading-token: <trading-token>' \
  --data '
{
  "accountNo": "0001179019",
  "loanPackageId": 2278,
  "orderType": "LO",
  "price": 1861.5,
  "quantity": 3,
  "side": "NS",
  "symbol": "41I1G4000"
}
'

200

{
  "id": 1626,
  "symbol": "41I1G4000",
  "side": "NS",
  "orderType": "LO",
  "orderStatus": "Pending",
  "price": 1861.5,
  "averagePrice": 0,
  "quantity": 3,
  "fillQuantity": 0,
  "canceledQuantity": 0,
  "leaveQuantity": 3,
  "accountNo": "0001179019",
  "marketType": "DERIVATIVE",
  "orderCategory": "NORMAL",
  "transDate": "2026-03-16",
  "createdDate": "2026-03-24T04:09:50.761146893Z",
  "modifiedDate": "2026-03-24T04:09:50.761151529Z"
}

Tiêu đề

X-Api-Key · string · bắt buộc

API key được cấp khi đăng ký dịch vụ DNSE OpenAPI. Ví dụ: b3JnOmRuc2UgaWQ6MjdlZTc1MzcxZGFkNTY0NmYzYTM2NDk1ZGE3OGNiOGQgaDptdXJtdXIxMjg=

X-Aux-Date · string · bắt buộc

Thời gian thực hiện request, dùng trong cơ chế ký request của DNSE. Ví dụ: Sat, 01 May 2026 14:24:23 +0000

X-Signature · string · bắt buộc

Chữ ký xác thực request được tạo từ API key secret và X-Aux-Date. Ví dụ: Signature keyId="b3JnOmRuc2UgaWQ6MjdlZTc1MzcxZGFkNTY0NmYzYTM2NDk1ZGE3OGNiOGQgaDptdXJtdXIxMjg=",algorithm="hmac-sha256",headers="(request-target) x-aux-date",signature="rfbVXHDUi%2B%2FsOkLXle7O17Qm%2F05cbISSR%2BDcFrBHfqQ%3D",nonce="4add8c3264e4492b9f8ecde0cf26b523"

trading-token · string · bắt buộc

Trading token dùng cho các operation đặt, sửa, hủy lệnh hoặc đóng vị thế. Ví dụ: 9ab81e9c-8a81-45aa-8190-b69a1c179d52

Tham số đường dẫn

accountNo · string · bắt buộc

Số tiểu khoản

orderId · string · bắt buộc

Mã lệnh giao dịch

Tham số truy vấn

marketType · enum<string> · bắt buộc

Loại thị trường

• STOCK: Đặt lệnh cơ sở

• DERIVATIVE: Đặt lệnh phái sinh Loại thị trường.

• STOCK: Giao dịch cơ sở

• DERIVATIVE: Giao dịch phái sinh

• BOND: Giao dịch trái phiếu

Tùy chọn có sẵn: STOCK, DERIVATIVE, BOND

Ví dụ:

"STOCK"

orderCategory · enum<string> · bắt buộc

Phân loại lệnh thường, lệnh điều kiện (mặc định NORMAL) Phân loại lệnh.

• NORMAL: Lệnh thường
• STOP: Lệnh dừng có điều kiện
• OCO: Lệnh OCO phái sinh
• CONDITIONAL: Lệnh điều kiện

Tùy chọn có sẵn: NORMAL, STOP, OCO, CONDITIONAL

Ví dụ:

"NORMAL"

Nội dung

application/json

accountNo · string

Số tiểu khoản

Ví dụ:

"0001179019"

loanPackageId · integer<int32>

Id gói vay

Ví dụ:

2278

orderType · enum<string>

Loại lệnh

• LO: Lệnh giới hạn
• MOK/MAK/MTL: Lệnh thị trường
• ATO/ATC: Lệnh phiên định kỳ mở cửa/đóng cửa
• PLO: Lệnh khớp lệnh sau giờ

Tùy chọn có sẵn: LO, MOK, MAK, MTL, ATO, ATC, PLO

Ví dụ:

"LO"

price · number<double>

Giá đặt lệnh

Ví dụ:

35000

quantity · integer<int32>

Khối lượng đặt lệnh

Ví dụ:

300

side · enum<string>

Loại lệnh

• NB: Mua
• NS: Bán

Tùy chọn có sẵn: NB, NS

Ví dụ:

"NB"

symbol · string

Mã chứng khoán

Ví dụ:

"TCB"

Phản hồi

200

application/json

OK

id · integer<int32>

Id lệnh giao dịch

Ví dụ:

1626

symbol · string

Mã chứng khoán

Ví dụ:

"41I1G4000"

side · enum<string>

Chiều đặt lệnh NB: Mua NS: Bán

Tùy chọn có sẵn: NB, NS

Ví dụ:

"NS"

orderType · enum<string>

Loại lệnh

• LO: Lệnh giới hạn
• MOK/MAK/MTL: Lệnh thị trường
• ATO/ATC: Lệnh phiên định kỳ mở cửa/đóng cửa
• PLO: Lệnh khớp lệnh sau giờ

Tùy chọn có sẵn: LO, MOK, MAK, MTL, ATO, ATC, PLO

Ví dụ:

"LO"

orderStatus · enum<string>

Trạng thái lệnh

• PendingNew: Chờ gửi
• New: Chờ khớp
• PendingReplace: Chờ sửa
• PartiallyFilled: Khớp một phần
• Filled: Khớp toàn bộ
• Canceled: Đã hủy
• Rejected: Bị từ chối
• Expired: Hết hạn trong phiên
• DoneForDay: Giải tỏa trong phiên

Tùy chọn có sẵn: Pending, PendingNew, New, PendingReplace, PendingCancel, PartiallyFilled, Filled, Canceled, Rejected, Expired, DoneForDay

Ví dụ:

"Pending"

price · number<double>

Giá đặt

Ví dụ:

1861.5

averagePrice · integer<int32>

Giá khớp trung bình

Ví dụ:

0

quantity · integer<int32>

Khối lượng đặt

Ví dụ:

3

fillQuantity · integer<int32>

Khối lượng khớp

Ví dụ:

0

canceledQuantity · integer<int32>

Khối lượng đã hủy

Ví dụ:

0

leaveQuantity · integer<int32>

Khối lượng còn lại

Ví dụ:

3

accountNo · string

Số tiểu khoản

Ví dụ:

"0001179019"

marketType · enum<string>

Loại thị trường

• STOCK: Lệnh cơ sở
• DERIVATIVE: Lệnh phái sinh

Tùy chọn có sẵn: STOCK, DERIVATIVE, BOND

Ví dụ:

"DERIVATIVE"

orderCategory · enum<string>

Phân loại lệnh thường (mặc định NORMAL)

Tùy chọn có sẵn: NORMAL, STOP, OCO, CONDITIONAL

Ví dụ:

"NORMAL"

transDate · string

Ngày giao dịch

Ví dụ:

"2026-03-16"

createdDate · string<date-time>

Thời điểm tạo

Ví dụ:

"2026-03-24T04:09:50.761146893Z"

modifiedDate · string<date-time>

Thời điểm cập nhật

Ví dụ:

"2026-03-24T04:09:50.761151529Z"