> 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-dex-1/webhooks.md). # 웹훅 goodcryptoX는 TradingView 웹훅을 통해 거래 동작을 자동화할 수 있게 해줍니다 — 신호에서 직접 주문과 봇 동작을 트리거하는 강력한 메커니즘입니다. 일부 구현이 웹훅을 "buy 3 BTC"처럼 매개변수화된 명령을 보내는 프로그래머블 API처럼 취급하는 것과 달리, goodcryptoX는 현재 트리거 기반 모델을 지원합니다. 각 웹훅은 특정 주문 또는 봇의 미리 정의된 동작을 활성화할 뿐이며 — 매개변수나 명령은 해석되지 않습니다. 가까운 미래에 우리는 새로운 [TradingView 전략 봇](/goodcryptox-ko/perp-dex-1/upcoming-functionality/tradingview.md) 을 출시할 예정이며, 여기에선 웹훅을 통해 동적 심볼 선택, 수량, 주문 유형 및 다중 심볼 로직을 포함한 전체 전략 지시를 지원하여 사실상 API 계층처럼 작동합니다. 계속 지켜봐 주세요 > 현재 웹훅은 TradingView 서버에서 오는 것만 허용됩니다 — 커스텀 IP나 외부 소스는 허용되지 않습니다.\ > 커스텀 웹훅 소스를 사용해야 하는 경우, 다음으로 연락해 주세요 액세스를 요청하려면. ### goodcryptoX에서 웹훅이 작동하는 방식 * 모든 주문 또는 봇 **동작** 은 고유한 전용 웹훅 URL을 가집니다 * URL을 받으려면 먼저 주문이나 봇을 생성해야 합니다(해당 URL은 **웹훅** 섹션에 표시됩니다) **세부정보**) * 그 URL로 **임의의** 웹훅 페이로드를 보내면 그 동작이 트리거됩니다 > 웹훅 URL은 사용자별이 아니라 동작별입니다. 각 동작마다 하나의 웹훅을 생성해야 합니다. 예: 진입 하나, 이익실현 하나, 손절 하나 등 각 봇 또는 주문마다 각각 생성해야 합니다 ### 지원되는 주문 및 봇 동작 주문 또는 봇이 **웹훅으로**트리거되도록 **하려면 설정 중에 트리거 조건으로 웹훅을 선택해야 합니다**이것은 다음에 적용됩니다: * 스탑-마켓 / 스탑-리밋 주문 트리거 * 트레일링 주문 활성화 (트레일링 시작) * 이익실현 및 손절 트리거 * DCA 봇 진입 조건
생성 후 모든 사용 가능한 웹훅 URL은 **세부정보** 주문 또는 봇의 다음 위치에서 확인할 수 있습니다:
> **취소** 웹훅 — 모든 주문과 봇에서 항상 사용 가능 > > **포지션 종료** 웹훅 — DCA 봇 세부정보에서 항상 사용 가능 요약하면: | 동작 | 지원 여부? | 메모 | | ------------- | ------ | ---------------------------- | | 주문 취소 | ✅ | 세부정보에 항상 표시됨 | | 스탑 주문 트리거 | ✅ | 설정 시 웹훅 선택 필요 | | 트레일링 주문 활성화 | ✅ | 트레일링 시작 = 웹훅 | | 이익실현 / 손절 트리거 | ✅ | 선택적으로 웹훅으로 트리거 가능 | | DCA 봇 - 진입 | ✅ | 웹훅을 통한 진입 매수/매도 (설정 시 지정 필요) | | DCA 봇 - 종료 | ✅ | 웹훅을 통한 포지션 종료 (항상 사용 가능) | | 그리드 봇 - 진입 | 🚫 | 아직 지원되지 않음 | {% hint style="info" %} **웹훅으로 다중 이익실현 목표** 웹훅을 트리거 방식으로 사용하여 이익실현 그룹을 설정하면, 해당 그룹은 모두 동일한 웹훅 URL을 공유합니다. 웹훅이 트리거될 때마다 시퀀스의 다음 TP 주문이 순차적으로 실행됩니다 — 한 번에 하나씩. {% endhint %} ### TradingView에서 알림을 설정하는 방법 goodcryptoX에서 주문 또는 봇을 생성하고 특정 동작의 웹훅 URL을 복사한 후, TradingView 알림에 연결하는 방법은 다음과 같습니다: 1. TradingView에서 차트로 이동하세요 2. 전략, 인디케이터 또는 조건을 기반으로 새 알림을 만드세요 3. 알림 **설정에서**체크박스를 활성화하세요 **“웹훅 URL”** 4. goodcryptoX 웹훅 섹션에서 특정 웹훅 URL을 붙여넣으세요 5. 메시지 **필드는** 그대로 두세요 (내용은 상관없습니다 — 현재 goodcryptoX는 페이로드를 무시합니다) 6. 알림을 저장하세요 ### 반복 전략 (DCA 봇을 통해) 웹훅으로 트리거된 주문(예: TP 및 SL이 포함된 스탑-마켓)은 **한 번의 설정**입니다. 주문이 실행되고 연계된 TP 또는 SL이 발동되면 전체 거래는 완료됩니다. 이 구조를 **자동으로 반복**되게 하려면, 주문으로는 불가능하지만 — DCA 봇을 사용하면 지금 가능 합니다. 곧 반복되는 다중 동작 거래를 지원하는 전용 [TradingView 전략 봇](/goodcryptox-ko/perp-dex-1/upcoming-functionality/tradingview.md) 을 도입할 예정이지만, 그동안 DCA 봇은 웹훅 기반 전략을 반복하는 유연한 방법을 제공합니다. #### 순수 웹훅 루프 웹훅으로 진입하고 웹훅으로 종료한 다음 반복하는 봇을 설정하려면: 1. 다음으로 설정하세요 **진입 조건** = 웹훅 2. 다음으로 설정하세요 **평균화 주문** = 0 (평균화 비활성화) 3. 다음 둘 다 비활성화하세요 **이익**-**실현** 및 **손절** 4. 다음을 활성화하세요 **“포지션 종료 시 반복”**
봇이 시작되면, 봇의 **세부정보 → 웹훅** 섹션 아래에서 다음 웹훅 URL을 보게 됩니다: * **Enter Buy** — 롱 포지션을 엽니다 * **Enter Sell** — 숏 포지션을 엽니다 * **포지션 종료** — 활성 포지션(롱 또는 숏)을 종료합니다 * **취소** — 봇을 정지시킵니다 **실행 로직** * 봇이 **Enter Buy**를 수신하면, 롱 포지션을 엽니다. * 봇이 **Enter Sell**를 수신하면, 숏 포지션을 엽니다. * 봇은 **유휴 상태에서 수신하는 최초의 진입 웹훅에만 반응합니다.** 포지션이 열려 있는 동안: * 추가적인 모든 진입 신호는 * 무시됩니다 **봇은 진입 신호로 현재 포지션을 증가시키거나 반전시키지 않습니다** * 허용되는 유일한 신호는 * 포지션 종료 **또는 설정된 경우 트리거된 TP/SL 입니다** 포지션이 종료되면(수동, 웹훅 또는 SL/TP로), 봇은 리셋되어 다음 진입 웹훅을 대기합니다. * 이 루프는 봇이 활성 상태인 한 계속되며, 완전한 진입 → 종료 → 리셋 사이클을 무기한 반복할 수 있게 합니다. 순수 웹훅 모드 대 하이브리드 설정 #### DCA 봇은 유연한 전략을 구성하기 위해 결합할 수 있는 여러 제어 레이어를 지원합니다: 진입 * **: 웹훅, 신호 또는 ASAP(가능한 즉시)으로**종료 * **: 웹훅 또는 내장된 가격 기반 TP/SL로**평균화 * **: 선택 사항; 비활성화 가능**당신은 다음을 할 수 있습니다: 진입과 종료를 모두 웹훅 신호로만 작동시키는 봇을 실행 * 웹훅 종료를 사용하더라도 가격 기반 TP/SL을 폴백으로 추가 * 추가 보호를 위해 평균화 주문을 추가 * 이를 통해 다음을 설계할 수 있습니다: 완전 자동 루프 전략(순수 웹훅) * 신호 기반 봇에 수동 페일오버를 포함한 구성 * 다중 레이어 종료를 가진 하이브리드 설정 * 실용적인 웹훅 전략 예시 ### 예시 1: 일회성 주문 + 다중 이익실현 (볼린저 밴드 반등) #### 목표: **가격이 하단 볼린저 밴드를 돌파하면 매수하고, 가격이 상승할 때 점진적으로 매도합니다.** goodcryptoX에서의 설정 **트리거 조건 = 웹훅인 스탑-마켓 주문을 생성하세요** * 세 개의 이익실현 타깃을 추가하세요. TP 트리거 = 웹훅 * TradingView에서의 설정
**네 개의 알림을 만드세요:** 가격이 하단 밴드를 돌파 → 메인 주문의 1. 트리거 **웹훅 URL로 전송** 가격이 밴드 내부로 돌아옴 → 2. 이익실현 트리거로 전송 **가격이 중간 밴드를 교차 →** 가격이 밴드 내부로 돌아옴 → 3. 전송 **가격이 중간 밴드를 교차 →** 가격이 밴드 내부로 돌아옴 → 4. 가격이 상단 밴드를 돌파 → **가격이 중간 밴드를 교차 →** 가격이 밴드 내부로 돌아옴 →
알림 **설정에서**체크박스를 활성화하세요 **“웹훅 URL”** goodcryptoX 웹훅 섹션에서 특정 웹훅 URL을 붙여넣으세요. 메시지 필드는 그대로 두세요 — 사용되지 않습니다. #### 예시 2: DCA 봇을 이용한 반복 전략 (골든/데스 크로스) **가격이 하단 볼린저 밴드를 돌파하면 매수하고, 가격이 상승할 때 점진적으로 매도합니다.** 골든 크로스에서 롱 진입, 데스 크로스에서 숏 진입. 10% 이익으로 종료하거나 RSI > 70일 때 종료하고 반복합니다. **트리거 조건 = 웹훅인 스탑-마켓 주문을 생성하세요** DCA 봇 생성 * 진입 조건 = 웹훅 * 평균화 = 끔 (0으로 설정) * 이익실현 = 10% * 손절 = 끔 * “TP 시 반복” 활성화 **네 개의 알림을 만드세요:** * 같은 차트에서 세 개의 알림을 만드세요: 1. SMA50이 SMA200을 상향 돌파 → **Enter Buy** 웹훅으로 전송 2. SMA50이 SMA200을 하향 돌파 → **Enter Sell** 웹훅으로 전송 3. RSI > 70 → **포지션 종료** 웹훅으로 전송 {% hint style="info" %} DCA 봇은 한 번에 하나의 포지션만 보유합니다. 포지션이 열려 있는 동안에는 포지션이 종료될 때까지 새로운 진입 웹훅을 무시합니다. 동일한 종목에서 롱과 숏 포지션을 병렬로 진입하려면 — 두 개의 별도 봇을 생성하고 Enter Buy를 하나에, Enter Sell을 다른 하나에 보내세요 {% endhint %} ### 요약 | 개념 | 설명 | | ------ | ---------------------------------------- | | 트리거 모델 | 각 동작마다 고유한 웹훅 URL을 가집니다 | | 설정 흐름 | 주문 생성 → 웹훅 URL 복사 → TradingView 알림에 붙여넣기 | | 반복 전략 | 반복 활성화된 DCA 봇 사용 | ### 비디오 튜토리얼 #### **웹훅 거래 소개** {% embed url="" %} #### **웹훅과 함께 DCA 봇 사용하기** {% embed url="" %} #### **웹훅으로 다중 이익실현** {% embed url="" %}