자주 묻는 질문¶

시작하기¶

서비스 도메인은 무엇인가요?¶

Quantiq Cloud 서비스 도메인은 quantiq.kr입니다. 일부 옛 안내에 남아있던 quantiq.me 주소는 자동으로 quantiq.kr로 리다이렉트됩니다.

데스크톱 앱은 최신 버전에서 자동으로 api.quantiq.kr로 연결됩니다.

가입과 로그인이 따로 있나요?¶

별도 회원가입 화면은 없고 Google 계정으로 로그인합니다. 베타 신청 절차는 앱 화면 안내를 참고하세요.

베타테스트는 어떻게 신청하나요?¶

홈페이지의 베타 신청 버튼에서 시작합니다. 상세 단계와 상태 확인 방법은 앱 화면 안내를 참고하세요.

로그아웃 후 다른 Google 계정으로 로그인하고 싶어요¶

매 로그인 시 Google 계정 선택 화면이 항상 표시됩니다. 직전에 로그인했던 계정이 자동으로 다시 로그인되지 않으니, 사용하려는 계정을 직접 골라 진입할 수 있습니다.

로그인했는데 다운로드 탭이 안 보입니다¶

현재 다운로드 탭은 임시 비활성 상태입니다. Upbit 거래소 대상 베타 런타임을 준비 중이라 cloud /download 탭과 라우트가 일시적으로 막혀 있고, allowlist 여부와 무관하게 모든 계정에서 navbar 다운로드 탭이 보이지 않습니다. /download 직링크도 /getting-started로 흡수됩니다. Upbit 빌드 재배포 시점에 다시 활성화됩니다.

재활성화 시 적용되는 원래 정책:

다운로드 탭은 베타 런타임 allowlist 대상 계정에만 노출됩니다.
로그인하지 않은 경우: 로그인 후 다시 확인하세요.
로그인했지만 탭이 없는 경우: 베타테스트 정원이 마감되어 자동 승인이 적용되지 않았을 수 있습니다. 시작하기 페이지에서 안내 문구를 확인하거나 운영팀에 문의하세요.
직접 링크(/download)로 접근하면 현재 상태(로그인 필요/권한 없음/다운로드 가능)가 안내됩니다.

어떤 거래소를 지원하나요?¶

업비트 피벗 이후 업비트 Open API에 직접 연동합니다. 키 발급과 권한 설정은 앱 화면 안내를 참고하세요.

국내주식(KIS) 버전 참고

이 가이드 사이트 일부 섹션은 국내주식 버전 기준으로 작성된 내용이 남아 있을 수 있습니다. 업비트 버전은 개발 중이며, 베타 참여자에게 순차적으로 초대되면서 동작 차이가 있을 수 있습니다. Studio·차트·종목 검색 표면은 모두 Upbit 마켓(KRW-BTC/BTC-ETH/USDT-XRP 형식, KRW + BTC + USDT)으로 단일화되었으며 기본 종목은 KRW-BTC입니다 (PR-1, 2026-04-28). 시세 조회는 무인증으로 동작하므로 키 저장 전에도 차트가 보이고, 자동 매매(주문)만 키 등록을 요구합니다.

베타는 언제 시작되나요?¶

업비트 버전 베타는 현재 신청을 받는 단계이며, 코어 엔진 완성 시점에 첫 50명에게 데스크톱 앱이 배포됩니다. 정확한 일정은 신청자에게 이메일로 안내합니다. 신청 자체는 지금 바로 가능합니다.

베타 비용은 얼마인가요?¶

베타 기간 동안 모든 기능은 무료입니다. 정식 출시 시점의 가격 정책은 베타 참여자 대상 의견 수렴 후 결정해 사전에 안내합니다. 베타 종료와 동시에 즉시 결제가 시작되는 구조는 아닙니다.

신청 시 설문은 왜 받나요?¶

자동매매 도구를 어떻게 쓰고 싶은지, 어떤 기능이 우선인지 파악해 베타 동안 우선순위에 직접 반영하기 위해서입니다. 응답은 제품 방향성 결정에만 사용되며 마케팅 목적으로는 활용하지 않습니다.

업비트 API 키는 안전하게 보관되나요?¶

업비트 Access/Secret Key는 고객님의 PC에만 저장되며 cloud 서버로 전송되지 않습니다. 권한 범위와 재발급 안내는 앱 화면 안내를 참고하세요.

공인 IP가 자주 바뀌면 어떻게 하나요?¶

업비트 Open API 관리에서 허용 IP를 업데이트하면 됩니다. 자세한 운영 기준은 앱 화면 안내를 참고하세요.

