> 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

Dưới đây là chi tiết cú pháp các câu lệnh API kết nối với Ami X theo hai phương thức **GET** và **POST**.

### I. Phương thức GET (Dùng cho AmiBroker / Web Browser)

Phương thức GET truyền các tham số trực tiếp trên đường dẫn URL (Query Parameters). Phương thức này phù hợp nhất khi sử dụng hàm ihttpGet hoặc InternetOpenURL trong mã nguồn AmiBroker AFL.

#### 1. Cấu trúc câu lệnh GET cơ bản

Cú pháp đầy đủ:&#x20;

<http://localhost:7979/trade?side={NB|NS}&symbol={MÃ}&price={GIÁ}&account={SỐ_TK}&loan={MÃ_GÓI_VAY}&volume={KHỐI_LƯỢNG}>

* side: Chiều giao dịch (NB: Mua/Long, NS: Bán/Short).
* symbol: Mã chứng khoán hoặc HĐTL (Ví dụ: VN30F1M).
* price: Giá đặt lệnh (Hoặc các từ khóa: ceiling, floor, reference).
* account: Số tiểu khoản giao dịch (Ví dụ: 0001177065).
* loan: Mã gói vay (Lấy trong màn hình Cài đặt tài khoản của Ami X).
* volume: Số lượng hợp đồng / cổ phiếu đặt.

#### 2. Các câu lệnh GET mẫu

* Lấy giá Trần / Sàn / Tham chiếu: <http://localhost:7979/trade?side=NB\\&symbol=VN30F1M\\&price=ceiling>
* Đặt lệnh LO (Long / Short):
  * Lệnh Long: <http://localhost:7979/trade?side=NB\\&symbol=VN30F1M\\&price=1300\\&account=\\>\<số\_tiểu\_khoản>\&loan=\<mã\_gó&#x69;*\_*&#x76;ay>\&volume=1
  * Lệnh Short: <http://localhost:7979/trade?side=NS\\&symbol=VN30F1M\\&price=1300\\&account=\\>\<số\_tiểu\_khoản>\&loan=\<mã\_gó&#x69;*\_*&#x76;ay>\&volume=1
* Đặt lệnh Thị trường (MTL, ATO, ATC, MOK, MAK): (Thêm tham số \&type=... ở cuối, không bắt buộc truyền giá) <http://localhost:7979/trade?side=NB\\&symbol=VN30F1M\\&account=\\>\<số\_tiểu\_khoản>\&loan=\<mã\_gó&#x69;*\_*&#x76;ay>\&volume=1\&type=ATC
* Hủy lệnh & Đóng vị thế:
  * Hủy tất cả lệnh chờ: <http://localhost:7979/closeorders?all\\_account=true> (hoặc ?account=\<số\_tiểu\_khoản>)
  * Đóng tất cả vị thế đang mở (Phái sinh): <http://localhost:7979/closedeals?all\\_account=true>

#### 3. Mã AmiBroker AFL Mẫu (Phương thức GET)

Đoạn code AFL đơn giản dưới đây giúp bạn phát lệnh tự động từ AmiBroker sang Ami X qua phương thức GET:

Đoạn mã:

```
// ========================================================
// CODE AFL ĐẶT LỆNH TỰ ĐỘNG QUA AMI X (GET METHOD)
// ========================================================
Account = "<số_tiểu_khoản>";  // Thay bằng số tiểu khoản của bạn
LoanID  = "<Gói_vay>";        // Thay bằng mã gói vay
Symbol  = "VN30F1M";
Vol     = "1";

// Cấu hình điều kiện Buy/Sell của chiến thuật
BuyCondition  = Cross( FastMA, SlowMA ); 
SellCondition = Cross( SlowMA, FastMA );

// Hàm gửi request GET tới Ami X
function SendGetOrder( side, priceVal )
{
    local url;
    url = "http://localhost:7979/trade?side=" + side + 
          "&symbol=" + Symbol + 
          "&price=" + priceVal + 
          "&account=" + Account + 
          "&loan=" + LoanID + 
          "&volume=" + Vol;
          
    ihttpGet( url ); // Gửi request GET
}

// Bắt tín hiệu đặt lệnh
if( LastVisAction == 1 ) 
{
    if( BuyCondition )
    {
        SendGetOrder( "NB", "1300" ); // Đặt Long giá 1300
    }
    
    if( SellCondition )
    {
        SendGetOrder( "NS", "1300" ); // Đặt Short giá 1300
    }
}
```

### II. Phương thức POST (Dùng cho TradingView Webhook / Python / API Client)

