> 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-ko/perp-dexs/webhooks.md).

# 웹훅

goodcryptoX를 사용하면 TradingView 웹훅을 통해 거래 작업을 자동화할 수 있습니다 — 신호에서 직접 주문과 봇 작업을 실행하는 강력한 메커니즘입니다.

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

가까운 시일 내에 새로운 [TradingView 전략 봇](https://docs.goodcrypto.app/goodcryptox-ko/perp-dexs/upcoming-functionality/tradingview-strategy-bot.md) 웹훅을 통해 동적 심볼 선택, 수량, 주문 유형, 다중 심볼 로직을 포함한 전체 전략 지침을 지원하며 — 사실상 API 계층처럼 동작합니다. 기대해 주세요

> 현재 Webhook은 TradingView 서버에서만 허용됩니다 — 사용자 지정 IP나 외부 소스는 사용할 수 없습니다.\
> 사용자 지정 웹훅 소스를 사용해야 한다면, 다음으로 문의하세요 <support@goodcrypto.app> 접근 권한을 요청해 주세요.

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

* 모든 주문 또는 봇 **작업** 은 자체 전용 웹훅 URL을 가집니다
* URL을 얻으려면 먼저 주문 또는 봇을 생성해야 합니다(해당 URL은 **웹훅** 주문 또는 봇의 **상세 정보**)
* 전송 **임의의** 웹훅 페이로드를 해당 URL로 보내면 작업이 트리거됩니다

> 웹훅 URL은 사용자별이 아니라 작업별입니다. 각 작업마다 웹훅 하나씩 만들어야 합니다. 예: 진입용 하나, 익절용 하나, 손절용 하나 등 — 봇이나 주문마다 각각 필요합니다

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

주문 또는 봇이 **웹훅에 의해 트리거되도록 하려면**, 설정 시 웹훅을 **트리거 조건으로 선택해야 합니다**. 이는 다음에 적용됩니다:

* 스톱-마켓 / 스톱-리밋 주문 트리거
* 트레일링 주문 활성화(트레일링 시작)
* 익절 및 손절 트리거
* DCA 봇 진입 조건

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

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Wy7oFQzqruMDzwMqUPm%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" 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%2F9Wy7oFQzqruMDzwMqUPm%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

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

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

요약하면:

| 작업          | 지원 여부? | 비고                               |
| ----------- | ------ | -------------------------------- |
| 주문 취소       | ✅      | 상세 정보에 항상 표시됨                    |
| 스톱 주문 트리거   | ✅      | 설정 시 웹훅을 선택해야 함                  |
| 트레일링 주문 활성화 | ✅      | 트레일링 시작 = 웹훅                     |
| 익절 / 손절 트리거 | ✅      | 웹훅으로도 트리거 가능                     |
| 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이 있는 스톱-마켓 주문)은 **일회성 설정입니다**. 주문이 실행되고 연결된 TP 또는 SL이 발동되면 전체 거래가 완료됩니다. 이 구조를 **자동으로 반복**하려면, 주문으로는 불가능하지만 — DCA 봇을 사용하면 지금은 가능합니다.

곧 전용 [TradingView 전략 봇](https://docs.goodcrypto.app/goodcryptox-ko/perp-dexs/upcoming-functionality/tradingview-strategy-bot.md) 반복되는 다중 작업 거래를 지원할 예정입니다. 하지만 그 전까지는 DCA 봇이 웹훅 기반 전략을 반복하는 유연한 방법을 제공합니다.

#### 순수 웹훅 루프

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

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

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

봇을 시작하면, 봇의 **상세 정보 → 웹훅** 섹션에서 다음 웹훅 URL을 볼 수 있습니다:

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

**실행 로직**

* 봇이 다음을 수신하면 **매수 진입**, 그러면 롱 포지션을 엽니다.
* 봇이 다음을 수신하면 **매도 진입**, 그러면 숏 포지션을 엽니다.
* 봇은 **첫 번째 진입 웹훅에만 응답합니다** 유휴 상태일 때 수신한 것에만 응답합니다.
* 포지션이 열려 있는 동안:
  * 이후의 모든 진입 신호는 **무시됩니다**
  * 봇은 진입 신호로 현재 포지션을 늘리거나 반전하지 않습니다
  * 허용되는 신호는 **포지션 종료** 또는 트리거된 TP/SL(설정된 경우)뿐입니다
* 포지션이 종료되면(수동으로, 웹훅으로, 또는 SL/TP로) 봇은 초기화되어 다음 진입 웹훅을 기다립니다.

이 루프는 봇이 활성 상태인 한 계속되며, 완전한 진입 → 종료 → 초기화 사이클을 무기한 반복할 수 있습니다.

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

DCA 봇은 유연한 전략을 구축하기 위해 결합할 수 있는 여러 제어 계층을 지원합니다:

* **진입**: 웹훅, 신호 또는 즉시(asap)로
* **종료**: 웹훅 또는 내장된 가격 기반 TP/SL로
* **평단 조정**: 선택 사항이며 비활성화할 수 있음

다음이 가능합니다:

* 봇을 전적으로 웹훅 신호만으로 운영하기(진입 및 종료)
* 웹훅 종료를 사용하더라도 가격 기반 TP/SL을 대체 수단으로 추가하기
* 추가 보호를 위해 평단 조정 주문 추가하기

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

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

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

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

**목표:** 가격이 하단 볼린저 밴드를 돌파하면 매수하고, 상승할수록 점진적으로 매도합니다.

**goodcryptoX에서 설정**

* 트리거 조건 = 웹훅인 스톱-마켓 주문을 생성합니다
* 익절 목표를 3개 추가합니다. TP 트리거 = 웹훅

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Wy7oFQzqruMDzwMqUPm%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="563"><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%2F9Wy7oFQzqruMDzwMqUPm%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

에서 **알림 설정**, 체크박스를 활성화합니다 **“Webhook URL”**

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

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

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

**goodcryptoX에서 설정**

DCA 봇 생성

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

**TradingView에서 설정**

* 같은 차트에서 알림 3개를 생성합니다:
  1. SMA50이 SMA200을 상향 돌파 → 다음으로 전송 **매수 진입** 웹훅
  2. SMA50이 SMA200을 하향 돌파 → 다음으로 전송 **매도 진입** 웹훅
  3. RSI > 70 → 다음으로 전송 **포지션 종료** 웹훅

{% hint style="info" %}
DCA 봇은 한 번에 하나의 포지션만 보유합니다. 포지션 보유 중에는 포지션이 종료될 때까지 새로운 진입 웹훅을 무시합니다.

같은 종목에서 롱과 숏 포지션을 병행해서 진입하려면 - 서로 다른 두 봇을 생성하고 하나에는 매수 진입을, 다른 하나에는 매도 진입을 보내세요
{% endhint %}

### 요약

| 개념     | 설명                                       |
| ------ | ---------------------------------------- |
| 트리거 모델 | 각 작업마다 고유한 웹훅 URL이 있습니다                  |
| 설정 흐름  | 주문 생성 → 웹훅 URL 복사 → TradingView 알림에 붙여넣기 |
| 반복 전략  | 반복이 활성화된 DCA 봇 사용                        |

### 동영상 튜토리얼

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

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

#### **웹훅을 사용한 다중 익절**