DSL 문법¶

`[0]`, `[1]`은 무엇인가요?¶

ta.sma(), ta.rsi() 등의 지표 함수는 TSeries라는 시계열 객체를 반환합니다. [0]은 현재(가장 최근) 값, [1]은 1봉 전 값, [2]는 2봉 전 값입니다.

rsi = ta.rsi(c.close, 14)
rsi[0]   # 현재 봉 RSI
rsi[1]   # 직전 봉 RSI

if rsi > 70: 처럼 직접 비교할 때는 자동으로 rsi[0]이 사용됩니다.

`c.close[0]`와 `price`는 무엇이 다른가요?¶

	`c.close[0]`	`price`
값	현재 봉의 종가 (봉 마감 전까지는 변동 가능)	현재 이벤트 시점의 실시간 가격
언제 유용한가	봉 마감 기준 판단	실시간 가격 조건 판단

실행 간 상태를 유지하려면 어떻게 하나요?¶

var 네임스페이스를 사용합니다. 일반 변수는 이벤트마다 초기화되지만, var는 실행 간 값이 유지됩니다.

var.init(count=0)
var.count += 1   # 이벤트마다 누적

자세한 내용: var 네임스페이스

`ta.crossover()`와 `series.cross_up()`의 차이가 뭔가요?¶

두 방법 모두 bool을 반환하며 결과가 동일합니다.

# 메서드 형식 — 읽기 쉽고 권장
if sma5.cross_up(sma20):
    buy()

# 함수 형식 — 동일하게 동작
if ta.crossover(sma5, sma20):
    buy()

취향에 따라 선택하세요. cross_up() / cross_down()이 코드 가독성이 더 좋아 권장합니다.

`math.pi`는 어떻게 쓰나요?¶

속성이 아니라 함수입니다. math.pi()로 호출하세요.

circumference = 2 * math.pi() * radius

`import`를 쓸 수 없는데 어떻게 하나요?¶

QuantiqDSL은 샌드박스 환경이라 import가 금지됩니다. 대신 내장 네임스페이스를 사용하세요.

수학 함수: math.mean(), math.abs(), math.max(), math.sqrt() 등
기술 지표: ta.sma(), ta.rsi(), ta.macd() 등

전체 목록: 내장 함수, ta.* 레퍼런스

데이터와 차트¶

차트 데이터가 계속 로딩 실패합니다¶

자동으로 최대 3회 재시도합니다. 계속 실패하면 다시 불러오기 버튼으로 수동 재시도하세요.

거래량이 0인 봉이 보입니다. 데이터 오류인가요?¶

꼭 그렇지는 않습니다. 실제로 해당 시간에 체결이 없었던 경우 거래량 0 봉이 생성될 수 있습니다. 이런 봉에서는 백테스트 시 시장가 주문이 체결되지 않습니다.

분봉 백테스트는 몇 개월치까지 가능한가요?¶

거래소 API의 분봉 히스토리 제공 범위에 따라 제한됩니다(업비트 기준 최근 수개월 범위). 더 긴 기간을 테스트하려면 일봉(1D) 이상 타임프레임을 사용하세요.

실시간 틱이 없는데도 `candle_close` 이벤트가 들어옵니다¶

정상 동작입니다. 틱이 없는 구간에도 봉 마감 시간이 되면 이벤트가 발생합니다. 이 봉은 이전 종가를 유지하고 거래량은 0입니다. 전략의 봉 마감 판단(barstate().is_confirmed)과 주문 실행 타이밍이 정확하게 동작하도록 하기 위해 필요합니다.

백테스트¶

백테스트 결과를 믿을 수 있나요?¶

백테스트는 실거래와 동일한 주문 판단 로직을 사용합니다. 단, 과거 결과가 미래 수익을 보장하지 않습니다. 백테스트는 전략 논리의 타당성을 확인하는 도구이며, 슬리피지, 유동성 제한, 시장 상황 변화 등 실거래 변수는 반영되지 않습니다.

손절/익절 리스크는 종가 기준으로만 판단하나요?¶

아닙니다. 백테스트/시뮬레이션에서는 각 봉 내부를 시가→고가→저가→종가 경로로 평가해 리스크 트리거 여부를 확인합니다.

트리거가 발생하면 해당 틱 가격이 expected_price로 기록되며, 실제 체결 가격(fill_price)은 체결 모델(close 또는 next_open)을 따릅니다.

멀티 타임프레임 전략 백테스트에서 오류가 납니다¶

