# 웹후크

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

일부 구현이 웹훅을 매개변수화된 명령("BTC 3개 매수"처럼)을 보내는 프로그래머블 API처럼 취급하는 것과 달리, goodcryptoX는 현재 트리거 기반 모델을 지원합니다. 각 웹훅은 특정 주문이나 봇에서 미리 정의된 동작을 단순히 활성화할 뿐이며 — 매개변수나 명령은 해석되지 않습니다.

> 가까운 시일 내에 우리는 새로운 [TradingView 전략 봇](https://docs.goodcrypto.app/goodcryptox-ko/dex-1/upcoming-functionality/tradingview) 을 출시할 예정이며, 웹훅을 통한 동적 심볼 선택, 수량, 주문 유형 및 다중 심볼 로직을 포함한 전체 전략 지시를 지원하여 사실상 API 계층처럼 작동할 것입니다. 계속 지켜봐 주세요

### 보안 및 접근

* 현재 웹훅은 TradingView 서버에서만 수락됩니다 — 사용자 지정 IP나 외부 소스는 허용되지 않습니다.
* 사용자 지정 웹훅 소스를 사용해야 하는 경우, <support@goodcrypto.app> 로 연락하여 접근을 요청하세요.
* 웹훅은 활성 PRO [플랜](https://docs.goodcrypto.app/goodcryptox-ko/ecosystem/subscription-plans) 이상 사용자에게만 제공됩니다.

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

* 각 주문 또는 봇 **동작** 에는 전용 웹훅 URL이 있습니다
* URL을 받으려면 먼저 주문이나 봇을 생성해야 합니다(해당 URL은 **웹훅** 섹션에 나타납니다) **세부정보**)
* 해당 URL로 **임의의** 웹훅 페이로드를 보내면 그 동작이 트리거됩니다

> 웹훅 URL은 사용자별이 아니라 동작별입니다. 동작당 하나의 웹훅을 생성해야 합니다. 예: 진입용 하나, 이익실현용 하나, 손절용 하나 등 각 봇이나 주문마다 별도 생성해야 합니다

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

주문이나 봇이 **웹훅에 의해**트리거되기를 원하면 **설정 중 트리거 조건으로 웹훅을 선택해야 합니다**이것은 다음에 적용됩니다:

* 스탑-마켓 / 스탑-리밋 주문 트리거
* 트레일링 주문 활성화(트레일링 시작)
* 이익실현 및 손절 트리거&#x20;
* DCA 봇의 진입 조건

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FOtmSJHlKDJLkbCquvUfC%2Fimage.png?alt=media&#x26;token=c152200c-d5ad-4d69-861d-7c66700cd569" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2F278uiG55cCWY8A3XpJxm%2Fimage.png?alt=media&#x26;token=7d852fc3-0ef4-45ab-921d-eab0d2287e97" alt="" width="563"><figcaption></figcaption></figure>

생성 후, 모든 사용 가능한 웹훅 URL은 귀하의 **세부정보** 주문 또는 봇의

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FKTTUr7eaKAlb7x0U818J%2Fimage.png?alt=media&#x26;token=6b2a978f-fd3c-48b0-b01a-40da32d44696" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNoneMggO61H3EFmkwTrP%2Fimage.png?alt=media&#x26;token=f6f48a58-1585-41e3-8778-b69fe9564902" alt="" width="563"><figcaption></figcaption></figure>

> **세부정보** 섹션에서 찾을 수 있습니다:
>
> **취소** 웹훅 — 모든 주문 및 봇에서 항상 사용 가능

포지션 종료

| 웹훅 — DCA 봇 세부정보에서 항상 사용 가능 | 요약하면:                 | 동작                          |
| -------------------------- | --------------------- | --------------------------- |
| 지원 여부                      | 비고                    | 주문 취소                       |
| ✅                          | 비고                    | 세부정보에 항상 표시                 |
| 스탑 주문 트리거                  | 비고                    | 설정 시 웹훅을 선택해야 함             |
| 트레일링 주문 활성화                | 비고                    | 트레일링 시작 = 웹훅                |
| 이익실현 / 손절 트리거              | 비고                    | 선택적으로 웹훅으로 트리거 가능           |
| DCA 봇 - 진입                 | 비고                    | 웹훅을 통한 진입 매수/매도(설정 시 지정 필요) |
| DCA 봇 - 종료                 | 웹훅으로 포지션 종료(항상 사용 가능) | 그리드 봇 - 진입                  |

{% hint style="info" %}
**🚫**

아직 지원되지 않음
{% endhint %}

### 웹훅으로 다중 이익실현(Target) 처리

웹훅을 트리거 방식으로 사용하여 이익실현 그룹을 설정하면 이들은 모두 동일한 웹훅 URL을 공유합니다. 웹훅이 호출될 때마다 시퀀스의 다음 TP 주문이 순차적으로 실행됩니다 — 하나씩 실행됩니다.

1. TradingView에서 알림 설정하는 방법
2. goodcryptoX에서 주문이나 봇을 생성하고 특정 동작의 웹훅 URL을 복사한 후 TradingView 알림에 연결하는 방법은 다음과 같습니다:
3. TradingView에서 차트로 이동하세요 **전략, 지표 또는 조건을 기반으로 새 알림을 생성하세요**알림 설정에서 **체크박스를 활성화하세요**
4. “웹훅 URL”
5. goodcryptoX 웹훅 섹션의 특정 웹훅 URL을 붙여넣으세요 **메시지** 필드는 있는 그대로 두세요(내용은 상관없음 — 현재 goodcryptoX는 페이로드를 무시합니다)
6. 알림을 저장하세요

### 반복 전략( DCA 봇을 통한)

웹훅으로 트리거되는 주문(예: TP 및 SL이 있는 스탑-마켓)은 **한 번의 설정**입니다. 주문이 실행되고 연결된 TP나 SL이 발동하면 전체 거래는 완료됩니다. 이 구조를 **자동으로 반복되게**하려면 주문으로는 불가능하지만 — DCA 봇을 사용하면 지금 구현할 수 있습니다.

우리는 곧 반복적인 다중 동작 거래를 지원하는 전용 [TradingView 전략 봇](https://docs.goodcrypto.app/goodcryptox-ko/cex-1/upcoming-functionality/tradingview) 을 도입할 예정이지만, 그동안 DCA 봇은 웹훅 기반 전략을 반복할 수 있는 유연한 방법을 제공합니다.

#### 순수 웹훅 루프

웹훅으로 진입하고 웹훅으로 종료한 다음 반복하는 봇을 설정하려면:

1. 진입 조건을 **= 웹훅으로 설정하세요** 평균화 주문
2. 진입 조건을 **= 0 (평균화 비활성화)** 다음 둘 다 비활성화하세요
3. 이익실현 **및**-**손절** “포지션 종료 시 반복”을 **활성화하세요**
4. 봇이 시작되면 다음 웹훅 URL들을 봇의 **세부정보 → 웹훅**&#x20;

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FCquwy7JurEJkuO9rQeWn%2Fimage.png?alt=media&#x26;token=542f9526-7ecb-4033-8b1c-740aef270b51" alt="" width="375"><figcaption></figcaption></figure>

섹션에서 보게 될 것입니다: **Enter Buy** — 롱 포지션을 엽니다

* **Enter Sell** — 숏 포지션을 엽니다
* **— 활성 포지션(롱 또는 숏)을 종료합니다** — 봇을 중지합니다
* **취소** 실행 로직
* **세부정보** 봇이

**를 수신하면, 롱 포지션을 엽니다.**

* 봇이 **Enter Sell**를 수신하면, 숏 포지션을 엽니다.
* 봇은 **— 활성 포지션(롱 또는 숏)을 종료합니다**휴지 상태일 때 수신하는 첫 번째 진입 웹훅에만 응답합니다.
* 포지션이 열려 있는 동안: **추가 진입 신호는** 무시됩니다
* 봇은 진입 신호로 현재 포지션을 증가시키거나 역전하지 않습니다
  * 허용되는 신호는 오직 **포지션 종료**
  * 또는 트리거된 TP/SL(구성된 경우)입니다
  * 포지션이 종료되면(수동, 웹훅 또는 SL/TP에 의해) 봇은 리셋되고 다음 진입 웹훅을 기다립니다. **이 루프는 봇이 활성 상태인 한 계속되며, 완전한 진입 → 종료 → 리셋 사이클을 무기한 반복할 수 있게 합니다.** 순수 웹훅 모드 vs 하이브리드 설정
* DCA 봇은 유연한 전략을 구성하기 위해 결합할 수 있는 여러 제어 레이어를 지원합니다:

진입

#### : 웹훅, 시그널 또는 가능한 즉시(asap)를 통해

종료

* **: 웹훅 또는 내장 가격 기반 TP/SL로**평균화
* **: 선택 사항; 비활성화 가능**다음과 같은 작업을 할 수 있습니다:
* **진입 및 종료 모두 웹훅 신호로만 봇을 실행**웹훅 종료를 사용하더라도 예비 조치로 가격 기반 TP/SL을 추가

추가 보호를 위해 평균화 주문을 추가

* 이를 통해 설계할 수 있습니다:
* 완전 자동 루프 전략(순수 웹훅)
* 수동 페일오버가 있는 신호 기반 봇

다층 종료를 가진 하이브리드 설정

* 실용적인 웹훅 전략 예시
* 예시 1: 일회성 주문 + 다중 이익실현(Bollinger Band 바운스)
* 목표:

### 가격이 하단 볼린저 밴드를 돌파하면 매수하고, 상승하면서 점진적으로 매도합니다.

#### goodcryptoX에서 설정

**트리거 조건 = 웹훅인 스탑-마켓 주문을 생성하세요** 세 개의 이익실현 목표를 추가하세요. TP 트리거 = 웹훅

**TradingView에서 설정**

* 네 개의 알림을 생성하세요:
* 가격이 하단 밴드를 돌파 → 메인 주문의

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FU5f3sdUx8rAIkSpfuLd0%2Fimage.png?alt=media&#x26;token=2772d1dd-038b-435b-bcd6-1aad6f95575d" alt="" width="563"><figcaption></figcaption></figure>

**트리거**

웹훅 URL로 전송

1. 가격이 밴드 내부로 돌아옴 → **이익실현 트리거로 전송** 가격이 중간 밴드를 횡단 →
2. 전송 **가격이 상단 밴드를 돌파 →** 가격이 중간 밴드를 횡단 →
3. 전송 **가격이 상단 밴드를 돌파 →** 가격이 중간 밴드를 횡단 →
4. goodcryptoX 웹훅 섹션의 특정 웹훅 URL을 붙여넣으세요. 메시지 필드는 그대로 두세요 — 사용되지 않습니다. **가격이 상단 밴드를 돌파 →** 가격이 중간 밴드를 횡단 →

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FW35WIYkwAwONvOjjPukZ%2Fimage.png?alt=media&#x26;token=8562ad00-e7fe-4d26-8a34-38eff5c05207" alt="" width="563"><figcaption></figcaption></figure>

TradingView에서 차트로 이동하세요 **전략, 지표 또는 조건을 기반으로 새 알림을 생성하세요**알림 설정에서 **체크박스를 활성화하세요**

예시 2: DCA 봇을 이용한 반복 전략(골든/데스 크로스)

#### 골든 크로스에서 롱 진입, 데스 크로스에서 숏 진입. 10% 이익으로 종료하거나 RSI > 70일 때 종료하고 무한 반복합니다.

**트리거 조건 = 웹훅인 스탑-마켓 주문을 생성하세요** DCA 봇 생성

**TradingView에서 설정**

진입 조건 = 웹훅

* 평균화 = 끔(0으로 설정)
* 이익실현 = 10%
* 손절 = 끔
* “TP 시 반복”을 활성화하세요
* 같은 차트에 세 개의 알림을 생성하세요:

**트리거**

* SMA50이 SMA200을 상향 돌파 →
  1. 웹훅으로 전송 **Enter Sell** SMA50이 SMA200을 하향 돌파 →
  2. 웹훅으로 전송 **— 활성 포지션(롱 또는 숏)을 종료합니다** SMA50이 SMA200을 하향 돌파 →
  3. RSI > 70 → **취소** SMA50이 SMA200을 하향 돌파 →

{% hint style="info" %}
전송

DCA 봇은 동시에 한 포지션만 보유합니다. 포지션 중에는 포지션이 닫힐 때까지 새로운 진입 웹훅을 무시합니다.
{% endhint %}

### 동일한 종목에서 롱과 숏 포지션을 병렬로 열고 싶다면 — 두 개의 별도 봇을 생성하고 하나에는 Enter Buy를, 다른 하나에는 Enter Sell을 보내세요

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

### PRO 플랜 이상 필요

#### **비디오 튜토리얼**

{% embed url="<https://youtu.be/JDkJFOwjjzk?si=m0GBGwTt6GTau-9X>" %}

#### **웹훅 거래 소개**

{% embed url="<https://youtu.be/gHXB2S6qdXU?si=i9ZobjRsxFAe7zcJ>" %}

#### **웹훅과 함께 DCA 봇 사용**

{% embed url="<https://youtu.be/xF-O7ZDoDtU?si=apfiF8uyTn-p4Vh4>" %}