Sửa lệnh

PUT /accounts/{accountNo}/orders/{orderId}

Sửa lệnh

cURL

curl --request PUT \
  --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 '
{
  "price": 1851,
  "quantity": 3
}
'

200

{
  "id": 1626,
  "accountNo": "0001179019",
  "side": "NS",
  "loanPackageId": 2278,
  "symbol": "41I1G4000",
  "orderType": "LO",
  "orderCategory": "NORMAL",
  "price": 1851,
  "quantity": 3,
  "fillQuantity": 0,
  "canceledQuantity": 0,
  "marketType": "DERIVATIVE",
  "transDate": "2026-03-16",
  "createdDate": "2026-03-24T04:09:50.761146893Z",
  "modifiedDate": "2026-03-24T04:14:21.004856492Z"
}

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: Gói vay giao dịch cơ sở

• DERIVATIVE: Gói vay giao dịch 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

price · number<double>

Giá mới cho lệnh LO

• Đối với lệnh cơ sở, có thể sửa cả giá và khối lượng
• Đối với lệnh phái sinh, chỉ được sửa hoặc giá hoặc khối lượng

Ví dụ:

1851

quantity · integer<int32>

Khối lượng mới

• Đối với lệnh phái sinh, khối lượng mới phải lớn hơn khối lượng đã khớp (nếu có) của lệnh đã đặt

Ví dụ:

3

Phản hồi

200

application/json

OK

id · integer<int32>

Id lệnh giao dịch

Ví dụ:

1626

accountNo · string

Số tiểu khoản

Ví dụ:

"0001179019"

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"

loanPackageId · integer<int32>

Mã gói vay

Ví dụ:

2278

symbol · string

Mã chứng khoán

Ví dụ:

"41I1G4000"

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"

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"

price · number<double>

Giá đặt

Ví dụ:

1851

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

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"

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:14:21.004856492Z"