> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-vi/dex-trading-spot/webhooks.md).

# Webhook

goodcryptoX cho phép bạn tự động hóa giao dịch DEX qua webhook TradingView — một cơ chế mạnh mẽ để kích hoạt lệnh và hành động của bot trực tiếp từ các tín hiệu của bạn.

Không giống một số triển khai coi webhook như một API có thể lập trình (nơi bạn gửi các lệnh có tham số như "mua 3 BTC"), hiện tại goodcryptoX hỗ trợ mô hình dựa trên kích hoạt. Mỗi webhook chỉ đơn giản kích hoạt một hành động đã được định sẵn trên một lệnh hoặc bot cụ thể — không có tham số hay lệnh nào được diễn giải.

Trong tương lai gần, chúng tôi sẽ ra mắt một bot TradingView Strategy mới hỗ trợ đầy đủ chỉ thị chiến lược qua webhook, bao gồm chọn ký hiệu động, khối lượng, loại lệnh và logic đa ký hiệu — thực chất hoạt động như một lớp API. Hãy chờ xem

> Hiện tại, webhook chỉ được chấp nhận từ các máy chủ TradingView — không có IP tùy chỉnh hoặc nguồn bên ngoài.\
> Nếu bạn cần sử dụng nguồn webhook tùy chỉnh, hãy liên hệ với chúng tôi tại <support@goodcrypto.app> để yêu cầu quyền truy cập.

### Cách webhook hoạt động trong goodcryptoX

* Mỗi lệnh hoặc bot **hành động** có URL webhook riêng dành riêng
* Bạn phải tạo lệnh hoặc bot trước để lấy URL (chúng sẽ xuất hiện trong **Webhook** phần của lệnh hoặc bot **Chi tiết**)
* Gửi **bất kỳ** payload webhook nào đến URL đó sẽ kích hoạt hành động

Đây là tổng quan video:

> Các URL webhook dành riêng cho từng hành động. Bạn phải tạo một webhook cho mỗi hành động, ví dụ: một cho vào lệnh, một cho chốt lời, một cho cắt lỗ, v.v. cho mỗi bot hoặc lệnh

### Các hành động lệnh và bot được hỗ trợ

Nếu bạn muốn lệnh hoặc bot của mình **được kích hoạt bởi webhook**, bạn phải chọn webhook làm **điều kiện kích hoạt trong quá trình thiết lập**. Điều này áp dụng cho:

* Lệnh giới hạn được kích hoạt
* Kích hoạt lệnh trailing (bắt đầu trailing)
* Kích hoạt chốt lời và cắt lỗ
* Điều kiện vào lệnh của bot DCA

> **Hủy** webhook — luôn khả dụng trong mọi lệnh và bot
>
> **Đóng vị thế** webhook — luôn khả dụng trong chi tiết bot DCA

<figure><img src="https://2917715712-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs1USr8Fnn6qAJpGsKVQT%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Sau khi tạo, bạn sẽ thấy tất cả các URL webhook khả dụng trong **Chi tiết** của lệnh hoặc bot của bạn:

<figure><img src="https://2917715712-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs1USr8Fnn6qAJpGsKVQT%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Tóm lại:

| Hành động                   | Được hỗ trợ? | Ghi chú                                                      |
| --------------------------- | ------------ | ------------------------------------------------------------ |
| Hủy lệnh                    | ✅            | Luôn hiển thị trong phần chi tiết                            |
| Kích hoạt lệnh giới hạn     | ✅            | Phải chọn webhook khi thiết lập                              |
| Kích hoạt lệnh Trailing     | ✅            | Trailing start = webhook                                     |
| Kích hoạt chốt lời / cắt lỗ | ✅            | Có thể được kích hoạt bằng webhook tùy chọn                  |
| Bot DCA - vào lệnh          | ✅            | Mua/bán vào lệnh qua webhook (phải được thiết lập khi setup) |
| Bot DCA - thoát lệnh        | ✅            | Đóng vị thế qua webhook (luôn khả dụng)                      |

