Chi tiết lệnh theo ID

Lấy thông tin chi tiết của một lệnh thường (NORMAL) theo orderId, bao gồm trạng thái, khối lượng, giá và các thông tin liên quan.

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

Chi tiết lệnh theo ID

cURL

curl --request GET \
  --url https://openapi-uat.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>' \
  --header 'version: <version>'

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ụ

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

Thời gian thực hiện yêu cầu

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

Chữ ký xác thực yêu cầu

version · string<date> · bắt buộc

API version (YYYY-MM-DD)

Tham số đường dẫn

accountNo · string · bắt buộc

Số tiểu khoản

orderId · integer · bắt buộc

Mã lệnh giao dịch

Tham số truy vấn

marketType · string · bắt buộc

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

orderCategory · 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 hồi

200

application/json

OK

id · integer<int32>

ID lệnh

Ví dụ:

966

side · string

Chiều giao dịch

• NB: Mua
• NS: Bán

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 · 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ờ

Ví dụ:

"LO"

loanPackageId · integer<int32>

Mã gói vay

Ví dụ:

2278

orderCategory · string

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

Ví dụ:

"NORMAL"

orderStatus · 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

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 · string

Loại thị trường

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

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}"