Phương thức POST giúp bảo mật thông tin hơn và truyền dữ liệu dưới dạng JSON Body, thích hợp sử dụng làm **Webhook trên TradingView** hoặc gọi từ các ứng dụng bên ngoài.

Ami X tự đổi được buy/sell sang NB/NS, nhận được cả 2, không phân biệt hoa thường, không nhận Tiếng Việt.

#### 1. Endpoint & Header

* URL: <http://localhost:7979/trade> (hoặc domain/tunnel công khai nếu dùng Webhook)
* Method: POST
* Content-Type: application/json

#### 2. Cấu trúc JSON Body mẫu

**a. Lệnh LO (Thường)**

```
JSON
{
  "side": "NB",
  "symbol": "VN30F1M",
  "price": <giá_Long>,
  "account": "<Số_tiểu_khoản>",
  "loan": "<Gói_vay>",
  "volume": 1
}
```

**b. Lệnh Thị trường (ATC, ATO, MTL...)**

```
JSON
{
  "side": "NS",
  "symbol": "VN30F1M",
  "type": "ATC",
  "account": "<Số_tiểu_khoản>",
  "loan": "<Gói_vay>",
  "volume": 1
}
```

**c. Đặt lệnh Điều kiện**

* URL: <http://localhost:7979/conditional\\_order>
* Body:

```
JSON
{
  "side": "NB",
  "symbol": "VN30F1M",
  "type": "LO",
  "stop": 1300,
  "condition": "greater",
  "price": 1301,
  "account": "<Số_tiểu_khoản>",
  "loan": "<Gói_vay>",
  "volume": 1
}
```

**d. Cấu hình Webhook tin nhắn trên TradingView (Alert Payload)**

Khi tạo Alert trên TradingView, điền đoạn JSON sau vào phần Message:

```
JSON
{
  "side": "{{strategy.order.action}}", 
  "symbol": "VN30F1M",
  "price": {{strategy.order.price}},
  "account": "<Số_tiểu_khoản>",
  "loan": "<Gói_vay>",
  "volume": 1
}
```

### III. Đặt lệnh cho nhóm tài khoản&#x20;

```
{
  "side": "{{strategy.order.action}}",
  "symbol": "VN30F1M",
  "price": {{strategy.order.price}},
  "time": "{{timenow}}",
  "secret_key": "secret_key",
  "group": "Tên nhóm đặt lệnh nhiều tài khoản",
  "volume": {{strategy.order.contracts}}
}
```

**Đặt lệnh cho Nhóm tài khoản:**

* "group": Điền tên nhóm tài khoản đã tạo trên AmiX để tự động đặt lệnh đồng thời cho nhiều tài khoản.
* OPTIONAL: GỬI THÔNG BÁO TỚI TELEGRAM/ZALO

Trong trường hợp khách không chỉ muốn đặt lệnh mà còn gửi tín hiệu, có thể thêm phần này vào (áp dụng cho mọi lệnh)

```
 "zalo_config": [
    {
      "zalo_id": "620936601851844655",
      "thread_id": ["2806324088106752579"],
      "sender": "Tên bot có tín hiệu",
      "message": "Bot Tradingview vừa đặt lệnh {{strategy.order.action}} tại giá {{strategy.order.price}}",
      "footer": "Thông tin footer cuối tin nhắn"
    }
  ],
  "tele_config": [
    {
      "channels": "-1001461663646,-1001413453988,-1001150212791",
      "sender": "Tên bot có tín hiệu",
      "message": "Bot Tradingview vừa đặt lệnh {{strategy.order.action}} tại giá {{strategy.order.price}}",
      "footer": "Thông tin footer cuối tin nhắn"
    }
  ]
```

Khách cần Zalo thì thêm *zalo\_config*, cần Telegram thì *tele\_config*, cần cả 2 thì thêm cả 2

**1. ID Nhóm nhận thông báo (Zalo / Telegram):**

* Zalo: "thread\_id" nằm trong zalo\_config — Điền danh sách ID nhóm Zalo nhận tin nhắn (ví dụ: \["2806324088106752579"]).
* Telegram: "channels" nằm trong tele\_config — Điền các ID nhóm/kênh Telegram, phân cách bằng dấu phẩy (ví dụ: "-1001461663646,-1001413453988").

**2. Tùy biến nội dung tin nhắn:**

* "sender": Tên Bot phát tín hiệu hiển thị trong tin nhắn. (thêm vào trước tin nhắn, ví dụ: “\<sender>: \<nội dung message>”)
* "message": Câu từ thông báo tùy chỉnh, nếu để trống sẽ mặc định gửi thông báo log trong AmiX
* "footer": Nội dung ghi chú/chữ ký cố định ở cuối tin nhắn.