{% hint style="info" %}
**Nhiều mục tiêu chốt lời với webhook**

Nếu bạn thiết lập một nhóm chốt lời bằng cách dùng webhook làm phương thức kích hoạt, tất cả chúng sẽ dùng chung một URL webhook. Mỗi khi webhook được kích hoạt, lệnh TP tiếp theo trong chuỗi sẽ được thực hiện — lần lượt từng cái một.
{% endhint %}

### Cách thiết lập cảnh báo trong TradingView

Sau khi bạn đã tạo lệnh hoặc bot trong goodcryptoX và sao chép URL webhook cho một hành động cụ thể, đây là cách liên kết nó với các cảnh báo TradingView của bạn:

1. Đi tới biểu đồ của bạn trong TradingView
2. Tạo một cảnh báo mới dựa trên chiến lược, chỉ báo hoặc điều kiện của bạn
3. Trong **cài đặt cảnh báo**, hãy bật ô chọn **“Webhook URL”**
4. Dán URL webhook cụ thể từ goodcryptoX **Các webhook khả dụng** mục
5. Để nguyên **trường thông điệp** (mọi nội dung đều được — hiện tại goodcryptoX bỏ qua payload)
6. Lưu cảnh báo

### Chiến lược lặp lại (qua bot DCA)

Một lệnh được kích hoạt qua webhook (ví dụ: lệnh giới hạn kèm TP và SL) là một **thiết lập một lần**. Khi lệnh được thực hiện và TP hoặc SL liên kết được kích hoạt, toàn bộ giao dịch sẽ hoàn tất. Nếu bạn muốn cấu trúc này **lặp lại tự động**, điều đó không thể làm được với lệnh — nhưng hiện nay có thể thực hiện bằng bot DCA.

Chúng tôi sẽ sớm giới thiệu một bot chiến lược TradingView chuyên dụng để hỗ trợ các giao dịch lặp lại đa hành động, nhưng trong thời gian chờ đợi, bot DCA cung cấp một cách linh hoạt để lặp lại chiến lược điều khiển bằng webhook của bạn.

#### Vòng lặp webhook thuần túy

Để thiết lập một bot vào vị thế bằng webhook, thoát lệnh bằng webhook, rồi lặp lại:

1. Đặt **điều kiện vào lệnh** = webhook
2. Đặt **các lệnh trung bình giá** = 0 (tắt trung bình giá)
3. Tắt cả **chốt**-**lời** và **cắt lỗ**
4. Bật **"Lặp lại khi đóng vị thế"**

<figure><img src="https://2917715712-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs1USr8Fnn6qAJpGsKVQT%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Sau khi bot được khởi chạy, bạn sẽ thấy các URL webhook sau trong **Chi tiết → Webhooks** phần:

* **Vào mua** — mở một vị thế Long
* **Đóng vị thế** — đóng vị thế đang hoạt động (long hoặc short)
* **Hủy** — dừng bot

**Logic thực thi**

* Khi bot nhận **Vào mua**Vào mua
* Bot sẽ **chỉ phản hồi webhook vào lệnh đầu tiên** mà nó nhận được khi đang ở trạng thái nhàn rỗi.
* Trong khi một vị thế đang mở:
  * Bất kỳ tín hiệu vào lệnh nào tiếp theo đều bị **bỏ qua**
  * Các tín hiệu duy nhất được chấp nhận là **đóng vị thế** hoặc TP/SL được kích hoạt (nếu đã cấu hình)
* Khi vị thế được đóng (thủ công, bằng webhook, hoặc bởi SL/TP), bot sẽ đặt lại và chờ webhook Vào lệnh tiếp theo.

Vòng lặp này tiếp tục miễn là bot còn hoạt động, cho phép bạn lặp lại vô hạn một chu kỳ hoàn chỉnh: vào lệnh → thoát lệnh → đặt lại.

