The Option × AutoMultiTrader

The Option 공식 자동매매 API 설정 방법

이미지와 함께 AMT의 공식 API 연결 준비를 안내합니다. API 키와 전용 계좌를 준비한 후 데모에서 먼저 확인하세요.

설정 개요

The Option은 메인 계좌와 자동매매 계좌를 별도로 관리합니다. 실거래에는 자동매매 잔액과 실거래 API 키가 필요합니다. 데모 키와 실거래 키를 AMT에 각각 등록하세요.

  1. 단계 01

    API 화면 열기

    The Option 계정 메뉴에서 자동매매 API를 엽니다.

  2. 단계 02

    전용 계좌로 자금 이체

    실거래 자금을 메인 계좌에서 자동매매 계좌로 이체합니다.

  3. 단계 03

    API 키 발급

    이용할 환경의 탭에서 키를 발급하고 안전하게 보관합니다.

  4. 단계 04

    AMT에 키 등록

    AMT 공식 API 모듈에 데모 키와 실거래 키를 각각 등록합니다.

이미지는 The Option 공식 도움말의 일본어 화면입니다. 이미지를 선택하면 확대됩니다. 화면 구성과 버튼 이름은 변경될 수 있습니다.

단계 01

API 화면 열기

  1. The Option에 로그인

    The Option 공식 사이트에서 본인 계정에 로그인하세요.

  2. 자동매매 API를 선택하고 계좌 확인

    마이페이지 또는 계정 메뉴에서 자동매매 API를 엽니다. 실거래 탭에서 메인 잔액과 자동매매 잔액을 확인하고, 연습할 때는 체험 탭을 사용하세요.

    계정 메뉴의 자동매매 API 화면. 실거래 탭에 두 잔액이 표시됩니다.
    계정 메뉴의 자동매매 API 화면. 실거래 탭에 두 잔액이 표시됩니다.
단계 02

전용 계좌로 자금 이체 중요

실거래 API 주문에는 자동매매 잔액이 사용됩니다. 메인 계좌 입금 후 사용할 금액을 전용 계좌로 이체해야 합니다.

자금 이체가 필요한 이유

전용 계좌를 통해 일반 거래와 자동매매의 자금 및 기록을 구분할 수 있습니다. 자동매매 잔액이 부족하면 주문할 수 없습니다. 감당 가능한 손실 범위에서 금액을 정하세요.

  1. 실거래 탭에서 자금 이체 열기

    메인 잔액과 자동매매 잔액을 확인한 후 사이에 있는 자금 이체를 선택하세요.

    메인 잔액과 자동매매 잔액 사이의 자금 이체 버튼.
    메인 잔액과 자동매매 잔액 사이의 자금 이체 버튼.

  2. 출금 계좌, 입금 계좌, 금액 확인

    출금 계좌가 메인, 입금 계좌가 자동매매인지 확인하세요. 금액을 입력하고 내용을 검토한 후 이체를 확인하세요.

    출금 메인, 입금 자동매매를 확인한 후 금액을 입력합니다.
    출금 메인, 입금 자동매매를 확인한 후 금액을 입력합니다.

  3. 자동매매 잔액 반영 확인

    잔액 화면으로 돌아가 이체한 금액이 자동매매 잔액에 반영되었는지 확인하세요.

단계 03

API 키 발급 중요

API 키는 발급 직후에만 표시됩니다. 화면을 닫기 전에 복사하여 안전하게 보관하세요. 제3자에게 공개하지 마세요. AMT 고객지원에도 키를 보낼 필요는 없습니다.

  1. 실거래 탭에서 API 키 발급

    실거래 키는 실거래 탭의 API 키 생성을 선택합니다. 이용 조건을 읽고 동의한 후 생성하세요. 데모 키는 아래 체험 안내를 참고하세요.

    API 키 생성을 선택하고 이용 조건에 동의한 후 발급합니다.
    API 키 생성을 선택하고 이용 조건에 동의한 후 발급합니다.

  2. 표시된 키 복사 및 보관

    표시된 키를 복사하여 비밀번호 관리자 등 안전한 곳에 보관하세요. 화면을 닫으면 같은 키를 다시 표시할 수 없습니다.

    발급 직후 API 키 표시 화면. 닫기 전에 안전하게 보관하세요.
    발급 직후 API 키 표시 화면. 닫기 전에 안전하게 보관하세요.

키 재발급 및 취소

키를 잃어버렸거나 유출이 의심되면 The Option에서 취소한 후 새로 발급하세요. 취소는 즉시 적용됩니다. AMT에서 해당 환경의 기존 키를 삭제한 후 새 키를 등록하세요.

