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ụ

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>

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

Id lệnh giao dịch

Tham số truy vấn

marketType
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
orderCategory
string
bắt buộc

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

Phản hồi

OK

id
integer<int32>

ID lệnh

Ví dụ:

1651

side
string

Chiều giao dịch

  • NB: Mua
  • NS: Bán
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
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ụ:

5757

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

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

Loại thị trường

  • STOCK: Lệnh cơ sở
  • DERIVATIVE: Lệnh phái sinh
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ụ: