# 웹훅 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="" %} --- # 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-ko/perp-dex-1/webhooks.md?ask= ``` 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.