멱등성

멱등성이란 동일한 작업을 두 번 이상 수행해도 한 번 수행한 것과 같은 결과가 나오는 성질을 말합니다. 거래 자동화에서 이는 신호가 두 번 전달되거나, 네트워크 오류 이후 주문 요청이 두 번 전송되었을 때 결과적으로 두 개가 아니라 하나의 포지션만 생성되는 성질입니다.

왜 중요한가

메시징 시스템에서 중복은 흔한 일입니다. Telegram은 수정된 메시지를 새로운 이벤트로 전달할 수 있고, 웹훅 발신자는 빠른 승인 응답을 받지 못하면 재시도하며, 트레이더가 "테스트 신호 보내기"를 두 번 클릭할 수도 있습니다. 멱등성이 없다면 각 중복은 실제 증거금이 걸린 진짜 주문이 됩니다. 이 문제는 시스템이 스트레스를 받는 상황, 즉 거래 장소가 느려지거나 장애가 발생할 때 정확히 가장 심각해지는데, 이때 재시도와 중복 전달이 늘어나기 때문입니다.

AlgoVesta의 처리 방식

AlgoVesta는 여러 지점에서 멱등성을 적용합니다. 수신되는 Telegram 메시지는 메시지 식별자로 기록되므로 동일한 메시지가 두 번 처리되지 않습니다. 중복 방지 장치는 짧은 시간 창 내의 동일한 계정, 심볼, 방향에 대한 두 번째 신호를 거부하여 재게시나 이중 클릭을 흡수합니다. 이 거부는 조용히 폐기되는 것이 아니라 그 사유와 함께 기록됩니다. 주문 접수는 애매한 실패 이후 무작정 재시도되지 않습니다. 플랫폼은 다시 조치를 취하기 전에 거래소의 포지션과 거래 내역을 대조하여 해당 주문이 실제로 존재하는지 판단합니다. 각 전략은 자신만의 웹훅 토큰을 가지며, 각 실행은 그것을 유발한 신호와 연결되어 있어 동일한 신호가 두 경로에서 실행될 수 없습니다. 재시도 로직과 TradingView 봇 페이지를 참고하십시오.

예시

1분봉 차트에 설정된 TradingView 알림이 전략 설정으로 인해 동일한 봉 안에서 동일한 메시지로 두 번 발동됩니다. 첫 번째 요청은 ETHUSDT에 롱 포지션을 엽니다. 두 번째 요청은 20초 후 도착하며, 시간 창 내에서 동일한 심볼 및 방향으로 인해 중복 방지 장치에 의해 거부됩니다. 이는 신호 로그에 중복 사유와 함께 차단됨으로 표시되며, 두 번째 포지션은 열리지 않습니다.

흔한 실수

• 신호 소스가 절대 중복을 보내지 않을 것이라고 신뢰하는 것.
• 멱등성 없이 재시도 로직을 구축하여 재시도할 때마다 새로운 주문이 생성되는 것.
• 중복 판단 시간 창을 너무 넓게 잡아 정당한 물타기(scaling-in) 신호가 거부되거나, 너무 좁게 잡아 웹훅 재시도가 통과되게 만드는 것.
• 중복 제거 상태를 메모리에만 보관하여, 재시작 시 이미 실행된 내용을 잊어버리는 것.