🔗웹후크

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

웹훅을 프로그래머블 API(예: "3 BTC 매수" 같은 파라미터화된 명령을 보내는 방식)처럼 취급하는 일부 구현과 달리, goodcryptoX는 현재 트리거 기반 모델을 지원합니다. 각 웹훅은 특정 주문 또는 봇에서 미리 정의된 동작만 단순히 활성화하며 — 어떠한 파라미터나 명령도 해석하지 않습니다.

가까운 미래에, 웹훅을 통한 전체 전략 지시(동적 심볼 선택, 수량, 주문 유형, 멀티 심볼 로직 포함)를 지원하는 새로운 TradingView Strategy 봇을 출시할 예정입니다 — 사실상 API 레이어처럼 동작합니다. 기대해 주세요

현재는 TradingView 서버에서 오는 웹훅만 허용됩니다 — 커스텀 IP나 외부 소스는 불가합니다. 커스텀 웹훅 소스를 사용해야 한다면 아래로 문의해 주세요 [email protected] 액세스 요청을 위해.

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

• 모든 주문 또는 봇 동작 은 자체 전용 웹훅 URL을 가집니다

• URL을 받으려면 먼저 주문 또는 봇을 생성해야 합니다(그들은 Webhooks 의 주문 또는 봇 세부 정보)

• 해당 URL로 어떤 웹훅 페이로드를 보내더라도 해당 동작이 트리거됩니다

다음은 비디오 개요입니다:

웹훅 URL은 동작별입니다. 동작마다 하나의 웹훅을 생성해야 합니다. 예: 진입용 하나, 익절용 하나, 손절용 하나 등 각 봇 또는 주문마다 필요합니다

지원되는 주문 및 봇 동작

주문 또는 봇이 웹훅에 의해 트리거되길원한다면, 설정 중 트리거 조건으로 웹훅을 선택해야 합니다 해당 사항:

• 지정가 주문 트리거

• 트레일링 주문 활성화(트레일링 시작)

• 익절 및 손절 트리거

• DCA 봇 진입 조건

취소 웹훅 — 모든 주문과 봇에서 항상 사용 가능

포지션 종료 웹훅 — DCA 봇 세부 정보에서 항상 사용 가능

생성 후, 사용 가능한 모든 웹훅 URL은 세부 정보 에서 확인할 수 있습니다:

요약:

동작	지원 여부	비고
주문 취소	✅	세부 정보에 항상 표시
지정가 주문 트리거	✅	설정 시 웹훅 선택 필수
트레일링 주문 활성화	✅	트레일링 시작 = 웹훅
익절/손절 트리거	✅	옵션으로 웹훅 트리거 가능
DCA 봇 - 진입	✅	웹훅을 통한 매수/매도 진입(설정 시 지정 필요)
DCA 봇 - 종료	✅	웹훅을 통한 포지션 종료(항상 사용 가능)

웹훅으로 여러 익절 타겟 사용

트리거 방법으로 웹훅을 사용해 익절 그룹을 설정하면, 모두 동일한 웹훅 URL을 공유합니다. 웹훅이 트리거될 때마다 순서상의 다음 TP 주문이 실행됩니다 — 하나씩 순차적으로.

TradingView에서 알림 설정 방법

goodcryptoX에서 주문 또는 봇을 생성하고 특정 동작에 대한 웹훅 URL을 복사했다면, 이를 TradingView 알림에 연결하는 방법은 다음과 같습니다:

1. TradingView에서 차트로 이동

2. 전략, 인디케이터 또는 조건을 기반으로 새 알림 생성

3. 에서 알림 설정의 체크박스 “Webhook URL”

4. goodcryptoX의 특정 웹훅 URL을 붙여넣으세요 사용 가능 웹훅 섹션

5. 의 메시지 필드 는 그대로 두세요(내용은 아무거나 상관없습니다 — goodcryptoX는 현재 페이로드를 무시합니다)

6. 알림 저장

반복 전략(DCA 봇 사용)

웹훅으로 트리거되는 주문(예: TP와 SL이 있는 지정가)은 1회성 설정입니다. 주문이 실행되고 연결된 TP 또는 SL이 발동하면 전체 거래는 완료됩니다. 이 구조가 자동으로 반복되길원한다면, 주문만으로는 불가능합니다 — 하지만 현재 DCA 봇을 사용해 구현할 수 있습니다.

