> For the complete documentation index, see [llms.txt](https://hdsd.dnse.com.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hdsd.dnse.com.vn/san-pham-dich-vu/ami-x/cac-cau-lenh-api-de-dat-lenh-qua-ami-x/1.-huong-dan-chi-tiet-cac-cau-lenh.md).

# 1. Hướng dẫn chi tiết các câu lệnh

### + **Câu lệnh mẫu lấy giá theo ceiling/floor/reference**

* <http://localhost:7979/trade?side=NB&symbol=VN30F1M&price=>{ceiling/floor/reference}

### + **Đặt lệnh LO:**

* **Lệnh Long**:&#x20;
  * [http://localhost:7979/trade?side=NB\&symbol=VN30F1M\&price=1300\&account=0001177065\&loan=2403\&volume=1](http://localhost:7979/trade?side=NB\&symbol=VN30F2407\&price=1300\&account=0001177065\&loan=2403\&volume=1)
* **Lệnh Short**:&#x20;
  * [http://localhost:7979/trade?side=NS\&symbol=VN30F1M\&price=1300\&account=0001177065\&loan=2403\&volume=1](http://localhost:7979/trade?side=NB\&symbol=VN30F2407\&price=1300\&account=0001177065\&loan=2403\&volume=1)
* **Hủy tất cả lệnh chờ**:
  * [http://localhost:7979/closeorders?all\_account=true/false](http://localhost:7979/closeorders?all_account=true/false%20/%20http://localhost:7979/closeorders?account=001234567)
  * [http://localhost:7979/closeorders?account=001234567](http://localhost:7979/closeorders?all_account=true/false%20/%20http://localhost:7979/closeorders?account=001234567)
* **Đóng tất cả lệnh đang mở**: (chỉ phái sinh)
  * <http://localhost:7979/closedeals?all_account=true/false>
  * <http://localhost:7979/closedeals?account=001234567>

## **Cấu tạo của 1 câu lệnh:**

> Bao gồm: <[trade?side](http://localhost:7979/trade?side=NB\&symbol=VN30F2407\&price=1300\&account=0001177065\&loan=2403\&volume=1)> chiều mua/bán &<[symbol](http://localhost:7979/trade?side=NB\&symbol=VN30F2407\&price=1300\&account=0001177065\&loan=2403\&volume=1)> mã &<[price](http://localhost:7979/trade?side=NB\&symbol=VN30F2407\&price=1300\&account=0001177065\&loan=2403\&volume=1)> giá đặt lệnh &<[account](http://localhost:7979/trade?side=NB\&symbol=VN30F2407\&price=1300\&account=0001177065\&loan=2403\&volume=1)> số tiểu khoản &<[loan](http://localhost:7979/trade?side=NB\&symbol=VN30F2407\&price=1300\&account=0001177065\&loan=2403\&volume=1)> mã gói vay &<[volume](http://localhost:7979/trade?side=NB\&symbol=VN30F2407\&price=1300\&account=0001177065\&loan=2403\&volume=1)> khối lượng

Lưu ý:

* *Thông tin về số tài khoản và mã gói vay có thể lấy trong màn hình Cài đặt tài khoản của Ami X.*
* *Câu lệnh trên là câu lệnh đầy đủ, nếu gọi đầy đủ các thành phần trong câu lệnh trên thì sẽ đặt được lệnh mà không cần cài đặt tài khoản trong Ami X.*

### + **Đặt lệnh MTL/ATO/ATC/MOK/MAK**

Nếu muốn đặt lệnh **MTL/ATO/ATC/MOK/MAK** thì chỉ cần truyền thêm kiểu lệnh vào cuối câu lệnh

* [http://localhost:7979/trade?side=NB\&symbol=VN30F1M\&account=0001177065\&loan=2403\&volume=1](http://localhost:7979/trade?side=NB\&symbol=VN30F2407\&price=1300\&account=0001177065\&loan=2403\&volume=1)[\&type=ATC](http://localhost:7979/trade?side=NB\&symbol=VN30F2407\&price=1300\&account=0001177065\&loan=2403\&volume=1\&type=ATC)

Nếu không gọi loại lệnh thì sẽ mặc định là lệnh LO như câu lệnh ở phần trên.

Với các lệnh **MTL/ATO/ATC/MOK/MAK** thì không cần phải gọi giá đặt. Nếu vẫn gọi giá đặt trong câu lệnh thì phần giá sẽ bị bỏ qua

### **+ Đặt lệnh điều kiện**

* <http://localhost:7979/conditional_order?side=NB&symbol=VN30F2407&account=0001177065&loan=2403&volume=1&type=>{LO|MP|MTL}\&stop=1300\&condition={greater|smaller}\&price=1301

Giải thích: Đặt lệnh mua LO|MP|MTL tại giá 1300 khi mà điều kiện giá thị trường lớn hơn/nhỏ hơn giá 1301 thỏa mãn

* **Hủy lệnh điều kiện:** <http://localhost:7979/cancel_conditional_order?id=>{id/all}

Thêm số tiểu khoản **ID** ở cuối nếu muốn hủy lệnh cho một tài khoản, để **all** nếu muốn hủy lệnh cho tất cả tài khoản được cài đặt