SCANNER MANUAL

스캐너 상세 매뉴얼

5개 지표 알고리즘 / 파라미터 의미 / 리스크 관리 항목 / 용어 사전 / 트러블슈팅을 정리한 객관 정보입니다.

본 매뉴얼은 객관적 알고리즘 설명입니다. 매매 권유 / 자문 / 추천 / 수익 보장이 일체 아닙니다. 모든 지표 선택 / 파라미터 값 / TP·SL·TS 설정 / 종목 선택은 회원님이 직접 백테스트 후 본인 매매 판단으로 결정해야 합니다. 회사는 회원님이 설정한 조건에 따라 거래소에 주문을 전달하는 기술적 중계만 수행합니다.

1. 5개 지표 객관 설명

각 지표가 어떤 알고리즘이며, 파라미터가 어떤 의미인지 객관적으로 설명합니다. 어느 지표가 어떤 거래에 적합한지는 회원님이 본인 매매 스타일에 맞춰 결정합니다.

1-1. Triple MA Crossover
trend-following
알고리즘
3개 이동평균선 (Short / Mid / Long) 의 정배열 (Short > Mid > Long) 또는 역배열 (Short < Mid < Long) 을 감지. lookback 봉 동안 정렬 유지 + 격차 임계값 초과 시 신호 생성.
수학적 특성
주기 (period) 가 짧을수록 가격 변화에 더 빠르게 반응 → 더 잦은 신호 + 더 많은 노이즈. 길수록 더 안정적 → 더 적은 신호 + 추세 후행.
파라미터
  • short_period — 단기 MA 봉 수
  • mid_period — 중기 MA 봉 수
  • long_period — 장기 MA 봉 수
  • lookback — 정렬이 유지되어야 하는 봉 수
  • gap_threshold — MA 간 최소 격차 비율 (%)
1-2. RSI (Relative Strength Index)
oscillator
알고리즘
최근 N봉의 상승폭 평균 / 하락폭 평균 비율로 0~100 사이 값을 산출. 일반적으로 70+ = overbought, 30- = oversold 로 분류되는 모멘텀 오실레이터.
수학적 특성
주기 (period) 가 짧을수록 더 민감 → 70/30 영역 진입 빈번 + 위크 신호 다수. 길수록 더 안정적 → 영역 진입 드물지만 신호 신뢰도 변동.
파라미터
  • rsi_period — RSI 계산 봉 수
  • oversold_threshold — 매수 신호 진입 RSI 값
  • overbought_threshold — 매도 신호 진입 RSI 값
1-3. Stochastic
oscillator
알고리즘
최근 N봉의 최고가/최저가 범위 내에서 현재 종가의 상대 위치를 %K 로 계산. %D = %K 의 이동평균. %K, %D 의 교차 + 영역 (oversold/overbought) 이탈로 신호 생성.
수학적 특성
RSI 와 유사한 모멘텀 오실레이터지만 가격 위치 기반이라 RSI 대비 더 즉각적이고 노이즈가 큼. %K 주기 짧을수록 더 잦은 교차 신호.
파라미터
  • k_period — %K 봉 수
  • d_period — %D (%K 의 이동평균) 봉 수
  • oversold_threshold / overbought_threshold — 영역 임계
1-4. Bollinger Band
volatility
알고리즘
이동평균 (middle) 위·아래에 표준편차 N배 (upper / lower) 의 변동성 밴드를 그림. 가격이 밴드를 이탈하거나 회귀할 때 신호 생성.
모드
Breakout = 밴드 이탈 시 추세 진입 / Reversal = 밴드 이탈 후 회귀 시 역추세 진입. 회원님이 모드를 직접 선택.
수학적 특성
표준편차 배수 (deviation) 가 작을수록 밴드 좁고 이탈 빈번. 클수록 밴드 넓고 이탈 드묾.
파라미터
  • bb_period — 이동평균 봉 수
  • bb_deviation — 표준편차 배수
  • bb_modebreakout 또는 reversal