API 키 재발급 및 취소 버튼. 취소는 즉시 반영됩니다.
API 키 재발급 및 취소 버튼. 취소는 즉시 반영됩니다.
단계 04

AMT에 키 등록

  1. 공식 API 지원 AMT 실행

    최신 AMT를 실행하여 The Option 공식 자동매매 API를 선택하고 거래 설정을 여세요.

  2. API 키에서 해당 환경 키 등록

    데모 API 키 또는 실거래 API 키에 붙여 넣고 해당 항목의 등록을 누르세요. 데모에는 체험 키, 실거래에는 실거래 키를 사용합니다. 즉시 저장되므로 공통 메뉴의 저장은 필요하지 않습니다.

  3. 등록 상태와 거래 환경 확인

    등록 후 마지막 6자만 표시되고 나머지는 가려집니다. 짧은 키는 전부 가려집니다. 등록됨 표시만으로 API 인증 성공이 확정되지는 않습니다. 먼저 제어판에서 데모를 선택하고 설정을 확인하세요.

  4. 데모에서 연결, 잔액, 주문 조건 확인

    데모에서 시작하고 연결 상태와 잔액을 확인하세요. 시작 후 설정 조건에 따라 주문이 발생하므로 알림 설정과 금액도 확인하세요. 연결 실패나 주문 거부 사유는 AMT 시스템 로그에서 확인할 수 있습니다.

무료 다운로드 → 계정 등록하기 → AMT 시작 가이드 →

AMT에 등록한 API 키는 사용 중인 컴퓨터에 안전하게 저장됩니다.

먼저 체험 환경에서 확인

체험 환경은 가상 자금으로 API 연결과 주문을 확인할 수 있습니다. 실거래 잔액에는 영향이 없으며 별도의 체험 API 키를 사용합니다.

  1. 체험 탭에서 키 발급

    API 키 요청을 선택하고 이용 조건에 동의한 후 발급하세요. 키를 복사하여 안전하게 보관하세요.

  2. 충전으로 연습용 잔액 추가

    체험 화면의 충전에서 연습용 가상 자금을 추가할 수 있습니다.

    체험 탭의 충전에서 연습용 가상 자금을 추가할 수 있습니다.
    체험 탭의 충전에서 연습용 가상 자금을 추가할 수 있습니다.

  3. AMT 데모 API 키에 등록하여 확인

    4단계에 따라 등록하고 데모에서 계좌 정보, 주문, 판정 결과를 확인하세요. 본인 설정으로 오류 시 동작과 중복 주문 여부도 확인하세요.

실거래로 전환하려면 실거래 전용 키와 전용 잔액을 확인하고 AMT를 정지한 후 거래 환경을 변경하세요. 데모 키를 삭제하거나 덮어쓸 필요는 없습니다.

API 이용 시 주의사항

  • API 키를 이메일, 채팅, SNS, 공개 코드에 기재하지 마세요. 고객지원 문의에도 키 자체를 보내지 마세요.
  • 유출 또는 부정 사용이 의심되면 The Option에서 키를 신속히 취소하세요. 유출된 키로 제3자가 거래할 수 있습니다.
  • 실거래 결과는 백테스트나 데모와 다를 수 있습니다. 자금과 설정을 정기적으로 확인하고 감당 가능한 손실 범위에서 운용하세요.

자주 묻는 질문

키를 저장하지 않고 화면을 닫았습니다.

같은 키를 다시 표시할 수 없습니다. The Option에서 재발급한 후 AMT의 해당 환경 기존 키를 삭제하고 새 키를 등록하세요.

연결되었지만 주문되지 않습니다.

자동매매 잔액, 선택한 데모 또는 실거래 환경, 알림 설정과 주문 조건을 확인하세요. 잔액 부족 외에도 거부 사유가 있을 수 있으므로 AMT 시스템 로그에서 구체적인 이유를 확인하세요.

데모와 실거래에 같은 키를 사용할 수 있나요?

사용할 수 없습니다. The Option에서 환경별로 발급하고 AMT의 데모 API 키와 실거래 API 키에 각각 등록하세요.

API 상세 사양은 어디에서 확인하나요?

The Option 공식 API 연동 가이드

자동매매 API 화면 오른쪽 위의 API 연동 가이드 버튼.
자동매매 API 화면 오른쪽 위의 API 연동 가이드 버튼.

자료 및 화면 이미지 출처: The Option 공식 도움말: 자동매매 API 시작하기