T TRADEX
사용 가이드 모의/실전 분리 국내/해외(미국) 투자 권유 미제공

계좌 연동부터 전략 바인딩까지, 한 번에 정리했습니다.

이 페이지는 계좌 조회수동 주문(테스트) 기능과 전략 라이브러리 → 종목 바인딩 기능을 중심으로, 바인딩 이후 사이트를 어떻게 사용하는지 흐름을 안내합니다.

빠른 시작 (7단계)

1

로그인

회원가입 또는 로그인 후 대시보드로 이동합니다.

2

계좌 연동

한국투자/미래에셋/키움 또는 가상투자(TRADEX)를 모의/실전 컨텍스트로 선택해 연결합니다. 가상투자는 키 입력 없이 초기자금 5,000만원이 자동 생성됩니다.

3

잔고 조회

국내 또는 해외(미국) 시장을 선택하고 잔고를 확인합니다.

4

수동 주문(테스트)

연동 확인 목적의 수동 주문을 실행하고 로그를 확인합니다.

5

전략 바인딩

종목(예: SOXL)에 전략(예: 변동성 돌파)을 연결해 운용 준비를 합니다.

6

커스텀 자동주문

시간창 + 목표가 + 수량 라인을 세트로 저장해 조건 도달 자동주문을 준비합니다.

7

자동매매 시작 + 로그 확인

엔진 시작 후 상태줄과 세션 로그 파일로 체결/미체결 처리 결과를 점검합니다.

회원가입 중복확인(이메일/휴대폰)

회원가입 화면에서 이메일 확인, 휴대폰 확인 버튼을 각각 눌러 중복 여부를 먼저 검증한 뒤 가입을 완료합니다.

설정/사용 방법
  1. 이메일 입력 후 이메일 확인 버튼 클릭
  2. 휴대폰 입력 후 휴대폰 확인 버튼 클릭
  3. 두 항목 모두 사용 가능 상태를 확인한 뒤 가입 제출

휴대폰은 숫자 기준으로 정규화되어 중복 검사됩니다. (`010-1234-5678` 과 `01012345678`은 동일 처리)

예시
이메일
altablue@example.com → 사용 가능
휴대폰
010-9876-5432 → 사용 가능
가입 제출
성공 시 즉시 로그인 가능 상태로 전환

잔고 조회(국내/해외) 사용법

어디서 하나요?

대시보드 → 계좌 조회에서 잔고 조회를 실행합니다.

  • 증권사운용 모드(모의/실전)를 먼저 선택합니다.
  • 시장을 국내 또는 해외(미국)으로 선택합니다.
  • 해외(미국) 선택 시 거래소통화가 추가로 표시됩니다.
결과는 무엇이 나오나요?

예수금, 총자산, 보유 종목 수와 보유 종목 상세가 표시됩니다.

예수금
주문 가능한 현금(국내는 KRW, 해외는 USD)
총자산
현금 + 보유 종목 평가금액
보유 종목 상세
종목코드/보유수량/평균단가/현재가/평가금액

포트폴리오(관심종목) 사용법

포트폴리오에 관심종목을 등록하면, 실시간 시세 카드와 간단한 추세(스파크라인)가 표시됩니다. 또한 전략 바인딩/수동 주문/백테스트/알림 규칙에서 종목을 빠르게 선택할 수 있습니다.

어디서 등록하나요?

대시보드 → 포트폴리오에서 등록합니다.

  • 국내: 6자리 종목코드(예: 005930)
  • 해외(미국): 티커(예: SOXL) + 거래소(NASD/NYSE/AMEX)
  • 종목명은 입력 후 자동으로 조회되어 채워집니다. (필요 시 수정 가능)
  • 메모는 선택이며, 화면/셀렉트 표시용으로 활용됩니다.
실시간 시세가 안 나올 때
  • 포트폴리오 화면 상단에서 실시간 시세 시작을 눌러 수집기를 실행합니다.
  • 수집기 상태 확인에서 실행중/중지 상태를 확인합니다.
  • 현재 단계에서는 시세 데이터 파이프라인이 점진적으로 고도화됩니다.
