# Webhook

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

Không giống một vài 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 nghĩa trước trên một lệnh hoặc bot cụ thể — không có tham số hay lệnh nào được giải thích.

Trong tương lai gần, chúng tôi sẽ ra mắt một bot Chiến lược TradingView mới hỗ trợ hướng dẫn chiến lược đầy đủ qua webhook, bao gồm lựa chọn mã chứng khoán động, khối lượng, loại lệnh và logic đa mã — về cơ bản hoạt động như một lớp API. Hãy chờ đón

> 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 hay nguồn bên ngoài.\
> Nếu bạn cần sử dụng nguồn webhook tùy chỉnh, 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** đều có URL webhook riêng
* Bạn phải tạo lệnh hoặc bot trước để có được URL (chúng sẽ xuất hiện trong **Webhooks** phần **Chi tiết**)
* Gửi **bất kỳ** payload webhook đến URL đó sẽ kích hoạt hành động

Đây là video tổng quan:

{% embed url="<https://youtu.be/Mx-nD_p2Pgw>" %}

> URL webhook là 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 entry, một cho take profit, một cho stop loss, 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 Limit kích hoạt
* Kích hoạt lệnh trailing (bắt đầu trailing)
* Kích hoạt take-profit và stop-loss&#x20;
* Điều kiện entry của bot DCA

> **Hủy** webhook — luôn có sẵn trong tất cả lệnh và bot
>
> **Đóng vị thế** webhook — luôn có sẵn trong chi tiết bot DCA

<figure><img src="/files/901320a53ebf51c9ea9f63e6407e28757f892be8" alt="" width="375"><figcaption></figcaption></figure>

Sau khi tạo, bạn sẽ tìm thấy tất cả URL webhook có sẵn trong **Chi tiết** của lệnh hoặc bot của bạn:

<figure><img src="/files/7ff4024630930fa65cef9f2aab4318d12e9c58a5" 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 chi tiết                            |
| Kích hoạt lệnh Limit              | ✅            | Phải chọn webhook khi thiết lập                         |
| Kích hoạt lệnh Trailing           | ✅            | Bắt đầu trailing = webhook                              |
| Kích hoạt take profit / stop loss | ✅            | Có thể kích hoạt bằng webhook                           |
| Bot DCA - entry                   | ✅            | Mua/bán entry qua webhook (phải được đặt khi thiết lập) |
| Bot DCA - exit                    | ✅            | Đóng vị thế qua webhook (luôn có sẵn)                   |

{% hint style="info" %}
**Nhiều mục tiêu take-profit với webhook**

Nếu bạn thiết lập một nhóm take-profit sử dụng webhook làm phương pháp kích hoạt, tất cả sẽ dùng chung một URL webhook. Mỗi lần webhook được kích hoạt, lệnh TP tiếp theo trong chuỗi sẽ 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

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ảnh báo TradingView của bạn:

