# 웹훅 goodcryptoX는 TradingView 웹훅을 통해 거래 동작을 자동화할 수 있게 해줍니다 — 신호에서 직접 주문 및 봇 동작을 트리거하는 강력한 메커니즘입니다. 일부 구현이 웹훅을 매개변수화된 명령("BTC 3개 매수"처럼)을 보내는 프로그래머블 API처럼 취급하는 것과 달리, goodcryptoX는 현재 트리거 기반 모델을 지원합니다. 각 웹훅은 특정 주문이나 봇에서 미리 정의된 동작을 단순히 활성화할 뿐이며 — 매개변수나 명령은 해석되지 않습니다. > 가까운 시일 내에 우리는 새로운 [TradingView 전략 봇](/goodcryptox-ko/perp-dex-1/upcoming-functionality/tradingview.md) 을 출시할 예정이며, 웹훅을 통한 동적 심볼 선택, 수량, 주문 유형 및 다중 심볼 로직을 포함한 전체 전략 지시를 지원하여 사실상 API 계층처럼 작동할 것입니다. 계속 지켜봐 주세요 ### 보안 및 접근 * 현재 웹훅은 TradingView 서버에서만 수락됩니다 — 사용자 지정 IP나 외부 소스는 허용되지 않습니다. * 사용자 지정 웹훅 소스를 사용해야 하는 경우, 로 연락하여 접근을 요청하세요. * 웹훅은 활성 PRO [플랜](/goodcryptox-ko/ecosystem/subscription-plans.md) 이상 사용자에게만 제공됩니다. ### goodcryptoX에서 웹훅이 작동하는 방식 * 각 주문 또는 봇 **동작** 에는 전용 웹훅 URL이 있습니다 * URL을 받으려면 먼저 주문이나 봇을 생성해야 합니다(해당 URL은 **웹훅** 섹션에 나타납니다) **세부정보**) * 해당 URL로 **임의의** 웹훅 페이로드를 보내면 그 동작이 트리거됩니다 > 웹훅 URL은 사용자별이 아니라 동작별입니다. 동작당 하나의 웹훅을 생성해야 합니다. 예: 진입용 하나, 이익실현용 하나, 손절용 하나 등 각 봇이나 주문마다 별도 생성해야 합니다 ### 지원되는 주문 및 봇 동작 주문이나 봇이 **웹훅에 의해**트리거되기를 원하면 **설정 중 트리거 조건으로 웹훅을 선택해야 합니다**이것은 다음에 적용됩니다: * 스탑-마켓 / 스탑-리밋 주문 트리거 * 트레일링 주문 활성화(트레일링 시작) * 이익실현 및 손절 트리거 * DCA 봇의 진입 조건
생성 후, 모든 사용 가능한 웹훅 URL은 귀하의 **세부정보** 주문 또는 봇의
> **세부정보** 섹션에서 찾을 수 있습니다: > > **취소** 웹훅 — 모든 주문 및 봇에서 항상 사용 가능 포지션 종료 | 웹훅 — 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 전략 봇](/goodcryptox-ko/cex-1/upcoming-functionality/tradingview.md) 을 도입할 예정이지만, 그동안 DCA 봇은 웹훅 기반 전략을 반복할 수 있는 유연한 방법을 제공합니다. #### 순수 웹훅 루프 웹훅으로 진입하고 웹훅으로 종료한 다음 반복하는 봇을 설정하려면: 1. 진입 조건을 **= 웹훅으로 설정하세요** 평균화 주문 2. 진입 조건을 **= 0 (평균화 비활성화)** 다음 둘 다 비활성화하세요 3. 이익실현 **및**-**손절** “포지션 종료 시 반복”을 **활성화하세요** 4. 봇이 시작되면 다음 웹훅 URL들을 봇의 **세부정보 → 웹훅**
섹션에서 보게 될 것입니다: **Enter Buy** — 롱 포지션을 엽니다 * **Enter Sell** — 숏 포지션을 엽니다 * **— 활성 포지션(롱 또는 숏)을 종료합니다** — 봇을 중지합니다 * **취소** 실행 로직 * **세부정보** 봇이 **를 수신하면, 롱 포지션을 엽니다.** * 봇이 **Enter Sell**를 수신하면, 숏 포지션을 엽니다. * 봇은 **— 활성 포지션(롱 또는 숏)을 종료합니다**휴지 상태일 때 수신하는 첫 번째 진입 웹훅에만 응답합니다. * 포지션이 열려 있는 동안: **추가 진입 신호는** 무시됩니다 * 봇은 진입 신호로 현재 포지션을 증가시키거나 역전하지 않습니다 * 허용되는 신호는 오직 **포지션 종료** * 또는 트리거된 TP/SL(구성된 경우)입니다 * 포지션이 종료되면(수동, 웹훅 또는 SL/TP에 의해) 봇은 리셋되고 다음 진입 웹훅을 기다립니다. **이 루프는 봇이 활성 상태인 한 계속되며, 완전한 진입 → 종료 → 리셋 사이클을 무기한 반복할 수 있게 합니다.** 순수 웹훅 모드 vs 하이브리드 설정 * DCA 봇은 유연한 전략을 구성하기 위해 결합할 수 있는 여러 제어 레이어를 지원합니다: 진입 #### : 웹훅, 시그널 또는 가능한 즉시(asap)를 통해 종료 * **: 웹훅 또는 내장 가격 기반 TP/SL로**평균화 * **: 선택 사항; 비활성화 가능**다음과 같은 작업을 할 수 있습니다: * **진입 및 종료 모두 웹훅 신호로만 봇을 실행**웹훅 종료를 사용하더라도 예비 조치로 가격 기반 TP/SL을 추가 추가 보호를 위해 평균화 주문을 추가 * 이를 통해 설계할 수 있습니다: * 완전 자동 루프 전략(순수 웹훅) * 수동 페일오버가 있는 신호 기반 봇 다층 종료를 가진 하이브리드 설정 * 실용적인 웹훅 전략 예시 * 예시 1: 일회성 주문 + 다중 이익실현(Bollinger Band 바운스) * 목표: ### 가격이 하단 볼린저 밴드를 돌파하면 매수하고, 상승하면서 점진적으로 매도합니다. #### goodcryptoX에서 설정 **트리거 조건 = 웹훅인 스탑-마켓 주문을 생성하세요** 세 개의 이익실현 목표를 추가하세요. TP 트리거 = 웹훅 **TradingView에서 설정** * 네 개의 알림을 생성하세요: * 가격이 하단 밴드를 돌파 → 메인 주문의
**트리거** 웹훅 URL로 전송 1. 가격이 밴드 내부로 돌아옴 → **이익실현 트리거로 전송** 가격이 중간 밴드를 횡단 → 2. 전송 **가격이 상단 밴드를 돌파 →** 가격이 중간 밴드를 횡단 → 3. 전송 **가격이 상단 밴드를 돌파 →** 가격이 중간 밴드를 횡단 → 4. goodcryptoX 웹훅 섹션의 특정 웹훅 URL을 붙여넣으세요. 메시지 필드는 그대로 두세요 — 사용되지 않습니다. **가격이 상단 밴드를 돌파 →** 가격이 중간 밴드를 횡단 →
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="" %} #### **웹훅 거래 소개** {% embed url="" %} #### **웹훅과 함께 DCA 봇 사용** {% 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/cex-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.