전략이 참조하는 모든 타임프레임의 데이터가 준비되어야 합니다. 특정 기간/종목에서 일부 타임프레임 데이터가 없으면 오류가 발생합니다. 백테스트 기간을 줄이거나 타임프레임을 조정해보세요.

백테스트 마지막 구간에서 자주 실패합니다¶

가장 최근 거래일 데이터 공급이 지연될 수 있습니다. 백테스트 종료일을 어제 또는 그 이전으로 설정해보세요.

운영¶

Quantiq 프로그램을 재시작하면 예전 알림이 다시 뜨나요?¶

재시작 전 30분 이상 지난 알림은 다시 표시되지 않습니다. 30분 이내 알림은 재시작 후에도 표시될 수 있습니다.

운용 중 PC가 꺼지면 어떻게 되나요?¶

새 주문이 실행되지 않습니다. 재시작 시 보유 포지션과 미체결 주문이 자동으로 복원됩니다. Upbit는 24/7 거래소이므로 야간/주말 동안 PC가 꺼지면 그 시간만큼 새 신호가 처리되지 않으니, 항시 운용을 원한다면 PC 연결이 중단되지 않도록 유의하세요.

24/7 거래소에서 KRX(국내주식) 장중/장마감 정책이 적용되나요?¶

적용되지 않습니다. Upbit는 24시간 거래되므로 KRX의 09:00 장 시작 / 15:30 장 마감 / 15:20 동시호가 정책이 모두 무관합니다. 이전 버전에 있던 rule.close_before(...)(장마감 N분 전 청산)와 market.minutes_until_close / market.minutes_since_open은 제거되었습니다 (#29). 시간 기반 정책이 필요하면 market.time (KST "HH:MM" 문자열)을 직접 비교해 사용자 코드에서 처리하세요. 한 번 청산(release)된 종목은 60분간 같은 전략이 자동 재진입하지 않는 고정 쿨다운이 적용됩니다.

손절 설정을 했는데도 예상보다 낮은 가격에 체결됩니다¶

급격한 가격 변동 구간(저유동성 시간대, 시장가 슬리피지)에서는 손절가보다 불리한 가격에 체결될 수 있습니다. 시스템의 한계이며 100% 방어는 보장되지 않습니다.

또한 백테스트 결과에서 expected_price(리스크 트리거 가격)와 fill_price(실제 체결가)는 다를 수 있습니다. 특히 next_open 체결 모델에서는 다음 봉 시가로 체결될 수 있습니다. 백테스트 마지막 캔들에서 리스크가 트리거될 경우 다음 봉이 없으므로 트리거 시점 종가로 강제 체결됩니다.

손절/익절 값은 어떤 단위로 입력하나요?¶

퍼센트(%) 단위로 입력합니다. 3을 입력하면 3%를 의미합니다. 0.03처럼 소수 형태로 입력하면 0.03%로 처리됩니다.

업비트에서 소수점 수량 체결이 거래 탭에 반영되지 않습니다¶

업비트 피벗 진행 단계에서는 주문 수량 단위가 정수만 안전하게 처리되도록 일시적으로 제한되어 있습니다. KRW-BTC 등에서 소수점 수량 체결(예: 0.5 BTC)이 발생하면 거래 로그에 upbit dispatch: dropped fractional fill ... 또는 upbit recovery: ... skipped (fractional ...) 메시지가 기록되고, 해당 주문은 거래 탭에서 직전 상태로 남습니다(자동 부분체결/체결완료 진행이 일어나지 않음).

자세한 동작과 권장 대응(정수 단위 마켓 사용, 거래소 화면 직접 확인, 수동 후속 주문)은 운영 가이드의 "업비트 소수점 체결 알림" 섹션을 참고하세요. Decimal 기반 주문 FSM 리팩터(KIS 제거 단계)가 끝나면 자동 해제됩니다.

LLM 사용 중 `beta_llm_daily_limit_exceeded`가 나옵니다¶

베타 계정의 런타임 LLM 일일 호출 한도(UTC 일자 기준)에 도달했다는 의미입니다. 동시에 여러 요청을 보내도 한도를 넘지 않도록 엄격히 차단됩니다.

HTTP 상태코드: 429
에러 코드: beta_llm_daily_limit_exceeded
조치: UTC 기준 다음 날까지 대기하거나, 운영팀에 계정 한도 조정을 요청하세요.

회사 문의¶

운영사는 누구인가요?¶

quantiq는 세컨드스테이지(SecondStage)가 운영합니다. 회사 소개 및 연락처는 quantiq.kr/about 페이지에서 확인할 수 있습니다.

문의는 어디로 하나요?¶

이메일로 문의해 주세요: contact@quantiq.kr