곧 반복적인 다중 동작 거래를 지원하는 전용 TradingView 전략 봇을 도입할 예정이지만, 그때까지는 DCA 봇이 웹훅 기반 전략을 반복하는 유연한 방법을 제공합니다.

순수 웹훅 루프

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

1. 다음 설정 진입 조건 = 웹훅

2. 다음 설정 평단가 조절 주문 = 0(평단가 조절 비활성화)

3. 다음 둘 다 비활성화 익-절 및 손절

4. 활성화 "포지션 종료 시 반복"

봇이 실행되면, 봇의 세부 정보 → Webhooks 섹션에서 다음 웹훅 URL을 볼 수 있습니다:

• 매수 진입 — 롱 포지션을 엽니다

• 포지션 종료 — 활성 포지션(롱 또는 숏)을 종료합니다

• 취소 — 봇을 중지합니다

실행 로직

• 봇이 매수 진입을(를) 받으면, 롱 포지션을 엽니다.

• 봇은 대기 상태에서 받은 첫 번째 진입 웹훅에만 응답 합니다.

• 포지션이 열려 있는 동안:

  • 추가 진입 신호는 모두 무시됨

  • 허용되는 신호는 포지션 종료 또는 설정된 경우 TP/SL 발동뿐입니다

• 포지션이 종료되면(수동, 웹훅, 또는 SL/TP로), 봇은 리셋되고 다음 진입 웹훅을 대기합니다.

이 루프는 봇이 활성 상태인 한 계속되어, 진입 → 종료 → 리셋 사이클을 무기한 반복할 수 있게 합니다.

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

DCA 봇은 유연한 전략 구성을 위해 결합 가능한 여러 제어 레이어를 지원합니다:

• 진입: 웹훅, 신호, 또는 즉시

• 종료: 웹훅 또는 내장 가격 기반 TP/SL

• 평단가 조절: 선택 사항; 비활성화 가능

다음이 가능합니다:

• 웹훅 신호만으로 봇 운영(진입 및 종료)

• 웹훅 종료를 사용하더라도 가격 기반 TP/SL을 폴백으로 추가

• 추가 보호를 위한 평단가 조절 주문 추가

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

• 완전 자동 루프 전략(순수 웹훅)

• 신호 기반 봇 + 수동 페일오버

• 다층 종료가 있는 하이브리드 설정

실용적인 웹훅 전략 예시

예시 1: 1회성 주문 + 다중 익절(볼린저 밴드 반등)

목표: 가격이 하단 볼린저 밴드를 이탈하면 매수, 상승하면서 점진적으로 매도.

goodcryptoX에서의 설정

• 트리거 조건 = 웹훅인 지정가 주문 생성

• 익절 타겟 3개 추가. TP 트리거 = 웹훅

TradingView에서의 설정

알림 4개 생성:

1. 가격이 하단 밴드를 이탈 → 메인 주문의 트리거 웹훅 URL로 전송

2. 가격이 밴드 내부로 복귀 → 익절 트리거 웹훅 URL로 전송

3. 로 전송 익절 트리거 웹훅 URL로 전송

4. 가격이 중단선을 돌파 → 전송 대상 익절 트리거 웹훅 URL로 전송

에서 알림 설정의 체크박스 “Webhook URL”

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

예시 2: DCA 봇으로 반복 전략(골든/데드 크로스)

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

goodcryptoX에서의 설정

DCA 봇 생성

• 진입 조건 = 웹훅

• 평단가 조절 = 끔(0으로 설정)

• 익절 = 10%

• 손절 = 끔

• 활성화: "TP 시 반복"

TradingView에서의 설정

• 동일 차트에서 세 가지 알림 생성:

  1. SMA50이 SMA200을 상향 교차 → 전송 대상 매수 진입 웹훅

  2. SMA50이 SMA200을 하향 교차 → 전송 대상 매도 진입 웹훅

  3. RSI > 70 → 전송 대상 포지션 종료 웹훅

요약

개념	설명
트리거 모델	각 동작은 자체 웹훅 URL 보유
설정 흐름	주문 생성 → 웹훅 URL 복사 → TradingView 알림에 붙여넣기
반복 전략	반복 활성화된 DCA 봇 사용