다른 화면에서 종목을 빠르게 선택하기
전략 바인딩/수동 주문/백테스트/알림 규칙 입력에 있는 포트폴리오에서 선택 메뉴에서 종목을 고르면, 해당 화면의 종목 입력칸이 자동으로 채워집니다.

수동 주문(테스트) 사용법

수동 주문은 연동 확인 목적의 기능입니다. 현재 선택된 증권사/운용 모드/시장(국내·해외) 설정을 그대로 사용합니다.

주문 전 체크
  • 운용 모드가 모의/실전 중 원하는 값인지 확인합니다.
  • 해외(미국) 주문은 시장=해외(미국) 선택 후, 거래소(NASD/NYSE/AMEX)를 맞춰주세요.
  • 시장가는 가격 입력이 없고, 지정가는 가격 입력이 필요합니다.
주문 입력 예시
국내
종목코드: 005930 · 매수 · 시장가 · 수량 1
해외(미국)
종목코드: SOXL · 매수 · 지정가 · 수량 1 · 지정가 20.50

주문 실행 시 확인 팝업이 표시됩니다. 확인 후 전송되며, 결과는 화면 하단 상태 영역과 로그에서 확인할 수 있습니다.

전략 라이브러리 · 종목 바인딩 사용법

핵심 규칙
  • 종목 + 운용 모드 기준으로 1개의 전략만 바인딩됩니다.
  • 같은 종목/모드에 다른 전략을 저장하면 기존 바인딩이 덮어쓰기 됩니다.
  • 바인딩 저장 후 자동매매 엔진을 시작하면 해당 바인딩 기준으로 주문 판단이 실행됩니다.
어디서 하나요?

대시보드 → 전략 라이브러리에서 전략 선택 후 바인딩을 저장합니다.

  • 전략 표에서 [선택]을 누르면 오른쪽 “종목 바인딩” 영역에 설명이 표시됩니다.
  • 종목코드(국내 6자리, 해외는 티커)와 운용 모드를 선택합니다.
  • 바인딩 저장을 누르면 아래 목록에 활성 상태로 표시됩니다.
종목 전략 모드 상태
SOXL 변동성 돌파 실전 활성
바인딩을 왜 하나요?
종목 바인딩은 “이 종목을 어떤 전략으로 운용할지”를 명확히 만드는 단계입니다. 자동매매 엔진은 바인딩 목록을 기준으로 전략을 순환 실행하고, 주문/잔고/알림 흐름을 처리합니다. 바인딩 데이터는 서버 DB에 저장되므로 같은 계정이면 다른 브라우저/PC에서도 동일하게 조회됩니다.

전략 만들기(이지/전문가/AI) 사용법

전략은 “진입/청산 규칙 + 리스크 관리”를 한 세트로 저장하는 기능입니다. 처음이라면 이지 모드로 시작하고, 익숙해지면 전문가/AI 모드로 확장하세요.

어디서 만들나요?
  • 대시보드 → 전략 라이브러리로 이동합니다.
  • 왼쪽 “나의 전략” 카드에서 [전략 만들기]를 누릅니다.
  • 저장하면 “나의 전략” 목록에 추가되고, 바인딩 드롭다운에서도 선택할 수 있습니다.

현재 단계에서는 “내 전략”이 사용자별로 브라우저 localStorage에 저장됩니다. 추후 서버 DB 저장으로 전환하면 기기 간 동기화가 가능해집니다.

모드별 특징
  • 이지 모드: 이동평균/RSI/변동성 돌파 템플릿을 선택하고 숫자만 조정합니다.
  • 전문가 모드: 전략 정의(JSON)를 직접 편집해 저장합니다.
  • AI 모드: 질문에 답하면 전략 정의가 자동 완성됩니다. (대화형 가이드)
초보자에게 추천하는 최소 규칙
1) 진입 조건은 1~2개로 단순하게(예: 이동평균 교차).
2) 손절/익절(또는 트레일링) 중 최소 1개는 반드시 설정.
3) 1회 진입 비중을 크게 잡지 않기(예: 10~25%).
4) 백테스트 → 모의 운용(관찰) → 실전 순으로 단계적으로 검증.
신규 4종 리스크 옵션 사용법(급등보호/추세유지/트레일링익절/분할익절)
1) 급등/상한가 보호(매도 보류)
- 목적: 급등 직후 조기 매도를 줄입니다.
- 동작: 직전 대비 상승률이 기준 이상이고 최근 고점 구간이면 매도 신호를 보류합니다.

