# 4.3.  Đặt lệnh

| **URL**                                                        | **Method** |
| -------------------------------------------------------------- | ---------- |
| <https://services.entrade.com.vn/dnse-order-service/v2/orders> | POST       |

### &#x20;**Resquest header**

<table data-header-hidden><thead><tr><th width="214.33333333333331"></th><th width="177"></th><th></th></tr></thead><tbody><tr><td><strong>Field</strong></td><td><strong>Type</strong></td><td><strong>Description</strong></td></tr><tr><td><strong>Authorization</strong></td><td> </td><td>Bearer &#x3C;JWT token></td></tr><tr><td><strong>Trading-Token</strong></td><td> </td><td>Trading-token lấy ở xác thực bước 2 (Mục 2.2)</td></tr></tbody></table>

### &#x20;**Resquest body**

<table data-header-hidden><thead><tr><th width="212"></th><th width="177.33333333333331"></th><th></th></tr></thead><tbody><tr><td><strong>Field</strong></td><td><strong>Type</strong></td><td><strong>Description</strong></td></tr><tr><td><strong>symbol</strong></td><td>String</td><td>Mã</td></tr><tr><td><strong>side</strong></td><td>String</td><td>Lệnh mua: NB, Lệnh bán:NS</td></tr><tr><td><strong>orderType</strong></td><td>String</td><td>Loại lệnh: LO/MP/MTL/ATO/ATC/MOK/MAK</td></tr><tr><td><strong>price</strong></td><td>Double</td><td>Giá, đơn vị đồng</td></tr><tr><td><strong>quantity</strong></td><td>Double</td><td>Khối lượng đặt</td></tr><tr><td><strong>loanPackageId</strong></td><td>Double</td><td>Mã gói vay, lấy gói vay muốn đặt từ api danh sách gói vay</td></tr><tr><td><strong>accountNo</strong></td><td>String</td><td>Mã tiểu khoản</td></tr></tbody></table>

&#x20;**Response body**

