Lịch sử đặt lệnh

​

Endpoint

GET /oapi/accounts/:accountId/derivative/orderHistory

​

Tham số đường dẫn yêu cầu

• accountId — Mã tài khoản giao dịch.

​

Tham số truy vấn được hỗ trợ

• fromDate — Ngày bắt đầu theo định dạng DD/MM/YYYY. Ví dụ: 16/03/2026.
• toDate — Ngày kết thúc theo định dạng DD/MM/YYYY. Ví dụ: 20/03/2026.
• symbol — Mã chứng khoán. Ví dụ: VIC.
• orderType — Loại lệnh. Ví dụ: LO.
• status — Trạng thái lệnh. Ví dụ: SR.

​

Trường phản hồi

• s (string) — Trạng thái request. Ví dụ: ok.
• d (array) — Danh sách các dòng báo cáo lệnh.

​

Trường báo cáo

• custodycd (string) — Mã tài khoản lưu ký.
• accountno (string) — Số tài khoản giao dịch.
• orderid (string) — Mã lệnh.
• code (string) — Mã sản phẩm.
• lastchange (string) — Thời gian cập nhật gần nhất.
• subside (string) — Mã chiều lệnh.
• side_desc (string) — Mô tả chiều lệnh.
• subtypecd (string) — Mã loại giá.
• ordertype_desc (string) — Mô tả loại giá.
• validity (string) — Giá trị hiệu lực.
• dataval (string) — Giá trị dữ liệu.
• status (string) — Trạng thái lệnh.
• orderqtty (number) — Số lượng đặt.
• orderprice (number) — Giá lệnh.
• matchprice (number) — Giá khớp.
• matchqtty (number) — Khối lượng khớp.
• odsent (string) — Thời gian gửi lệnh.
• execamt (number) — Giá trị đã khớp.
• remain_qtty (number) — Khối lượng còn lại.
• cancel_qtty (number) — Khối lượng đã hủy.
• admend_qtty (number) — Khối lượng đã sửa.
• confirmid (string) — Mã xác nhận từ sàn.
• originorderid (string) — Mã lệnh gốc.
• txdate (string) — Ngày request.
• feeamt (number) — Số tiền phí.
• tax (number) — Số tiền thuế.
• tradingfee (number) — Tỷ lệ phí theo phần trăm.
• via (string) — Kênh đặt lệnh.
• norp (string) — Cờ giao dịch thỏa thuận.

​

cURL

curl -G "$BASE_URL/oapi/accounts/$ACCOUNT_ID/derivative/orderHistory" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data-urlencode "fromDate=16/03/2026" \
  --data-urlencode "toDate=20/03/2026"

​

Ví dụ phản hồi

{
    "s": "ok",
    "d": [
        {
            "custodycd": "022C979999",
            "accountno": "0104005401",
            "orderid": "0001020326028362",
            "code": "41I1G9000",
            "lastchange": "14:56:15",
            "subside": "NB",
            "side_desc": "Mua",
            "subtypecd": "LO",
            "ordertype_desc": "LO",
            "validity": "Y",
            "dataval": "",
            "status": "TS",
            "orderqtty": 1,
            "orderprice": 1795,
            "matchprice": 1795,
            "matchqtty": 1,
            "odsent": "14:49:52",
            "execamt": 179500000,
            "remain_qtty": 0,
            "cancel_qtty": 0,
            "admend_qtty": 0,
            "confirmid": null,
            "originorderid": "0001020326028362",
            "txdate": "20/03/2026",
            "feeamt": 4500,
            "tax": 0,
            "tradingfee": 0.15,
            "via": "R",
            "norp": "N"
        }
    ]
}

Thay BASE_URL, ACCOUNT_ID, và ACCESS_TOKEN bằng giá trị của bạn.