API Key 발급

사용 승인 신청

MODA Open API를 사용하려면 회원 단위의 사용 승인이 먼저 필요합니다. 한 번 승인되면 이후 API Key는 별도 승인 없이 즉시 발급됩니다.

신청 절차

1. MODA PC 웹에 로그인한 뒤 마이페이지 > Open API 관리 메뉴로 진입합니다.

2. Open API 이용약관과 개인정보 처리방침에 동의한 후 Open API Key 사용 신청 버튼을 클릭합니다.

3. 핸드폰 본인인증을 완료합니다.

4. 신청이 완료되면 관리자 승인을 대기합니다. (영업일 1~2일)

승인 상태

상태	설명
승인대기	신청 접수 완료, 관리자 검토 중
보류	추가 확인 필요 (사유 이메일 안내)
승인 완료	API Key 발급 가능
반려	승인 거부 (반려 사유 확인 후 재신청 가능)
해지	사용 해지됨 (재사용 시 재승인 필요)

참고

관리자 승인이 완료되면 등록된 이메일로 안내가 발송됩니다. 승인 전까지 신청 취소도 가능합니다.

발급

승인이 완료되면 Open API 관리 페이지에서 바로 API Key를 발급할 수 있습니다.

발급 조건

Open API 사용 승인 완료 상태

PC 웹에서만 발급 가능

회원당 최대 20개, 계좌당 최대 3개

발급 절차

1. 권한, API Key 이름, 계좌를 설정하고 계좌 비밀번호를 입력합니다.

설정 항목	설명
권한 선택	조회 (시세 · 계좌 조회) / 주문 (주문 실행)
API Key 이름	용도를 구분하기 위한 별칭 (예: `자동매매봇`, `포트폴리오 관리`)
계좌 선택	API Key에 연결할 계좌
계좌 비밀번호	선택한 계좌의 비밀번호 (6자리)

2. 주문 권한 선택 시 핸드폰 본인인증을 추가로 완료합니다.

3. Open API Key 발급 버튼을 클릭하면 발급이 완료됩니다.

발급 결과

항목	설명	재확인
API Key (Access Key)	공개 키. JWT payload의 `access_key`로 사용	O
Secret Key	비밀 키. JWT 서명 및 요청 서명에 사용	X

주의

Secret Key는 발급 화면에서 1회만 표시되며, 화면 이탈 또는 확인 버튼 클릭 후에는 재조회가 불가합니다. 반드시 안전한 곳에 저장하세요. 분실한 경우 해당 API Key를 삭제하고 새로 발급해야 합니다.

권한

API Key 발급 시 조회와 주문 권한을 선택할 수 있습니다.

권한	화면 표시	API 값	접근 가능 API	본인인증
조회	시세 · 계좌 조회	`INQUIRY`	시세 조회, 계좌 잔고, 주문 내역 조회	불필요
주문	주문 실행	`ORDER`	매수/매도 주문 생성, 취소, 정정	필요

최소 권한 원칙

조회만 필요한 경우 조회 권한만 부여하는 것을 권장합니다. 발급된 API Key 목록에서 각 Key의 권한 상태를 확인할 수 있습니다.

관리

발급된 API Key 목록

승인 완료 후 Open API 관리 페이지 하단에서 발급된 Key 목록을 확인할 수 있습니다. Open API Key 탭과 만료된 API Key 탭으로 구분됩니다.

항목	설명
Access Key / 이름	API Key의 공개 키와 별칭
조회 / 주문	각 권한의 활성 여부
계좌	연결된 계좌번호
만료일시	Key 만료 시점
최근 사용	마지막 API 호출 시점

유효기간

항목	정책
유효기간	발급일로부터 1년 (연장 불가)
만료 알림	만료 7일 전 이메일
만료 후	자동 만료 (`EXPIRED`). 새 Key 발급 필요

API Key 상태

상태	설명
`ACTIVE`	정상 사용 가능
`DISABLED`	비활성화됨 (관리자 또는 사용자에 의해 일시 중지)
`EXPIRED`	유효기간 만료
`DELETED`	삭제됨 (복구 불가)

삭제

삭제 시 주의

삭제된 API Key는 즉시 무효화되며 복구할 수 없습니다. 해당 Key를 사용 중인 프로그램이 있다면 먼저 중단해주세요.

사용 해지

승인 완료 상태에서 페이지 상단의 사용 해지 버튼으로 Open API 사용을 해지할 수 있습니다.

해지 시 영향

발급된 모든 API Key가 즉시 삭제됩니다.
진행 중인 프로그램매매가 중단될 수 있습니다.
재사용 시 다시 사용 승인 절차가 필요합니다.

절차: Open API 관리 → 사용 해지 → 안내 확인 → 핸드폰 본인인증 → 해지 완료

보안 권장사항

항목	설명
Secret Key 노출 금지	프론트엔드 코드, 공개 저장소에 절대 포함하지 마세요
환경변수 사용	하드코딩 대신 `.env` 파일 또는 시크릿 매니저를 활용하세요
최소 권한 원칙	조회만 필요하면 조회 권한만 부여하세요
양도 금지	API Key를 타인에게 절대 양도하지 마세요
정기 교체	90일마다 API Key 갱신을 권장합니다
분실 시 조치	Secret Key 분실 또는 유출 시 즉시 삭제 후 재발급하세요

다음 인증 헤더 만들기 ->

사용 승인 신청#

신청 절차#

승인 상태#

발급#

발급 조건#

발급 절차#

발급 결과#

권한#

관리#

발급된 API Key 목록#

유효기간#

API Key 상태#

삭제#

사용 해지#

보안 권장사항#