Chi tiết lệnh theo ID

Lấy thông tin chi tiết lệnh theo orderId, bao gồm lệnh thường (NORMAL), lệnh dừng có điều kiện (STOP) và lệnh OCO.

GET /accounts/{accountNo}/orders/{orderId}

Chi tiết lệnh theo ID

cURL

curl --request GET \
  --url https://openapi.dnse.com.vn/accounts/{accountNo}/orders/{orderId} \
  --header 'X-Api-Key: <x-api-key>' \
  --header 'X-Aux-Date: <x-aux-date>' \
  --header 'X-Signature: <x-signature>'

200

{
  "id": "966",
  "side": "NS",
  "accountNo": "0001179019",
  "symbol": "41I1G4000",
  "price": 1706.1,
  "quantity": 5,
  "orderType": "LO",
  "loanPackageId": 2278,
  "orderCategory": "NORMAL",
  "orderStatus": "Filled",
  "fillQuantity": 5,
  "lastQuantity": 2,
  "lastPrice": 1706.1,
  "averagePrice": 1750.96,
  "transDate": "2026-03-16",
  "taxRate": 0,
  "exchangeFeeRate": 0,
  "feeRate": 0,
  "leaveQuantity": 0,
  "canceledQuantity": 0,
  "error": "",
  "marketType": "DERIVATIVE",
  "priceSecure": 1706.1,
  "createdDate": "2026-03-23T03:10:06.556826794Z",
  "modifiedDate": "2026-03-23T04:07:45.683977124Z",
  "metadata": "{\"orderSession\":\"OPEN\",\"dealId\":\"1.77410795472387E14\",\"releaseSecureOnFilled\":\"false\",\"originMaker\":\"1000005917-close_deal_177410795472387\",\"dtaAccountNo\":\"D000113702\",\"isForeigner\":false,\"probType\":\"CUSTOMER\",\"eventNo\":5}"
}

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"

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: Sổ lệnh cơ sở

• DERIVATIVE: Sổ 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"

Phản hồi

200

application/json

OK

id · string

ID lệnh

Ví dụ:

"966"

side · enum<string>

Chiều giao dịch

• NB: Mua
• NS: Bán

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

Ví dụ:

"NS"

accountNo · string

Số tiểu khoản

Ví dụ:

"0001179019"

symbol · string

Mã hợp đồng phái sinh

Ví dụ:

"41I1G4000"

price · number<double>

Giá đặt lệnh

Ví dụ:

1706.1

quantity · integer<int32>

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

Ví dụ:

5

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"

loanPackageId · integer<int32>

Mã gói vay

Ví dụ:

2278

orderCategory · enum<string>

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

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

Ví dụ:

"NORMAL"

orderStatus · enum<string>

Trạng thái lệnh

• Pending/PendingNew: Chờ gửi
• New: Chờ khớp
• PartiallyFilled: Khớp một phần
• Filled: Khớp toàn bộ
• Rejected: Bị từ chối
• Expired: Hết hạn trong phiên
• DoneForDay: Lệnh được giải tỏa do không khớp trong phiên

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

Ví dụ:

"Filled"

fillQuantity · integer<int32>

Khối lượng đã khớp

Ví dụ:

5

lastQuantity · integer<int32>

Khối lượng khớp gần nhất

Ví dụ:

2

lastPrice · number<double>

Giá khớp gần nhất

Ví dụ:

1706.1

averagePrice · number<double>

Giá khớp trung bình

Ví dụ:

1750.96

transDate · string

Ngày giao dịch

Ví dụ:

"2026-03-16"

taxRate · integer<int32>

Tỷ lệ thuế

Ví dụ:

0

exchangeFeeRate · integer<int32>

Tỷ lệ phí trả Sở giao dịch

Ví dụ:

0

feeRate · integer<int32>

Tổng tỷ lệ phí của lệnh

Ví dụ:

0

leaveQuantity · integer<int32>

Khối lượng còn lại chưa khớp

Ví dụ:

0

canceledQuantity · integer<int32>

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

Ví dụ:

0

error · string

Mã lỗi nếu lệnh bị từ chối

Ví dụ:

""

marketType · enum<string>

Loại thị trường

• STOCK: Sổ lệnh cơ sở
• DERIVATIVE: Sổ lệnh phái sinh

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

Ví dụ:

"DERIVATIVE"

priceSecure · number<double>

Giá dùng để kiểm tra sức mua/đặt lệnh

Ví dụ:

1706.1

createdDate · string<date-time>

Thời điểm tạo lệnh

Ví dụ:

"2026-03-23T03:10:06.556826794Z"

modifiedDate · string<date-time>

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

Ví dụ:

"2026-03-23T04:07:45.683977124Z"

metadata · string

Thông tin bổ sung của lệnh

Ví dụ:

"{\"orderSession\":\"OPEN\",\"dealId\":\"1.77410795472387E14\",\"releaseSecureOnFilled\":\"false\",\"originMaker\":\"1000005917-close_deal_177410795472387\",\"dtaAccountNo\":\"D000113702\",\"isForeigner\":false,\"probType\":\"CUSTOMER\",\"eventNo\":5}"