AlgoVesta › 용어집 › Webhook

시그널 & 자동화

Webhook

웹훅은 한 애플리케이션이 이벤트가 발생하는 순간 다른 애플리케이션의 URL로 보내는 자동화된 HTTP 요청입니다. 트레이딩에서는 전략이나 지표 알림이 발동하면 TradingView가 자동화 플랫폼으로 웹훅을 전송하여, 아무도 버튼을 클릭하지 않아도 주문이 실행될 수 있게 합니다.

왜 중요한가

이메일, 앱 알림, 소리로 오는 알림은 여전히 사람이 직접 행동에 옮겨야 합니다. 웹훅은 알림의 메시지 본문을 실행 플랫폼으로 곧바로 전달하며, 이것이 바로 TradingView 전략을 자동화된 전략으로 바꿔주는 요소입니다. 메시지 본문은 사용자가 직접 제어할 수 있습니다: "BTCUSDT LONG"과 같은 고정 텍스트일 수도 있고, TradingView가 알림 시점에 채워 넣는 자리표시자(심볼, 가격, 액션, 포지션 크기)가 있는 JSON 페이로드일 수도 있습니다. 수신 측 플랫폼은 이 본문을 파싱하여 사용자의 규칙과 대조한 뒤 매매를 실행합니다.

AlgoVesta의 처리 방식

각 AlgoVesta 전략에는 시크릿 토큰이 포함된 고유한 웹훅 URL이 부여됩니다. 이를 TradingView 알림의 "Webhook URL" 필드에 붙여넣고, 대시보드에 있는 JSON 템플릿을 메시지 상자에 넣으면 됩니다. 들어오는 요청은 TradingView가 공개한 IP 주소에서 오거나 사용자가 화이트리스트로 등록한 IP에서 오는 등 소스를 검증할 수 있는 경우에만 실계좌 실행에 사용됩니다. 그 외의 요청은 기록만 되고 거래되지는 않습니다. 페이로드는 심볼, 방향, 진입 힌트, 손절, 익절로 파싱된 뒤 해당 전략에 대해 사용자가 선택한 대상, 즉 암호화폐 거래소 계좌 또는 MetaTrader 5 계좌로 라우팅됩니다. 전략 종료("flat")는 반대 방향을 여는 대신 보유 중인 포지션을 청산하며, 동일한 로직이 페이퍼 모드에서도 실행되므로 실계좌로 전환하기 전에 알림을 처음부터 끝까지 테스트할 수 있습니다. 시그널은 100밀리초(ms)를 훨씬 밑도는 시간 안에 수신되어 파싱됩니다. 평균적으로 주문은 암호화폐 거래소에서는 약 4.1초, MT5에서는 약 1.2초 만에 거래소에 도달합니다. 설정 절차는 TradingView 봇 페이지와 웹훅 설정 가이드에 있습니다.

예시

알림 메시지: {"symbol":"{{ticker}}","side":"buy","price":{{close}},"stop_loss":{{plot_0}},"take_profit":{{plot_1}}}. ETHUSDT 차트에서 전략이 발동하면 TradingView가 자리표시자를 실제 값으로 채워 해당 전략의 URL로 JSON을 전송합니다. AlgoVesta는 설정된 100달러 증거금으로 롱 포지션을 열고, 두 개의 플롯(plot)에서 가져온 손절과 목표를 걸어 두며, 몇 초 안에 대시보드에 매매를 표시합니다.

흔한 실수

실제 활용

TradingView 봇 →