# 웹후크

goodcryptoX는 TradingView 웹훅을 통해 DEX 트레이딩을 자동화할 수 있게 해줍니다 — 신호에서 직접 주문 및 봇 동작을 트리거하는 강력한 메커니즘입니다.

웹훅을 프로그래머블 API(예: "3 BTC 매수" 같은 파라미터화된 명령을 보내는 방식)처럼 취급하는 일부 구현과 달리, goodcryptoX는 현재 트리거 기반 모델을 지원합니다. 각 웹훅은 특정 주문 또는 봇에서 미리 정의된 동작만 단순히 활성화하며 — 어떠한 파라미터나 명령도 해석하지 않습니다.

가까운 미래에, 웹훅을 통한 전체 전략 지시(동적 심볼 선택, 수량, 주문 유형, 멀티 심볼 로직 포함)를 지원하는 새로운 TradingView Strategy 봇을 출시할 예정입니다 — 사실상 API 레이어처럼 동작합니다. 기대해 주세요

> 현재는 TradingView 서버에서 오는 웹훅만 허용됩니다 — 커스텀 IP나 외부 소스는 불가합니다.\
> 커스텀 웹훅 소스를 사용해야 한다면 아래로 문의해 주세요 <support@goodcrypto.app> 액세스 요청을 위해.

### goodcryptoX에서 웹훅이 작동하는 방식

* 모든 주문 또는 봇 **동작** 은 자체 전용 웹훅 URL을 가집니다
* URL을 받으려면 먼저 주문 또는 봇을 생성해야 합니다(그들은 **Webhooks** 의 주문 또는 봇 **세부 정보**)
* 해당 URL로 **어떤** 웹훅 페이로드를 보내더라도 해당 동작이 트리거됩니다

다음은 비디오 개요입니다:

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

> 웹훅 URL은 동작별입니다. 동작마다 하나의 웹훅을 생성해야 합니다. 예: 진입용 하나, 익절용 하나, 손절용 하나 등 각 봇 또는 주문마다 필요합니다

### 지원되는 주문 및 봇 동작

주문 또는 봇이 **웹훅에 의해 트리거되길**원한다면, 설정 중 **트리거 조건으로 웹훅을 선택해야 합니다** 해당 사항:

* 지정가 주문 트리거
* 트레일링 주문 활성화(트레일링 시작)
* 익절 및 손절 트리거&#x20;
* DCA 봇 진입 조건

> **취소** 웹훅 — 모든 주문과 봇에서 항상 사용 가능
>
> **포지션 종료** 웹훅 — DCA 봇 세부 정보에서 항상 사용 가능

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fl2pfeXIwqa1tpvsFEldb%2Fimage.png?alt=media&#x26;token=99ca6c17-d547-47c7-abaf-1d1e3bb4e03a" alt="" width="375"><figcaption></figcaption></figure>

생성 후, 사용 가능한 모든 웹훅 URL은 **세부 정보** 에서 확인할 수 있습니다:

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FlG04MgjoXROWz32j0tN4%2Fimage.png?alt=media&#x26;token=08009fa1-7757-4495-b60e-1165e12887b3" alt="" width="375"><figcaption></figcaption></figure>

요약:

| 동작          | 지원 여부 | 비고                          |
| ----------- | ----- | --------------------------- |
| 주문 취소       | ✅     | 세부 정보에 항상 표시                |
| 지정가 주문 트리거  | ✅     | 설정 시 웹훅 선택 필수               |
| 트레일링 주문 활성화 | ✅     | 트레일링 시작 = 웹훅                |
| 익절/손절 트리거   | ✅     | 옵션으로 웹훅 트리거 가능              |
| DCA 봇 - 진입  | ✅     | 웹훅을 통한 매수/매도 진입(설정 시 지정 필요) |
| DCA 봇 - 종료  | ✅     | 웹훅을 통한 포지션 종료(항상 사용 가능)     |

{% hint style="info" %}
**웹훅으로 여러 익절 타겟 사용**

트리거 방법으로 웹훅을 사용해 익절 그룹을 설정하면, 모두 동일한 웹훅 URL을 공유합니다. 웹훅이 트리거될 때마다 순서상의 다음 TP 주문이 실행됩니다 — 하나씩 순차적으로.
{% endhint %}

### TradingView에서 알림 설정 방법

goodcryptoX에서 주문 또는 봇을 생성하고 특정 동작에 대한 웹훅 URL을 복사했다면, 이를 TradingView 알림에 연결하는 방법은 다음과 같습니다:

1. TradingView에서 차트로 이동
2. 전략, 인디케이터 또는 조건을 기반으로 새 알림 생성
3. 에서 **알림 설정**의 체크박스 **“Webhook URL”**
4. goodcryptoX의 특정 웹훅 URL을 붙여넣으세요 **사용 가능 웹훅** 섹션
5. 의 **메시지 필드** 는 그대로 두세요(내용은 아무거나 상관없습니다 — goodcryptoX는 현재 페이로드를 무시합니다)
6. 알림 저장

### 반복 전략(DCA 봇 사용)

웹훅으로 트리거되는 주문(예: TP와 SL이 있는 지정가)은 **1회성 설정**입니다. 주문이 실행되고 연결된 TP 또는 SL이 발동하면 전체 거래는 완료됩니다. 이 구조가 **자동으로 반복되길**원한다면, 주문만으로는 불가능합니다 — 하지만 현재 DCA 봇을 사용해 구현할 수 있습니다.

곧 반복적인 다중 동작 거래를 지원하는 전용 TradingView 전략 봇을 도입할 예정이지만, 그때까지는 DCA 봇이 웹훅 기반 전략을 반복하는 유연한 방법을 제공합니다.

