AlgoVesta › 용어집 › 알림 문법

시그널 & 자동화

알림 문법

알림 구문이란 시그널 소스가 거래를 설명하기 위해 사용하는 정확한 텍스트 형식을 말합니다. 예를 들어 TradingView 알림이 웹훅으로 보내는 JSON 메시지나 Telegram 채널이 따르는 키워드 패턴이 이에 해당합니다. 수신 플랫폼은 이 구문을 파싱하여 심볼, 방향, 진입가, 손절(SL), 익절(TP)로 변환합니다.

왜 중요한가

자동화는 발신자와 수신자가 형식에 합의해야만 작동합니다. TradingView는 원하는 메시지를 자유롭게 작성할 수 있게 해주며, 알림 발생 시점에 티커나 종가 같은 자리표시자를 채워 넣습니다. 메시지에 어느 방향으로 거래해야 하는지 표시되어 있지 않거나 수신 측이 알지 못하는 필드명을 사용하면, 알림은 도착하지만 아무 일도 일어나지 않습니다. TradingView의 기본 텍스트("BTCUSDT Crossing 60000")에는 방향 정보가 전혀 없습니다. Telegram에는 표준이 없기 때문에 구문은 해당 채널이 습관적으로 작성하는 방식에 따라 달라지며, 그 습관의 작은 변화만으로도 파싱이 깨질 수 있습니다.

AlgoVesta의 처리 방식

TradingView의 경우 AlgoVesta는 전략별로 자리표시자가 이미 채워진 JSON 템플릿을 제공합니다: 티커에서 가져온 심볼, 방향(side), 종가로부터의 진입 힌트, 그리고 플롯 값이나 고정값으로부터의 선택적 손절(SL)·익절(TP)입니다. 이 템플릿은 대시보드에서 생성되며 알림의 메시지 상자에 그대로 복사해 넣을 수 있습니다. 보내지 않은 필드는 봇 자체의 규칙(예: 고정 퍼센트 손절)으로 대체됩니다. 방향을 파싱할 수 없는 알림 텍스트는 추측하지 않고 그 사유와 함께 거부(rejected)로 기록됩니다. Telegram의 경우 파서는 흔히 쓰이는 키워드 레이아웃, 이모지 표시, 목표가 목록, 손절 표기법을 인식하며, 모든 채널은 페이퍼(데모) 모드에서 테스트하여 각 메시지에서 무엇이 추출되었는지 확인할 수 있습니다. 자세한 내용은 TradingView 봇 페이지와 웹훅 설정 가이드에 있습니다.

예시

TradingView 전략이 다음 메시지로 구성되었습니다: {"symbol":"{{ticker}}","side":"{{strategy.order.action}}","price":{{close}},"stop_loss":{{plot_0}},"take_profit":{{plot_1}},"market_position":"{{strategy.market_position}}"}. ETHUSDT에서 롱 진입이 발동되면 TradingView는 채워진 JSON을 해당 전략의 웹훅 URL로 전송합니다. AlgoVesta는 side "buy", 진입 힌트, 두 플롯 값을 읽어 해당 레벨로 포지션을 엽니다. 기본 텍스트 "ETHUSDT Crossing 3100"으로 온 두 번째 알림은 방향이 없다는 이유로 거부됩니다.

흔한 실수

실제 활용

TradingView 봇 →