<table data-header-hidden><thead><tr><th width="211"></th><th width="182.33333333333331"></th><th></th></tr></thead><tbody><tr><td><strong>Field</strong></td><td><strong>Type</strong></td><td><strong>Description</strong></td></tr><tr><td><strong>id</strong> </td><td>integer </td><td>Số hiệu lệnh </td></tr><tr><td><strong>side</strong> </td><td>string </td><td><p>Lệnh Mua/Bán thuộc các giá trị sau: </p><p>- NB: Mua </p><p>- NS: Bán </p></td></tr><tr><td><strong>accountNo</strong> </td><td>string </td><td>Số tiểu khoản </td></tr><tr><td><strong>investorId</strong> </td><td>string </td><td>Mã Khách hàng </td></tr><tr><td><strong>symbol</strong> </td><td>string </td><td>Mã chứng khoán </td></tr><tr><td><strong>price</strong> </td><td>number </td><td>Giá đặt </td></tr><tr><td><strong>quantity</strong> </td><td>integer </td><td>Khối lượng đặt </td></tr><tr><td><strong>orderType</strong> </td><td>string </td><td><p>Loại lệnh, thuộc các giá trị sau: </p><p>- LO: lệnh giới hạn </p><p>- MP/MTL: lệnh thị trường </p><p>- ATC/ATO: lệnh khớp phiên định kỳ đóng cửa/mở cửa </p><p>- PLO: lệnh khớp lệnh sau giờ </p></td></tr><tr><td><strong>orderStatus</strong> </td><td>string </td><td><p>Trạng thái lệnh, thuộc các giá trị sau đây: </p><p>- pending: chờ gửi </p><p>- pendingNew: chờ gửi </p><p>- new: chờ khớp </p><p>- partiallyFilled: khớp một phần </p><p>- filled: khớp toàn bộ </p><p>- rejected: bị từ chối </p><p>- expired: bị hết hạn trong phiên </p><p>- doneForDay: lệnh hết hiệu lực khi hết phiên </p><p> </p></td></tr><tr><td><strong>fillQuantity</strong> </td><td>integer </td><td>Khối lượng đã khớp </td></tr><tr><td><strong>lastQuantity</strong> </td><td><p>integer </p><p> </p></td><td>Khối lượng của lần khớp gần nhất của lệnh </td></tr><tr><td><strong>lastPrice</strong> </td><td>number </td><td>Giá khớp của lần khớp gần nhất của lệnh </td></tr><tr><td><strong>averagePrice</strong> </td><td>double </td><td>Giá khớp trung bình của lệnh </td></tr><tr><td><strong>transDate</strong> </td><td>string </td><td><p>Ngày giao dịch, theo định dạng ISO UTC 8601 format date </p><p> </p><p>Ví dụ: 2022-07-15 </p></td></tr><tr><td><strong>createdDate</strong> </td><td>string </td><td><p>Thời điểm (ngày giờ) đặt lệnh, theo định dạng ISO UTC 8601 format datetime </p><p> </p><p>Ví dụ: 2022-07-15T10:00:00.111+07:00 </p></td></tr><tr><td><strong>modifiedDate</strong> </td><td>string </td><td>Thời điểm (ngày giờ) thay đổi cuối cùng của lệnh </td></tr><tr><td><strong>taxRate</strong> </td><td>double </td><td>Tỷ lệ thuế lệnh chịu </td></tr><tr><td><strong>feeRate</strong> </td><td>double </td><td>Tỷ lệ phí lệnh chịu </td></tr><tr><td><strong>leaveQuantity</strong> </td><td>integer </td><td>Khối lượng chưa khớp của lệnh </td></tr><tr><td><strong>canceledQuantity</strong> </td><td>integer </td><td>Khối lượng đã huỷ của lệnh </td></tr><tr><td><strong>priceSecure</strong> </td><td>double </td><td>Giá cọc cho lệnh </td></tr><tr><td><strong>custody</strong> </td><td>string </td><td>Số lưu ký của tiểu khoản đặt lệnh </td></tr><tr><td><strong>channel</strong> </td><td>string </td><td>Kênh đặt lệnh </td></tr><tr><td><strong>loanPackageId</strong> </td><td>integer </td><td>Id gói vay </td></tr><tr><td><strong>initialRate</strong> </td><td>number </td><td>Tỷ lệ ký quỹ theo gói vay tương ứng với lệnh </td></tr><tr><td><strong>error</strong> </td><td>string </td><td><p>Mã lỗi với trạng thái expired </p><p>0: Lệnh MP không có lệnh đối ứng </p><p>Mã lỗi đối với trạng thái lệnh rejected (bị từ chối) bao gồm các mã lỗi: </p><p>QMAX_EXCEED: Vượt quá KL có thể mua/bán </p><p> </p><p>INVALID_QUANTITY_LOT: KL đặt không hợp lệ </p><p> </p><p>PRICE_MUST_GREATER_THAN_OR_EQUAL_TO_FLOOR_PRICE: Giá đặt không hợp lệ </p><p> </p><p>PRICE_MUST_LESS_THAN_OR_EQUAL_TO_CEILING_PRICE: Giá đặt không hợp lệ </p><p> </p><p>INVALID_PRICE_LOT: Giá đặt không hợp lệ </p><p> </p><p>SYMBOL_IS_NOT_IN_MARGIN_BASKET: Mã không nằm trong rổ margin </p><p> </p></td></tr></tbody></table>

{% tabs %}
{% tab title="cURL" %}

<pre><code><strong>curl --location --request POST 'https://services.entrade.com.vn/dnse-order-service/v2/orders' \
</strong>--header 'authorization: Bearer &#x3C;jwt_token_from_login_API_response_step_2.1>' \
--header 'content-type: application/json' \
--header 'trading-token: &#x3C;trading_token_from_step_2.2>' \
--data '{"symbol":"&#x3C;your_symbol>","side":"&#x3C;your_order_side>","orderType":"&#x3C;your_order_type>","price":&#x3C;your_order_price>,"quantity":&#x3C;your_order_quantity>,"loanPackageId":&#x3C;your_order_loan_package>,"accountNo":"&#x3C;your_account>"}'
</code></pre>

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hdsd.dnse.com.vn/san-pham-dich-vu/lightspeed-api-truoc-krx/ii.-trading-api/4.-giao-dich-co-so/4.3.-dat-lenh.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.