#### 순수 웹훅 루프

웹훅으로 진입하고, 웹훅으로 종료하며, 그 후 반복하는 봇을 설정하려면:

1. 다음 설정 **진입 조건** = 웹훅
2. 다음 설정 **평단가 조절 주문** = 0(평단가 조절 비활성화)
3. 다음 둘 다 비활성화 **익**-**절** 및 **손절**
4. 활성화 **"포지션 종료 시 반복"**

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNUBBrWgJqqqvjcnLBw7C%2Fimage.png?alt=media&#x26;token=ced6146d-5d8e-4496-94bc-0cb08cb57282" alt="" width="375"><figcaption></figcaption></figure>

봇이 실행되면, 봇의 **세부 정보 → Webhooks** 섹션에서 다음 웹훅 URL을 볼 수 있습니다:

* **매수 진입** — 롱 포지션을 엽니다
* **포지션 종료** — 활성 포지션(롱 또는 숏)을 종료합니다
* **취소** — 봇을 중지합니다

**실행 로직**

* 봇이 **매수 진입**을(를) 받으면, 롱 포지션을 엽니다.
* 봇은 **대기 상태에서 받은 첫 번째 진입 웹훅에만 응답** 합니다.
* 포지션이 열려 있는 동안:
  * 추가 진입 신호는 모두 **무시됨**
  * 허용되는 신호는 **포지션 종료** 또는 설정된 경우 TP/SL 발동뿐입니다
* 포지션이 종료되면(수동, 웹훅, 또는 SL/TP로), 봇은 리셋되고 다음 진입 웹훅을 대기합니다.

이 루프는 봇이 활성 상태인 한 계속되어, 진입 → 종료 → 리셋 사이클을 무기한 반복할 수 있게 합니다.

#### 순수 웹훅 모드 vs 하이브리드 설정

DCA 봇은 유연한 전략 구성을 위해 결합 가능한 여러 제어 레이어를 지원합니다:

* **진입**: 웹훅, 신호, 또는 즉시
* **종료**: 웹훅 또는 내장 가격 기반 TP/SL
* **평단가 조절**: 선택 사항; 비활성화 가능

다음이 가능합니다:

* 웹훅 신호만으로 봇 운영(진입 및 종료)
* 웹훅 종료를 사용하더라도 가격 기반 TP/SL을 폴백으로 추가
* 추가 보호를 위한 평단가 조절 주문 추가

이를 통해 다음과 같은 설계가 가능합니다:

* 완전 자동 루프 전략(순수 웹훅)
* 신호 기반 봇 + 수동 페일오버
* 다층 종료가 있는 하이브리드 설정

### 실용적인 웹훅 전략 예시

#### 예시 1: 1회성 주문 + 다중 익절(볼린저 밴드 반등)

**목표:** 가격이 하단 볼린저 밴드를 이탈하면 매수, 상승하면서 점진적으로 매도.

**goodcryptoX에서의 설정**

* 트리거 조건 = 웹훅인 지정가 주문 생성
* 익절 타겟 3개 추가. TP 트리거 = 웹훅

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Ffg4E339WmltyEDaiNjma%2Fimage.png?alt=media&#x26;token=0ee7cab9-7575-4ac2-89c4-841693b2ba77" alt="" width="375"><figcaption></figcaption></figure>

**TradingView에서의 설정**

알림 4개 생성:

1. 가격이 하단 밴드를 이탈 → 메인 주문의 **트리거** 웹훅 URL로 전송
2. 가격이 밴드 내부로 복귀 → **익절 트리거** 웹훅 URL로 전송
3. 로 전송 **익절 트리거** 웹훅 URL로 전송
4. 가격이 중단선을 돌파 → 전송 대상 **익절 트리거** 웹훅 URL로 전송

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fc3oNniHr6lmTUwc8qQ7V%2Fimage.png?alt=media&#x26;token=9787c6e6-5744-48cc-8ae1-a891fd775e8e" alt="" width="375"><figcaption></figcaption></figure>

에서 **알림 설정**의 체크박스 **“Webhook URL”**

goodcryptoX의 특정 웹훅 URL을 붙여넣으세요 **사용 가능 웹훅** 섹션. 메시지 필드는 그대로 두세요 — 사용되지 않습니다.

#### 예시 2: DCA 봇으로 반복 전략(골든/데드 크로스)

**목표:** 골든 크로스에서 롱 진입, 데드 크로스에서 숏 진입. 10% 수익 또는 RSI > 70 시 종료하고 무한 반복.

**goodcryptoX에서의 설정**

DCA 봇 생성

* 진입 조건 = 웹훅
* 평단가 조절 = 끔(0으로 설정)
* 익절 = 10%
* 손절 = 끔
* 활성화: "TP 시 반복"

**TradingView에서의 설정**

* 동일 차트에서 세 가지 알림 생성:
  1. SMA50이 SMA200을 상향 교차 → 전송 대상 **매수 진입** 웹훅
  2. SMA50이 SMA200을 하향 교차 → 전송 대상 **매도 진입** 웹훅
  3. RSI > 70 → 전송 대상 **포지션 종료** 웹훅

### 요약

| 개념     | 설명                                       |
| ------ | ---------------------------------------- |
| 트리거 모델 | 각 동작은 자체 웹훅 URL 보유                       |
| 설정 흐름  | 주문 생성 → 웹훅 URL 복사 → TradingView 알림에 붙여넣기 |
| 반복 전략  | 반복 활성화된 DCA 봇 사용                         |