API Connection Guide

QTRA API 연결 가이드

출금 권한 없이 거래 실행 권한만 연결하는
안전한 설정 방법

Three Principles

세 가지 핵심 원칙

QTRA는 매매 권한만 받습니다. 자산은 본인 거래소 계좌에 그대로 보관됩니다.

Scoped
Trade-Only
API
시세 조회와 매매 실행 권한만 활성화합니다.

가격 정보를 읽고 매수·매도 주문을 실행하는 권한만 부여합니다. 그 외의 행위는 시스템 차원에서 차단됩니다.

Custody
User-Controlled
Assets
자산은 본인 명의 거래소 계좌에 그대로 보관됩니다.

자산은 거래소 본인 명의 계좌에 보관됩니다. QTRA의 서버나 지갑으로 이동하지 않으며, 입출금은 본인만 가능합니다.

Step-by-Step Guide

단계별 설정 방법

PC 웹 브라우저에서 진행하는 것을 권장합니다. 약 5분 정도 소요됩니다.

01

PC에서 거래소 로그인

PC 웹 브라우저에서 본인 명의의 거래소 계정에 로그인합니다. 모바일 앱이 아닌 PC 웹 환경에서 진행하는 것이 안전합니다.

Tip
로그인 시 2단계 인증(2FA)이 활성화되어 있는지 확인하세요. 활성화되어 있지 않다면 보안 설정에서 먼저 활성화하시는 것을 권장합니다.
02

API Management 메뉴 이동

화면 우측 상단의 프로필 아이콘을 클릭합니다. 드롭다운 메뉴에서 API Management(API 관리)를 선택합니다.

Note
거래소 인터페이스가 업데이트되어 메뉴 위치가 변경될 수 있습니다. 찾기 어려운 경우 Account(계정) 또는 Settings(설정) 메뉴 안을 확인하세요.
03

새 API Key 생성

New API 또는 Create New Key 버튼을 클릭합니다. 새 API Key 발급 화면이 열립니다.

04

API 이름과 권한 설정

API 이름을 자유롭게 입력합니다. 예) QTRA

권한 설정에서 Read(시세 조회)와 Trade / Spot Trading(거래 실행) 항목을 활성화합니다. 그 외의 권한은 활성화하지 않습니다.

Recommended
API 이름은 구분하기 쉽도록 QTRA처럼 명확하게 입력하시는 것을 권장합니다. 여러 API를 발급한 경우 관리에 도움이 됩니다.
05

출금 권한 OFF 확인

Withdraw(출금) 권한이 비활성화 (OFF) 상태인지 반드시 확인합니다. QTRA는 출금 권한을 요구하지 않으며, 이 권한이 활성화되어 있으면 안 됩니다.

Critical
출금 권한이 활성화된 상태로 API를 발급하면, 만에 하나 API Key가 외부에 노출되었을 때 자산이 외부로 이동할 수 있는 위험이 발생합니다. 반드시 OFF 상태인지 확인하세요.
06

Google Authenticator 2FA 인증

거래소가 요청하는 보안 인증을 진행합니다. Google Authenticator 앱에 표시된 6자리 인증 코드를 입력합니다.

이메일 인증 코드 또는 SMS 인증이 추가로 요구될 수 있습니다. 거래소 화면 안내에 따라 진행하세요.

07

API Key / Secret Key 저장

발급 완료 후 화면에 API KeySecret Key가 표시됩니다. 두 값을 안전한 곳에 저장하세요.

Important
Secret Key는 발급 직후에만 표시됩니다. 이 화면을 닫으면 다시 확인할 수 없으므로 반드시 발급 즉시 저장하세요. 잃어버린 경우 새로 발급받아야 합니다.
Tip
비밀번호 관리자(1Password, Bitwarden 등) 또는 안전한 메모 앱에 저장하시는 것을 권장합니다. 이메일·SMS·SNS 등으로 본인에게 전송하는 것은 권장하지 않습니다.
08

QTRA 봇 활성화

www.qtra.ai 회원 페이지의 API 연결 화면에서 발급받은 API Key와 Secret Key를 등록합니다. 연결이 완료되면 자동매매 시스템이 활성화됩니다.

연결 과정에서 어려움이 있으시면 가입 시 안내받은 추천인에게 직접 문의해주세요.

Pre-connection Checklist

QTRA 연결 전 체크리스트

아래 항목을 모두 확인한 후 QTRA에 API를 연결합니다.

  • 출금 권한 OFF 확인 API 권한 설정에서 Withdraw 항목이 비활성화되어 있는지 확인
  • 거래 권한 ON 확인 Read(시세 조회)와 Trade(매수·매도 실행) 권한만 활성화
  • API Key 저장 완료 안전한 비밀번호 관리자 또는 메모 앱에 저장
  • Secret Key 안전 보관 발급 직후에만 표시되므로 반드시 저장. 외부 공유 금지
  • 2단계 인증(2FA) 활성화 확인 거래소 계정 보안 설정에서 Google Authenticator 등 2FA 활성화
  • 리스크 고지 확인 자동매매는 손실 위험이 있으며 과거 성과는 미래 수익을 보장하지 않습니다
Important Notice

반드시 지켜야 할 것

API와 자산 보호를 위해 아래 사항을 반드시 준수하세요.

01

Secret Key는 타인에게 공유하지 마세요

Secret Key는 본인 외 누구에게도 공유해서는 안 됩니다. QTRA 직원, 거래소 직원, 가족, 지인 모두 마찬가지입니다. 정상적인 절차에서는 Secret Key를 누군가에게 알려줄 일이 없습니다.

02

출금 권한은 절대 활성화하지 마세요

QTRA는 출금 권한을 요구하지 않습니다. 출금 권한이 활성화된 API는 만에 하나 노출되었을 때 자산이 외부로 이동할 수 있는 위험이 있습니다. 반드시 비활성화 상태로 유지하세요.

03

자동매매는 손실 위험이 있습니다

자동매매 시스템은 시장 상황에 따라 손실이 발생할 수 있습니다. QTRA는 자동화된 매매 도구이며, 투자 판단의 최종 책임은 회원 본인에게 있습니다. 본인이 감당 가능한 자본 범위 내에서 운용하세요.

04

과거 성과는 미래 수익을 보장하지 않습니다

QTRA가 공개한 과거 운용 기록은 검증된 실제 계좌 데이터이지만, 향후 동일한 성과를 보장하지 않습니다. 가상자산 시장은 변동성이 크며, 손실 위험이 항상 존재합니다.

Investment Risk Notice

과거 실적은 미래 수익을 보장하지 않으며, 가상자산 거래에는 손실 위험이 있습니다. QTRA는 자동화된 매매 도구이며, 투자 판단의 최종 책임은 회원 본인에게 있습니다.

Need Help

어려움이 있으시면 문의 주세요

디지털 환경이 익숙하지 않으셔도 괜찮습니다.
궁금한 점은 가입 시 안내받은 추천인에게 직접 문의해주세요.