1-5. yoon V2 (SuperTrend-based)
multi-filter
알고리즘
SuperTrend (ATR 기반 추세 라인) + VWMA (거래량 가중 이동평균) + 거래량 임계 + 캔들 컨펌의 4개 필터를 결합한 멀티 필터 알고리즘. 모든 필터 통과 시 신호 생성.
수학적 특성
여러 필터 결합으로 단일 지표 대비 신호 빈도 낮음 + 신호 발생 시 다중 조건 충족. ATR 배수가 작을수록 추세 라인 민감, 클수록 안정적.
파라미터
  • atr_period / atr_multiplier — SuperTrend ATR 설정
  • vwma_period — VWMA 봉 수
  • volume_threshold — 최소 거래량 비율
  • candle_confirm — 컨펌 봉 수

2. 매매 파라미터 정의

스캐너 신호 발생 후 자동매매 흐름에서 사용되는 파라미터의 정의와 수학적 특성입니다.

용어 정의 수학적 특성
TP (Take Profit) 매수가 대비 +X% 도달 시 자동 익절. target = entry × (1 + TP/100) 작을수록 더 빠른 익절 + 더 잦은 거래. 클수록 더 큰 폭 익절 + 더 적은 거래.
SL (Stop Loss) 매수가 대비 -X% 도달 시 자동 손절. stop = entry × (1 - SL/100) 작을수록 더 빠른 손절 (더 작은 손실/거래). 클수록 더 큰 손실 허용 (변동성 흡수).
TS (Trailing Stop) 최고가 대비 -X% 하락 시 자동 매도. 가격이 오를 때 stop 도 같이 따라 올라감 (trailing) 이익 보존 + 추세 추종. 작을수록 더 일찍 청산, 클수록 더 큰 후퇴 허용.
매수 수량 % 가용 잔고 중 매매에 사용할 비율. 예: 10% 면 잔고의 10% 만 한 거래에 사용 작을수록 1회 거래 익스포저 작음 (분산). 클수록 1회 거래 익스포저 큼 (집중).
레버리지 (Futures) 자기 자본 대비 거래소가 빌려주는 배수. 예: 10x 면 자본 1 USDT 로 10 USDT 포지션 X배 증폭 = 손익도 X배. 청산 (강제 매도) 가능성도 증가.
화이트리스트 스캐너가 매매 평가할 종목 목록 비어있으면 거래소 전체 종목 평가, 채워두면 해당 종목만 평가.
캔들 / 봉 일정 시간 단위의 시가/고가/저가/종가. 1분봉, 1시간봉, 4시간봉, 1일봉 스캐너는 봉 마감 시점에 지표를 평가합니다 (실시간 평가 X).

3. 리스크 관리 (객관 정보)

자동매매에 일반적으로 적용되는 위험 관리 항목의 객관 정보입니다. 회원님이 본인 위험 감수도와 자본에 따라 결정합니다.

3-1. 자본 분산

일반적으로 자본을 여러 종목에 분산할 때 단일 종목의 변동성으로 인한 전체 자산 손실 가능성이 줄어드는 것이 수학적 사실입니다 (포트폴리오 분산 효과). 회원님이 종목 수와 비중을 직접 결정합니다.

3-2. 레버리지

레버리지 X배는 손익을 X배 증폭시킵니다. 동시에 청산 (강제 매도) 가격이 매수가 가까이 위치하므로 가격 변동성이 큰 종목에서 청산 위험이 증가합니다. 무레버리지 (1x) 부터 거래소 최대치까지 회원님이 본인 위험 감수도에 따라 결정합니다.

3-3. 동시 매매 종목 수

한 번에 활성화된 자동매매 종목이 많을수록 자본이 분산되어 단일 종목 손실 영향 ↓, 동시에 신호 모니터링 부담 + 거래소 API rate limit 부담 ↑. 회원님이 본인 자본 / 운영 가능한 종목 수를 결정합니다.

3-4. TP·SL·TS 비율

TP / SL 비율이 본인 거래 스타일과 일치해야 합니다 (예: TP > SL 일반적). TS 는 트렌드 추종 시 유효하나 횡보 / 변동성 큰 시장에서는 빠르게 청산될 수 있습니다. 회원님이 백테스트 후 결정합니다.

3-5. 본 시스템의 안전 가드

  • Withdraw 권한 차단: API 키 등록 시 Withdraw OFF 권장 → 자산 인출 불가능 구조
  • 0/0/0 청산 차단: TP/SL/TS 가 모두 0 이거나 수동 모드일 때 자동 청산이 발동되지 않음
  • 이중 호출 방지: 같은 신호로 인한 중복 매수가 발동되지 않도록 스캐너 내부 락 적용

4. 용어 사전

자동매매에서 자주 사용되는 용어 정리.

