Skip to main content
GET
Chi tiết trạng thái lệnh

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
​
orderId
string
bắt buộc

Tham số truy vấn

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

Loại thị trường

  • STOCK: Lệnh cơ sở

  • DERIVATIVE: Lệnh phái sinh

  • BOND: Lệnh trái phiếu 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
Ví dụ:

"STOCK"

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

Phân loại lệnh thường (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,
CONDITIONAL
Ví dụ:

"NORMAL"

Phản hồi

OK

​
id
integer<int32>

ID lệnh

Ví dụ:

1651

​
side
enum<string>

Chiều giao dịch

  • NB: Mua
  • NS: Bán
Tùy chọn có sẵn:
NB,
NS
Ví dụ:

"NB"

​
accountNo
string

Số tiểu khoản

Ví dụ:

"0001179019"

​
symbol
string

Mã chứng khoán

Ví dụ:

"HPG"

​
price
integer<int32>

Giá đặt lệnh

Ví dụ:

24250

​
quantity
integer<int32>

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

Ví dụ:

500

​
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ụ:

5757

​
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ụ:

"PartiallyFilled"

​
fillQuantity
integer<int32>

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

Ví dụ:

200

​
lastQuantity
integer<int32>

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

Ví dụ:

100

​
lastPrice
integer<int32>

Giá khớp gần nhất

Ví dụ:

24250

​
averagePrice
integer<int32>

Giá khớp trung bình

Ví dụ:

24250

​
transDate
string

Ngày giao dịch

Ví dụ:

"2026-07-13"

​
taxRate
integer<int32>

Tỷ lệ thuế

Ví dụ:

0

​
exchangeFeeRate
number<double>

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

Ví dụ:

0.00027

​
feeRate
number<double>

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

Ví dụ:

0.00027

​
leaveQuantity
integer<int32>

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

Ví dụ:

300

​
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: Lệnh cơ sở
  • DERIVATIVE: Lệnh phái sinh
Tùy chọn có sẵn:
STOCK,
DERIVATIVE,
BOND
Ví dụ:

"STOCK"

​
priceSecure
integer<int32>

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

Ví dụ:

24250

​
createdDate
string<date-time>

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

Ví dụ:

"2026-07-13T06:50:36.532741Z"

​
modifiedDate
string<date-time>

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

Ví dụ:

"2026-07-13T06:50:59.052768Z"

​
metadata
string

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

Ví dụ:

"{\"orderSession\":\"OPEN\",\"ip\":\"202.60.110.58\",\"maker\":\"1000005917\",\"isForeigner\":false,\"reqId\":\"24534\",\"probType\":\"CUSTOMER_8000\",\"eventNo\":4.0}"

​
reports
object[]

Danh sách trạng thái lệnh theo từng lần cập nhật

Ví dụ: