앱 화면 안내¶
Quantiq를 처음 열면 어떤 화면이 보이는지, 각 탭에서 무엇을 할 수 있는지 먼저 파악하세요. 전략을 만들기 전에 이 페이지를 훑어보면 앱의 흐름이 한눈에 들어옵니다.
이 페이지는 베타 신청, 다운로드, 업비트 Open API 키 설정의 canonical 사용자 매뉴얼입니다. FAQ, 랜딩, 첫 전략 만들기 문서는 절차를 반복하지 않고 이 페이지로 연결합니다.
탭별 역할¶
| 탭 | 주요 기능 |
|---|---|
| 스튜디오 | 전략 코드 작성, 백테스트 실행, AI 어시스턴트로 코드 생성 |
| 거래 | 전략 활성화/비활성화, 종목 연결, 체결 내역 확인 |
| 설정 | 거래소 API 키 등록(업비트), 텔레그램 알림 설정, 계좌 리스크 룰 관리 |
| 커뮤니티 | 다른 사용자의 공개 전략 탐색 및 내 계정으로 가져오기 |
| 다운로드 | 데스크톱 런타임 설치 파일(macOS/Windows) 다운로드 |
사이드바 아이콘에 주황색 점이 보이면 해당 탭에서 완료해야 할 단계가 있다는 표시입니다.
처음 시작할 때 진행 순서¶
아래 네 단계를 먼저 완료해야 전략을 실행할 수 있습니다.
| 단계 | 할 일 | 어디서 | 예상 시간 |
|---|---|---|---|
| 1 | Google 로그인 → 간단한 설문 → 베타 신청 완료 | quantiq.kr/login?next=/beta/apply 또는 홈의 베타 신청 | 약 2분 |
| 2 | 데스크톱 앱 설치 파일 다운로드 | 다운로드 탭(베타 승인된 계정만) | 약 2분 |
| 3 | 업비트 API 키 설정 | 설정 탭 | 약 5분 |
| 4 | 운영 시작 (작은 자본금 계정 권장) | 거래 탭 | 약 5분 |
베타 신청 플로우 (업비트 피벗 이후)
로그인과 베타 신청이 분리되었습니다. 베타 신청 버튼은 비로그인 상태에서도 보이지만
클릭 시 Google 로그인을 요구하고, 성공 후 /beta/apply로 이동해 설문을 작성합니다. 제출 완료 후
/beta/status에서 상태(pending / approved / waitlisted / rejected)를 확인할 수 있습니다.
초기 정원 50명 이내면 자동 승인됩니다.
Google 로그인은 인증만 처리하며 베타 상태를 자동으로 바꾸지 않습니다. 베타 신청 여부와 승인 상태는
/beta/status가 기준입니다. 예전 /register 진입점은 /login으로 이동합니다.
이미 로그인한 상태로 /getting-started STEP 1을 보는 사용자에게도 "베타 신청 이어서 하기" CTA가
노출됩니다. 아직 신청하지 않았다면 /beta/apply로 이동해 설문을 진행하고, 이미 신청한 경우 서버가
/beta/status로 자동 리다이렉트합니다.
다운로드 탭은 현재 임시 비활성
Upbit 거래소 대상 베타 런타임을 준비 중이라 cloud /download 탭과 라우트가 일시적으로 막혀 있습니다.
상단 navbar에서 다운로드 탭은 보이지 않으며, /download 직링크는 /getting-started로 흡수됩니다.
/beta/status에서 승인 상태를 확인한 사용자에게는 "Upbit 거래소 대상 베타 런타임을 준비 중" 안내가 표시됩니다.
Upbit 빌드 재배포 시점에 본 섹션이 다시 활성화됩니다.
다운로드 탭 노출 조건 (재활성화 시 적용)
베타 기간에는 런타임 다운로드 탭이 승인된(approved) 계정에만 노출됩니다.
로그인하지 않았거나 대상이 아닌 계정은 다운로드 페이지에서 권한 안내가 표시됩니다.
macOS/Windows 카드 클릭 시 권한이 다시 검증되며, 권한이 있을 때만 실제 설치 파일로 이동합니다.
시스템 요구사항
- 운영체제: Windows, macOS
- 거래소: 업비트 (Open API 직접 연동)
업비트 API 키 설정 방법¶
설정 탭에서 업비트 Open API를 연결해야 전략을 실행(자동 매수/매도)할 수 있습니다.
차트는 키 저장 전에도 동작합니다
Upbit 시세 조회 API는 비인증으로 사용 가능하기 때문에 첫 진입 시 기본 종목(KRW-BTC) 차트가 자동으로 로드됩니다. 거래 인증과 시세 조회 인증은 분리되어 있어 키를 저장하지 않은 상태에서도 모든 KRW + BTC + USDT 마켓의 차트를 살펴볼 수 있습니다. 키는 자동 매매(주문 발주, 체결 통보 수신)에서만 필요합니다.
- 업비트 계정으로 로그인 후 업비트 Open API 관리에서 신규 키 발급
- 허용 IP에 quantiq를 실행할 PC의 공인 IP를 등록 (IP 변경 시 재발급 또는 IP 업데이트 필요)
- 권한 범위 선택: 자산·주문 조회 + 주문하기 (quantiq는 출금 API를 사용하지 않으므로 출금 권한은 체크하지 마세요)
- Access Key와 Secret Key를 안전한 위치에 복사 (Secret Key는 발급 화면에서만 확인 가능)
- Quantiq 설정 탭 → "업비트 인증" 섹션에 Access/Secret Key 입력 — 내 PC에만 저장되며 cloud로 전송되지 않습니다
- 연결 테스트 버튼으로 잔고 조회 정상 동작 확인
처음에는 작은 자본금으로 시작하세요
Upbit는 별도의 paper-trading 환경이 없어 실거래 키를 등록하면 즉시 실제 주문이 나갈 수 있습니다(#85에서 Settings의 "모의 거래용 키" 토글과 탑바 모의계좌/실전계좌 슬라이더가 제거됨 — Upbit에 등가 기능이 없어 의미 없음). 백테스트로 전략을 충분히 검증한 뒤, 잔고가 작은 별도 계정에서 실시간 동작을 1차 검증하고 본 자본금에 단계적으로 적용하세요. Secret Key가 유출되면 즉시 업비트 Open API 관리에서 키를 삭제하고 재발급하세요. 라이브 시장 데이터로 시그널만 받고 실제 주문은 발사하지 않으려면 시그널 전용 시작 옵션을 사용하세요(탑바 엔진 버튼 옆 ▼ → "시그널 전용 시작"). 자세한 내용은 운영 가이드 — 시그널 전용 모드 참고.
설정 탭의 리스크 관리¶
- 계좌 단위 리스크 룰은 설정 탭에서 관리합니다.
- 전략 패널의 손절/익절은 퍼센트 입력(
3= 3%)으로 통일되어 있습니다. rule.*계열 주문(손절·익절 등)은 시장가로만 실행됩니다.
인앱 온보딩 안내¶
처음 로그인하면 앱 우하단에 시작 안내 토스트가 표시됩니다. 현재 완료가 필요한 단계를 알려주고 버튼을 누르면 해당 화면으로 이동합니다.
- 설정 탭 아이콘 주황색 점 — 거래소 API 키 연결이 아직 완료되지 않았습니다
- 스튜디오·거래 탭 아이콘 주황색 점 — 거래소는 연결됐지만 전략이 아직 없습니다
각 화면의 인라인 안내 카드도 현재 단계에 맞는 설명을 제공합니다. 닫으면 같은 브라우저 세션 동안 다시 나타나지 않습니다.
다음 단계¶
- 설치 & 문제 해결 — 데스크톱 앱 설치 방법
- 첫 전략 만들기 — Hello World 전략으로 5분 안에 백테스트 실행