#### Chế độ webhook thuần túy vs thiết lập lai

Bot DCA hỗ trợ nhiều lớp điều khiển có thể kết hợp để xây dựng các chiến lược linh hoạt:

* **Vào lệnh**: qua webhook, tín hiệu hoặc tức thì
* **Thoát lệnh**: qua webhook, hoặc TP/SL tích hợp dựa trên giá
* **Trung bình giá**: tùy chọn; có thể tắt

Bạn có thể:

* Chạy bot hoàn toàn bằng tín hiệu webhook (vào lệnh và thoát lệnh)
* Thêm TP/SL dựa trên giá làm phương án dự phòng, ngay cả khi bạn dùng webhook để thoát lệnh
* Thêm các lệnh trung bình giá để tăng cường bảo vệ

Điều này cho phép thiết kế:

* Các chiến lược lặp tự động hoàn toàn (webhook thuần túy)
* Bot dựa trên tín hiệu với cơ chế dự phòng thủ công
* Thiết lập lai với các lớp thoát lệnh nhiều tầng

### Các ví dụ chiến lược webhook thực tế

#### Ví dụ 1: Lệnh một lần + nhiều mức chốt lời (bật lại dải Bollinger)

**Mục tiêu:** Mua khi giá phá vỡ dải Bollinger dưới, bán dần khi giá tăng lên.

**Thiết lập trong goodcryptoX**

* Tạo một lệnh giới hạn với điều kiện kích hoạt = webhook
* Thêm ba mục tiêu chốt lời. Kích hoạt TP = webhook

<figure><img src="https://2917715712-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs1USr8Fnn6qAJpGsKVQT%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

**Thiết lập trong TradingView**

Tạo bốn cảnh báo:

1. Giá phá vỡ dải dưới → gửi đến **Kích hoạt** URL webhook
2. Giá quay trở lại trong dải → gửi đến **Kích hoạt chốt lời** URL webhook
3. Giá cắt lên đường giữa dải → gửi đến **Kích hoạt chốt lời** URL webhook
4. Giá phá vỡ dải trên → gửi đến **Kích hoạt chốt lời** URL webhook

<figure><img src="https://2917715712-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs1USr8Fnn6qAJpGsKVQT%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Trong **cài đặt cảnh báo**, hãy bật ô chọn **“Webhook URL”**

Dán URL webhook cụ thể từ goodcryptoX **Các webhook khả dụng** mục. Để trống trường Message như nguyên trạng — nó không được sử dụng.

#### Ví dụ 2: Chiến lược lặp lại với bot DCA (Giao cắt vàng/Giao cắt tử thần)

**Mục tiêu:** Mở vị thế long khi có Giao cắt vàng, mở vị thế short khi có Giao cắt tử thần. Thoát lệnh với lợi nhuận 10% hoặc khi RSI > 70 và lặp lại mãi mãi.

**Thiết lập trong goodcryptoX**

Tạo bot DCA

* Điều kiện vào lệnh = webhook
* Trung bình giá = tắt (đặt thành 0)
* Chốt lời = 10%
* Cắt lỗ = tắt
* Bật: "Lặp lại khi chốt lời"

**Thiết lập trong TradingView**

* Tạo ba cảnh báo trên cùng một biểu đồ:
  1. SMA50 cắt lên trên SMA200 → gửi đến **Vào mua** webhook
  2. SMA50 cắt xuống dưới SMA200 → gửi đến **Vào bán** webhook
  3. RSI > 70 → gửi đến **Đóng vị thế** webhook

### Tóm tắt

| Khái niệm          | Mô tả                                                          |
| ------------------ | -------------------------------------------------------------- |
| Mô hình kích hoạt  | Mỗi hành động có một URL webhook riêng                         |
| Luồng thiết lập    | Tạo lệnh → sao chép URL webhook → dán vào cảnh báo TradingView |
| Chiến lược lặp lại | Dùng bot DCA với tính năng lặp lại được bật                    |