2) 추세 유지 필터
- 목적: 상승 추세(단기 MA > 장기 MA)에서는 매도 신호를 늦춥니다.
- 동작: 추세가 살아 있으면 매도를 보류하고, 추세 약화 후 매도를 허용합니다.

3) 트레일링 익절
- 목적: 수익 구간에서 고점을 따라가며 이익을 보전합니다.
- 동작: 최소 수익률 도달 후 고점 대비 하락률이 기준을 넘을 때 매도합니다.

4) 분할익절 1회
- 목적: 전량 매도 대신 일부만 먼저 실현합니다.
- 동작: 지정 수익률 도달 시 보유수량의 비율만 1회 매도하고, 잔량은 다음 신호를 기다립니다.

추천 초기값
- 급등보호: 5% / 20봉
- 추세유지: MA 20/60
- 트레일링익절: 하락 1.5%, 활성 수익률 1.0%
- 분할익절: 수익률 3.0%, 매도비율 50%

백테스트는 어떤 용도인가요?

백테스트

과거(히스토리) 데이터를 기반으로 전략을 시뮬레이션하여, 규칙의 유효성과 리스크를 점검하는 과정입니다.

  • 전략의 진입/청산 규칙이 의도대로 동작하는지 확인합니다.
  • 최대 낙폭(MDD), 변동성 등 리스크 지표를 함께 점검합니다.
  • 백테스트 결과가 좋더라도 과최적화가 있을 수 있으니, 구간을 나눠 검증하는 것을 권장합니다.
모의투자(운영 단계)

증권사 모의 환경에서 실제 주문/잔고 흐름을 검증하는 운영 단계입니다.

  • API 인증/주문/잔고 조회가 정상인지 확인합니다.
  • 알림/로그/예외 처리 등 운영 흐름을 실제와 유사하게 점검합니다.

현재 백테스트 화면의 수치는 UI 검증을 위한 예시이며, 히스토리 데이터 파이프라인이 연결되면 실제 결과로 대체됩니다.

커스텀 자동주문 세트 운용 가이드

커스텀 자동주문은 세트 단위로 동작합니다. 세트의 시간창 안에서 라인(종목/매수·매도/목표가/수량)을 무제한으로 추가해 자동 집행할 수 있습니다.

세트 입력 순서
  • 거래시장 선택: 코스피/나스닥/직접설정
  • 날짜는 비우면 매일 반복, 입력하면 단일 날짜 세션
  • 시작시간/종료시간 지정 후 라인 추가
  • 라인은 종목 · 구분(매수/매도) · 금액(목표가) · 수량으로 구성
시간 해석 규칙 (중요)
  • 나스닥 프리셋 시간은 뉴욕 현지시간(ET) 기준입니다. (09:30~16:00)
  • 종료시간이 시작시간보다 이른 야간 세션도 저장 가능합니다. (예: 23:30~06:30)
  • 단일 날짜 + 야간 세션은 지정일 시작 ~ 다음날 종료 구간으로 처리됩니다.
프리셋 #2 자동생성 사용법
  • 전략 화면의 커스텀 자동주문 카드에서 프리셋 #2 영역을 엽니다.
  • 기준가, 익절%, 단계간격%, 단계수, 금액단계(CSV)를 입력합니다.
  • 프리셋 #2 생성 버튼을 누르면 라인이 자동 생성됩니다.
  • 생성된 라인을 확인 후 세트 저장을 누르면 즉시 활성화할 수 있습니다.
프리셋 #2 예시
종목
SOXL
기준가
60
익절%
3
단계간격%
-5
단계수
5
금액단계
200000,180000,360000,640000,1300000

위 예시는 “하락 구간 분할 매수 + 각 단계별 익절 라인”을 한 번에 만드는 패턴입니다.