1. Vào 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**, bật hộp kiểm **“Webhook URL”**
4. Dán URL webhook cụ thể từ phần goodcryptoX **Webhooks có sẵn** phần
5. Giữ nguyên **trường tin nhắn** như cũ (bất kỳ nội dung nào cũng được — goodcryptoX hiện 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 kích hoạt bằng webhook (ví dụ limit kèm TP và SL) là một **thiết lập một lần**. Khi lệnh thực thi và TP hoặc SL liên kết được kích hoạt, toàn bộ giao dịch hoàn tất. Nếu bạn muốn cấu trúc này **tự động lặp lại**, điều đó không thể thực hiện bằng lệnh — nhưng có thể thực hiện bằng bot DCA ngay bây giờ.

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 nhiều hành động lặp lại, nhưng trong khi đó, bot DCA cung cấp 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 lệnh khi có webhook, thoát khi có webhook, rồi lặp lại:

1. Đặt **điều kiện entry** = webhook
2. Đặt **lệnh trung bình** = 0 (tắt trung bình)
3. Tắt cả **take**-**profit** và **stop-loss**
4. Bật **"Lặp lại khi đóng vị thế"**

<figure><img src="/files/c5a2b559a75e51cdd82d86120bfa49d47ab5b909" alt="" width="375"><figcaption></figcaption></figure>

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

* **Enter Buy** — mở 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 được **Enter Buy**, nó mở một vị thế long.
* Bot sẽ **chỉ phản hồi webhook entry đầu tiên** nó nhận được khi ở trạng thái rảnh.
* Khi một vị thế đang mở:
  * Bất kỳ tín hiệu entry tiếp theo nào **sẽ bị**
  * bỏ qua **Các tín hiệu duy nhất được chấp nhận là** đóng vị thế
* hoặc một TP/SL được kích hoạt (nếu được cấu hình)

Khi vị thế được đóng (bằng tay, bằng webhook, hoặc bởi SL/TP), bot sẽ đặt lại và chờ webhook Entry tiếp theo.

#### Vòng lặp này tiếp tục miễn là bot vẫn hoạt động, cho phép bạn lặp lại một chu kỳ entry → exit → reset hoàn chỉnh vô thời hạn.

Chế độ webhook thuần túy so với cấu hình kết hợp

* **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:**&#x45;ntry
* **: qua webhook, tín hiệu, hoặc ngay lập tức**Exit
* **: qua webhook, hoặc TP/SL dựa trên giá tích hợp sẵn**Averaging

: tùy chọn; có thể tắt

* Bạn có thể:
* Chạy một bot hoàn toàn bằng tín hiệu webhook (entry và exit)
* Thêm TP/SL dựa trên giá làm phương án dự phòng, ngay cả khi bạn sử dụng exit bằng webhook

Thêm lệnh trung bình để tăng mức bảo vệ

* Điều này làm cho có thể thiết kế:
* Chiến lược vòng lặp hoàn toàn tự động (webhook thuần túy)
* Bot dựa trên tín hiệu với chuyển sang thủ công khi cần

### Cấu hình kết hợp với nhiều lớp thoát

#### Ví dụ chiến lược webhook thực tế

**Ví dụ 1: Lệnh một lần + nhiều take profit (bật nẩy Bollinger Band)** Mục tiêu:

**Mua khi giá vượt qua dải Bollinger dưới, bán dần khi giá tăng trở lại.**

* Thiết lập trong goodcryptoX
* Tạo một lệnh limit với điều kiện kích hoạt = webhook

<figure><img src="/files/4630ff8d4f8013bdfe7eb7590bbfb612d49f2e4d" alt="" width="375"><figcaption></figcaption></figure>

**Thêm ba mục tiêu take-profit. Kích hoạt TP = webhook**

Thiết lập trong TradingView

1. Tạo bốn cảnh báo: **Giá vượt qua dải dưới → gửi tới** Kích hoạt
2. URL webhook của lệnh chính **Giá trở lại bên trong dải → gửi tới** Kích hoạt
3. Kích hoạt Take Profit **Giá trở lại bên trong dải → gửi tới** Kích hoạt
4. Giá cắt qua dải giữa → gửi tới **Giá trở lại bên trong dải → gửi tới** Kích hoạt

<figure><img src="/files/49be4e4381f369c36c5cb10a538cab1b83f6d1a3" alt="" width="375"><figcaption></figcaption></figure>

Trong **cài đặt cảnh báo**, bật hộp kiểm **“Webhook URL”**

Dán URL webhook cụ thể từ phần goodcryptoX **Webhooks có sẵn** Giá vượt qua dải trên → gửi tới

#### mục. Giữ trường Message như cũ — nó không được sử dụng.

**Ví dụ 1: Lệnh một lần + nhiều take profit (bật nẩy Bollinger Band)** Ví dụ 2: Chiến lược lặp lại với bot DCA (Golden/Death Cross)

**Mua khi giá vượt qua dải Bollinger dưới, bán dần khi giá tăng trở lại.**

Vào long khi Golden Cross, vào short khi Death Cross. Thoát với lợi nhuận 10% hoặc khi RSI > 70 và lặp lại mãi mãi.

* Tạo bot DCA
* Điều kiện entry = webhook
* Trung bình = tắt (đặt thành 0)
* Take Profit = 10%
* Stop loss = tắt

**Thêm ba mục tiêu take-profit. Kích hoạt TP = webhook**

* Bật: "Lặp lại khi TP"
  1. Tạo ba cảnh báo trên cùng một biểu đồ: **Enter Buy** SMA50 cắt lên SMA200 → gửi tới
  2. webhook **SMA50 cắt xuống SMA200 → gửi tới** SMA50 cắt lên SMA200 → gửi tới
  3. Enter Sell **Đóng vị thế** SMA50 cắt lên SMA200 → gửi tới

### RSI > 70 → gửi tới

| Tóm tắt                                                        | Khái niệm          |
| -------------------------------------------------------------- | ------------------ |
| Mô tả                                                          | Mô hình kích hoạt  |
| Mỗi hành động có 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 |


---

# 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://docs.goodcrypto.app/goodcryptox-vi/giao-dich-dex-giao-ngay/webhook.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.
