API Key 발급 받기

시작하기

API Key는 사용자의 신원과 API 호출 권한을 확인하기 위해 사용되는 인증 정보입니다. 자산 조회, 주문, 입출금 관리와 같이 사용자 계정과 연동되는 API를 호출하기 위해서는 반드시 사전에 API Key를 발급받고, 요청에 인증 정보를 포함해야 합니다. 본 가이드에서는 업비트 API Key 발급 방법과 관리 주의사항을 안내합니다.

API Key 발급 정책 및 주의사항

업비트 API Key 발급은 PC 웹 환경에서만 가능합니다.
계정당 최대 10개의 API Key를 발급할 수 있으며, 하나의 API Key에 등록 가능한 허용 IP 수는 최대 10개 입니다.
업비트 회원가입 후 고객 확인 및 2채널 인증(2FA)을 완료한 뒤에 API Key 발급이 가능합니다.

API Key 발급 절차

1. API 관리 페이지로 이동

업비트 PC 웹에 로그인한 후, [마이페이지 > Open API 관리]로 이동합니다.

2. 생성할 API Key 권한 선택 및 허용 IP 주소 등록

API Key로 수행하고자 하는 API 기능 권한을 모두 선택합니다. 최소 하나 이상의 기능을 선택한 후 IP 주소 등록 란에 해당 API Key를 사용할 공개 IP 주소 목록을 입력합니다. 개인정보 수집 및 이용 동의란에 체크한 뒤 Open API Key 발급받기 버튼을 클릭하여 API Key 발급을 요청합니다.

3. API Key 발급을 위한 2채널 인증 수행

API Key 발급 인증을 위해 표시되는 인증 안내 팝업에서 사용하고자 하는 2채널 인증 수단을 선택합니다. 선택한 인증 수단을 통해 본인 인증을 완료한 후 API Key 발급이 완료됩니다. 2채널 인증 관련한 자세한 사항은 업비트 고객 센터 > 자주하는 질문 > 2채널 인증 문서를 참고해주시기 바랍니다.

4. API Key 발급

인증이 정상적으로 수행된 경우 API Key 발급이 완료되어 Access key와 Secret key를 확인할 수 있습니다. Secret key는 최초 발급 화면에서만 확인 가능하므로 반드시 안전한 곳에 별도로 보관하시기 바라며, 타인에게 노출 시 해킹의 위험에 놓일 수 있으니 노출되지 않도록 보안에 유의해주시길 바랍니다.

5. API Key 관리

[변경] 버튼을 클릭하여 허용 IP 주소 목록을 수정할 수 있습니다.

[삭제] 버튼을 클릭하여 발급된 API Key를 삭제할 수 있습니다. API Key 분실 혹은 유출 시 기존 키를 삭제하고 신규 키를 발급받아 사용하시기 바랍니다.

마치며

본 가이드에서는 계정 연동 API 호출에 필요한 API Key를 발급받고 관리하는 방법을 알아보았습니다. 발급받은 API Key를 활용한 인증 방법은 아래 What's Next 영역을 참고하여 확인해주시기 바랍니다.

자주 들어오는 질문

Q. 등록 가능한 IP는 무엇인가요?

허용 IP 주소는 외부 네트워크 통신에 이용되는 공개(공인)IP 주소를 입력해주셔야 합니다.
- 개인 PC 환경에서는 사용중인 네트워크의 공개 IP 주소를 등록합니다.
- 서버 환경에서는 해당 서버의 외부망 통신에 사용되는 IP 주소를 등록합니다.
사설 IP는 외부 접근이 불가능하므로 등록할 수 없습니다.
업비트 API는 유동 IP 환경에서의 이용을 권장하지 않습니다. 고정 IP(Static IP)를 사용하여 등록해주시기 바랍니다.
구글 등의 검색엔진에서 "what is my ip" 혹은 "내 IP 주소" 등을 검색하여 접속한 후 현재 사용중인 IP 주소를 확인할 수 있습니다.

Q. Open API Key 발급 버튼이 활성화되지 않습니다.

API Key 발급 조건이 만족되지 않은 경우 Open API Key 발급 버튼이 활성화되지 않습니다. 아래 조건을 모두 만족하였는지 확인해주시기 바랍니다.

Open API에서 이용할 기능 권한 중 하나 이상의 기능을 선택
‘IP 주소 등록’창에 하나 이상의 IP를 입력
- 등록하려는 IP 주소가 올바른 양식인지 확인 부탁드립니다.
  (공백 포함 여부 확인, 각기 다른 IP 주소 간 구분이 아닌 한 IP주소 내에 콤마 포함 여부 확인)
- IPv4형식의 IP 주소만 지원합니다.
'개인정보 수집 및 이용 동의(필수)' 동의 체크박스를 클릭

Q. 만료된 API Key는 어떻게 삭제하나요?

업비트 웹 PC에 로그인한 후 Open API 관리 페이지로 이동합니다.
스크롤을 내려 페이지 하단의 ‘만료된 Key’ 버튼을 클릭합니다.
삭제할 API Key의 체크박스를 클릭한 후 우측 상단의 삭제 버튼을 눌러 삭제합니다.

Q. 등록된 API Key가 없는데 "최대 Open API 토큰 발급 수량을 초과했습니다"라는 안내가 뜹니다.

해당 팝업이 노출되는 경우, [만료된 Key] 탭으로 이동하여 조회되는 만료된 Key를 삭제하시고 다시 등록해보시길 바랍니다.