동시운용 규칙 (중요)

기존 커스텀 주문(레거시 플랜)과 커스텀 자동주문 세트가 동시에 활성화되면, 엔진은 커스텀 자동주문 세트만 실행하고 레거시 플랜은 자동 스킵합니다.

미체결이 자주 나는 모의투자에서 어떻게 처리되나요?
트리거 도달 시 1회 접수로 끝나지 않고, 엔진이 미체결/부분체결을 감지합니다. 잔량이 남으면 취소 후 재호가 지정가로 재시도하며, 시도 횟수/간격/추격폭은 서버 설정으로 제어됩니다. 처리 과정은 자동매매 세션 로그 파일에 단계별로 기록됩니다.

자동매매 엔진 운용 방법

시작/중지
  • 전략 라이브러리 또는 트레이딩 센터에서 자동매매 시작/중지를 실행합니다.
  • 엔진은 서버에서 실행되며, 브라우저를 닫거나 로그아웃해도 실행 상태가 유지됩니다.
  • 중지는 명시적으로 버튼을 누르거나 서버 재시작 시 적용됩니다.
실시간 상태 확인
  • 상태 줄에서 토큰/잔고/주문/자동매매 최신 시각을 확인합니다.
  • 자동매매 기록 패널에는 최근 경고/오류/주문 이벤트가 표시됩니다.
  • 잔고 조회 경고, 토큰 쿨다운, 시세 실패 메시지는 자동으로 누적됩니다.

자동매매 로그 확인(필수)

웹에서 바로 확인
  • 트레이딩 센터 또는 계좌조회 화면의 자동매매 로그 표에서 파일 목록을 확인합니다.
  • 웹 보기로 본문을 즉시 열거나, 새 탭으로 파일을 분리 열람할 수 있습니다.
  • 자동매매를 시작할 때마다 세션별 새 파일이 생성됩니다.
로그에서 꼭 볼 항목
  • [CUSTOM_ORDER_SET_SUBMIT]: 시도 번호/트리거/시세/지정가
  • [CUSTOM_ORDER_SET_OPEN]: 체결수량/미체결잔량
  • [CUSTOM_ORDER_SET_CANCEL]: 잔량 취소 여부
  • [CUSTOM_ORDER_SET]: 요청수량/체결수량/잔량 요약

위험관리 설정

자동매매 위험관리는 손실 확대와 과매수를 방지하기 위한 필수 설정입니다.

어디서 설정하나요?

대시보드 → 자동매매 위험관리에서 설정합니다.

  • 최소 보유 시간(초)
  • 재진입 대기 시간(초)
  • 최소 순수익률(%)
  • 최대 손실 허용(%)
  • 종목별/전체 일일 주문 제한
  • 일일 손실컷(%)
  • 예수금 부족 재시도 대기(초)

참고: 급등보호/추세유지/트레일링익절/분할익절은 전략 만들기(이지/전문가)에서 전략별로 설정합니다.

운용 권장
  • 모의에서 충분히 검증한 뒤 실전 계좌에 적용하세요.
  • 수수료/세금으로 순손익이 악화되는지 로그와 성과분석에서 함께 점검하세요.
  • 변동성 종목은 재진입 대기를 길게 두어 과매매를 줄이는 것이 안전합니다.

알림 센터 설정 방법

수신 정보(프로필)

사용자는 프로필에서 텔레그램 ID, 왓츠앱 번호 등 “수신 정보”만 저장합니다.

  • 채널 키(텔레그램 봇 토큰, 왓츠앱 API 키)는 관리자만 등록합니다.
  • 알림 센터에서는 기본 채널과 규칙만 설정합니다.
텔레그램 연결 체크 (필수 3단계)
  1. 각 사용자는 텔레그램에서 해당 봇과 1:1 대화를 열고 /start를 먼저 실행합니다.
  2. 프로필의 텔레그램 ID에는 본인 숫자 chat_id를 저장합니다.
  3. 사용자가 봇을 차단하면 알림이 발송되지 않으므로 차단 상태를 해제해야 합니다.
규칙(셀렉트 + 입력)