용어 의미
Long / Short매수 포지션 (가격 상승에 베팅) / 매도 포지션 (가격 하락에 베팅)
Spot / Futures현물 거래 (실제 자산 보유) / 선물 거래 (계약 거래, 레버리지 가능)
USDT-M / COIN-MUSDT 마진 선물 (USDT 로 정산) / 코인 마진 선물 (해당 코인으로 정산, BTCUSD_PERP 등)
Hedge Mode한 종목에 Long + Short 동시 보유 가능한 모드 (Binance / Bybit Futures 옵션)
Slippage주문 가격과 체결 가격의 차이. 시장가 주문 / 변동성 큰 시점에 발생
Funding Rate선물 거래에서 Long/Short 보유자 간 8시간마다 정산되는 비용 (양수/음수)
Liquidation레버리지 거래에서 손실이 마진을 넘어 거래소가 강제 청산 (자산 0)
화이트리스트 / 블랙리스트매매 대상 종목 목록 / 매매 제외 종목 목록
웹훅 (Webhook)외부 신호 (TradingView 등) 가 우리 서버로 직접 주문을 전송하는 HTTP API
캔들 마감 (Bar Close)봉 (1분/1시간/일봉 등) 의 마지막 시점. 스캐너는 이 시점에 지표 평가
신호 (Signal)지표 평가 결과 매수 또는 매도 조건이 충족된 상태
백테스트 (Backtest)과거 데이터에 지표를 적용해서 가상 결과를 검증하는 작업 (본 시스템은 백테스트 미제공)

5. 트러블슈팅

스캐너 / 자동매매에서 자주 발생하는 기술적 문제와 점검 항목.

5-1. 신호가 발생하지 않을 때

스캐너가 실행 중인지 확인

대시보드에서 [START SCANNER] 클릭됐는지, status 가 running 인지 확인합니다.

화이트리스트 종목 / 거래소 일치 확인

화이트리스트 비어있으면 전체 종목 스캔. 채워져 있으면 해당 종목만 스캔. 거래소 USDT-M 선택 시 종목명도 USDT-M 형식이어야 함 (예: BTCUSDT).

지표 파라미터가 너무 엄격하지 않은지

예: lookback 너무 길거나 gap_threshold 너무 큰 경우 조건 충족 빈도 낮음. 회원님이 본인 매매 스타일에 맞춰 조정.

봉 마감 대기

스캐너는 봉 마감 시점에 지표를 평가합니다. 1시간봉 사용 시 매시 정각, 4시간봉 사용 시 4시간마다 마감 시점에 평가.

5-2. 주문이 실패할 때

API 키 권한 점검

Read + Trade 권한이 모두 활성화되어야 합니다. Withdraw 는 OFF 유지. 단 Trade OFF 면 매매 불가.

잔고 부족

매수 수량 % × 가격 + 수수료가 가용 잔고보다 크면 주문 실패. 거래소에서 잔고 확인.

거래소 최소 주문량 미달

각 거래소는 종목별 최소 주문량 / 최소 USDT 액수가 있습니다. 너무 작은 매수 수량 % 시 거부됩니다.

레버리지 / 마진 모드 불일치

거래소에서 직접 설정한 레버리지 / 마진 모드 (Cross / Isolated) 와 우리 시스템 설정이 다르면 주문 거부될 수 있습니다.

IP 화이트리스트 등록

API 키에 IP 화이트리스트를 적용한 경우 우리 서버 IP 가 등록되어야 합니다. 13.209.224.50 추가 권장.

5-3. 자동 청산이 발동하지 않을 때

TP/SL/TS 가 모두 0 인지 확인

안전 가드로 TP/SL/TS 가 0/0/0 또는 수동 모드일 때 자동 청산이 발동하지 않습니다. 자동 청산 원하시면 0 이 아닌 값을 입력하세요.

모니터 탭에서 활성 포지션 확인

모니터 탭에서 해당 포지션이 표시되어야 자동 청산 평가가 일어납니다. 표시 안 되면 거래소 측 포지션 확인 필요.

다시 한 번 강조 — 본 매뉴얼은 객관 알고리즘 설명입니다. 매매 권유 / 자문 / 추천 / 수익 보장 일체 X. 모든 결정은 회원님 본인의 판단과 책임입니다. 세부 면책은 면책조항을 참고하세요.
← 가이드 메인으로