신호가 감지되면 자동으로 주문을 실행합니다. 내장된 안전 메커니즘과 오류 처리 기능을 갖춘 초고속 주문 배치.
신호 기반 주문 실행
MagicTradeBot은 시장 상황을 실시간으로 모니터링하며 특정 변동성 신호가 감지되는 즉시 자동으로 거래를 실행합니다. 봇은 4가지 서로 다른 액션 타입을 지원합니다:
지원되는 변동성 액션
- BUY – 롱 포지션 진입을 위한 표준 매수 신호
- SELL – 숏 포지션 진입을 위한 표준 매도 신호
- PUMP – 고변동성 상승 움직임 감지
- CRASH – 고변동성 하락 움직임 감지
이 신호들 중 하나라도 감지되면, 사용자가 설정한 거래 트리거 설정에 따라 봇이 즉시 주문 배치 절차를 시작합니다.
주문 유형 설정
봇은 사용자의 트레이딩 전략에 맞춰 3가지 유연한 주문 실행 모드를 제공합니다:
시장가 주문 (Type: 0)
최적의 현재 시장 가격으로 즉시 거래를 체결합니다. 가격 정확도보다 체결 확실성이 중요한 고변동성 상황에서의 초고속 진입에 이상적입니다.
지정가 주문 (Type: 1)
설정된 AskPriceBufferPer 값을 사용해 특정 가격에 주문을 배치합니다. TimeInForce 시간이 지나도 체결되지 않으면 주문이 만료됩니다.
설정값:
AskPriceBufferPer: 0.1 (현재 Ask 가격에서 0.1 % 조정)TimeInForce: 60초 (60초 후 미체결 시 주문 만료)
하이브리드 주문 (Type: 2)
두 방식의 장점을 결합한 지능형 폴백 실행:
- 초기 시도: 설정된 버퍼 비율로 지정가 주문을 배치
- 모니터링 단계:
TimeInForce기반 타이머를 실행해 체결 여부를 추적 - 스마트 폴백: 타이머 만료 시 지정가 주문이 부분 또는 전부 미체결 상태라면
- 미체결 수량에 대해 기존 지정가 주문을 취소
- 즉시 시장가 주문으로 대체하여 체결 보장
이 방식은 더 나은 가격을 추구하면서도 체결을 100 % 보장하여 빠르게 움직이는 시장에서 기회를 놓치지 않게 해줍니다.
Stop Loss & Take Profit 연동
봇은 SL/TP 주문을 자동으로 배치하여 포괄적인 리스크 관리를 제공합니다:
Stop Loss 보호
StopLossPercent > 0일 때, 메인 주문 체결 직후 자동으로 스탑로스 주문을 배치합니다. 과도한 하락 위험으로부터 포지션을 보호합니다.
예시: StopLossPercent: 2.0 → 롱 포지션은 진입가보다 2 % 하락, 숏 포지션은 2 % 상승 시 손절
Take Profit 목표
TakeProfitPercent > 0일 때, 목표 수익률에 도달하면 자동으로 이익을 실현하는 테이크 프로핏 주문을 배치합니다.
예시: TakeProfitPercent: 5.0 → 롱은 진입가보다 5 % 상승, 숏은 5 % 하락 시 익절
주문 생애주기 관리
주문이 배치된 후 MagicTradeBot은 이중 계층 모니터링으로 완전한 관리를 수행합니다:
i. 내부 주문 추적
모든 활성 주문은 두 곳에서 추적됩니다:
- 영구 저장소: 크래시 복구를 위해 YAML 파일에 기록
- 메모리 상태: 실시간 의사결정을 위한 인메모리 추적
봇은 주문 활동을 지속적으로 모니터링하며 다음 기준으로 지능형 결정을 내립니다:
시간 기반 결정
- 주문 경과 시간 및 만료 처리
- 포지션 정기 재평가
- 미체결 주문 타임아웃 관리
캔들 기반 결정
- 완성된 캔들 가격 움직임 분석
- 트렌드 반전 감지
- 거래량 및 모멘텀 변화
규칙 기반 액션
- 사용자 정의 트레일링 스탑 로직
- 동적 테이크 프로핏 조정
- 포지션 사이징 변경
ii. 거래소 수준 포지션 모니터링
거래소에 SL/TP가 설정된 주문의 경우:
봇은 거래소와 실시간 동기화를 유지하며 오픈 포지션을 지속적으로 감시합니다:
- 테이크 프로핏 체결: TP 주문 체결 감지 → 내부 상태 업데이트, 거래 아카이브, 후속 액션 실행
- 스탑로스 체결: SL 체결 감지 → 손실 기록, 포트폴리오 지표 업데이트, 리스크 파라미터 조정 (설정 시)
- 수동 청산: 수동/거래소 강제 청산 등 외부 청산 감지 → 내부 기록 조정
이중 모니터링 방식으로 봇 내부 관리든 거래소 수준이든 모든 포지션 변화가 정확히 기록되고 처리됩니다.
안전 메커니즘
- 오류 처리: 네트워크 장애, 잔고 부족, 거래소 오류 등에 대한 포괄적인 예외 처리
- 주문 검증: 실행 전 최소 주문 수량, 사용 가능 잔고, 시장 상황 사전 체크
- Rate Limiting: 거래소 API 제한 위반 방지를 위한 내장 스로틀링
- 안전 복구: 일시적 오류에 대한 지수 백오프 재시도 로직
- 상태 영구 저장: YAML 기반 상태 관리로 봇 재시작에도 모든 주문 유지
설정 예시
TradeTriggerOptions:
OrderType:
IsEnabled: true
Type: 2 # 하이브리드 주문 모드
AskPriceBufferPer: 0.1 # 지정가 버퍼 0.1%
TimeInForce: 60 # 60초 타임아웃
SLTPSettings:
StopLossPercent: 2.0 # 2% 스탑로스
TakeProfitPercent: 5.0 # 5% 테이크 프로핏
이 설정으로 PUMP 신호가 감지되면 봇은 하이브리드 매수 주문을 배치하고, 2 % 스탑로스와 5 % 테이크 프로핏을 설정한 후 포지션이 청산될 때까지 지속적으로 모니터링합니다.