이벤트(주문 체결/낙폭 경고/수집기 오류)와 조건을 선택하면 “조건 미리보기”가 자동으로 구성됩니다.

  • 규칙 삭제/전체 삭제는 확인 팝업 후 수행됩니다.
  • 현재 단계에서는 규칙이 브라우저 localStorage에 저장됩니다.

바인딩 후, 이 사이트는 이렇게 사용합니다

추천 운영 흐름
  • 계좌 연동에서 모의/실전 계좌를 각각 저장하고 연결 확인을 합니다.
  • 계좌 조회에서 잔고와 보유 종목이 정상 조회되는지 확인합니다.
  • 전략 바인딩으로 운용 종목을 정의하고, 백테스트로 전략을 점검합니다.
  • 필요 시 수동 주문(테스트)로 주문 경로를 확인합니다.
현재 제공 범위
  • 계좌 연동/잔고 조회/수동 주문/전략 바인딩/커스텀 자동주문/자동매매 엔진
  • 자동매매 세션 로그 파일 열람, 위험관리 설정, 알림 센터, 성과 분석

문제 해결(자주 묻는 질문)

계좌 조회/주문에서 403 오류가 나요
1) 모의/실전 키가 서로 바뀌어 입력되었는지 확인하세요.
2) 앱 키/시크릿은 복사 과정에서 개행/공백이 섞이면 실패할 수 있습니다. 저장 계좌 관리에서 다시 저장해 보세요.
3) 해외주식은 별도 서비스 신청/권한이 필요한 경우가 있습니다. KIS 계정의 해외주식 서비스 상태를 확인하세요.
나스닥 세트 시간은 한국시간인가요?
나스닥 프리셋 시간은 뉴욕 현지시간(ET)입니다. 예를 들어 09:30~16:00은 미국 정규장 기준입니다.
야간 세션(예: 23:30~06:30)도 저장 가능하며, 종료시간이 시작시간보다 이른 형태를 지원합니다.
커스텀 자동주문이 미체결되면 어떻게 되나요?
엔진이 미체결/부분체결을 확인하고, 잔량이 남으면 취소 후 재호가 지정가로 재시도합니다.
처리 상세는 자동매매 로그 파일의 `CUSTOM_ORDER_SET_SUBMIT/OPEN/CANCEL` 항목에서 확인하세요.
커스텀 자동주문 세트와 기존 커스텀 주문을 동시에 켜도 되나요?
동시에 켜도 엔진은 충돌을 방지하기 위해 커스텀 자동주문 세트를 우선 적용합니다.
운영 시에는 한 종류만 명확하게 활성화하는 것을 권장합니다.
모의투자 주문에서 “사용자정보가 상이” 오류가 나요
모의투자 계좌번호/상품코드와 모의용 앱 키/시크릿이 서로 매칭되어야 합니다. 실전 키로 모의 계좌를 호출하거나(또는 반대) 계좌가 다른 사용자에 매핑되어 있으면 오류가 발생합니다.
바인딩이 다른 PC/브라우저에서는 보이지 않아요
바인딩은 서버 DB에 저장됩니다. 보이지 않는다면 아래를 점검하세요.
1) 같은 계정으로 로그인했는지 확인
2) 저장 시 에러가 있었는지 상태 메시지 확인
3) 브로커/모의·실전 필터가 다르게 설정되어 있지 않은지 확인
내가 만든 전략이 다른 PC/브라우저에서는 보이지 않아요
현재 단계에서는 “내 전략(전략 만들기)”이 사용자별로 브라우저 localStorage에 저장됩니다. 추후 서버 DB 저장 방식으로 전환하여 기기 간 동기화가 가능하도록 개선할 예정입니다.
미래에셋/키움증권을 선택하면 어떻게 되나요?
미래에셋/키움증권은 현재 베타 연동입니다. API 엔드포인트와 키 설정이 완료된 경우 계좌 연동/조회/주문을 사용할 수 있고, 설정이 비어 있으면 데모 응답/설정 안내 메시지로 동작합니다. 가상투자(TRADEX)는 별도 키 없이 즉시 사용 가능하며 사용자별 초기자금 5,000만원이 자동 생성됩니다.