가상자산 API 키 만들기 전: 조회·주문·출금 권한을 나눠 보는 5가지
자동 매매 도구나 자산 조회 앱을 연결하려고 가상자산 API 키를 만들 때는, 먼저 ‘편리하게 연결할 수 있나’보다 ‘이 키가 어디까지 할 수 있나’를 확인해야 합니다. 잔고 조회만 필요한 도구에 주문이나 출금 권한까지 붙이면, 문제가 생겼을 때 영향 범위가 불필요하게 커질 수 있습니다.
가상자산 API 키는 비밀번호를 대신하는 장식용 코드가 아닙니다. 거래소가 정한 범위 안에서 계정 기능을 호출하는 인증 정보이므로, 기능별 권한·허용 IP·보관 위치를 한 묶음으로 점검하는 것이 출발점입니다. 이 글은 특정 서비스의 사용을 권유하거나 투자 판단을 제시하지 않습니다. 가상자산 거래에는 가격 변동과 원금 손실 위험이 있습니다.
API 키를 만들기 전에 ‘필요한 기능’부터 한 줄로 적는다
연결하려는 목적이 시세 조회인지, 보유 자산 확인인지, 주문 실행인지에 따라 필요한 권한은 다릅니다. 목적을 적지 않은 채 권한을 넓게 선택하면 나중에 어떤 프로그램이 어떤 기능을 쓰는지 추적하기가 어려워집니다.
가장 간단한 시작은 도구별로 한 문장을 남기는 것입니다. 예를 들어 ‘이 프로그램은 잔고만 읽는다’, ‘이 프로그램은 주문을 전송한다’, ‘이 프로그램은 출금 기능을 사용하지 않는다’처럼 적어 두면 권한 선택 화면에서 불필요한 항목을 줄이는 기준이 생깁니다.
| 연결 목적 | 먼저 확인할 권한 | 추가로 확인할 점 |
|---|---|---|
| 보유 자산 확인 | 자산 조회 | 화면에 보이는 자산 범위와 갱신 주기 |
| 주문 내역 확인 | 주문 조회 | 미체결·체결 완료 정보의 구분 |
| 주문 전송 | 주문하기 | 주문 단위, 오류 처리, 중단 방법 |
| 출금 관련 기능 | 출금하기·출금조회 | 출금 안심차단과 수취처 조건 |
업비트 문서의 권한 그룹을 기능별로 읽는다
업비트 개발자 센터의 인증 안내는 API Key 발급 시 사용 용도에 따라 필요한 권한만 선택적으로 부여할 수 있다고 설명합니다. 업비트 개발자 센터의 인증 안내는 API Key 권한을 발급 시 필요한 기능으로 제한하는 기준을 제시합니다. 같은 안내에는 자산조회, 주문하기, 주문조회, 출금하기, 출금조회, 입금 관련 권한 그룹이 별도로 제시돼 있습니다.
여기서 중요한 점은 ‘자산조회가 된다’와 ‘주문을 낼 수 있다’가 같은 권한이 아니라는 것입니다. 주문을 전송할 필요가 없는 분석 도구라면 주문 권한을 기본값처럼 포함하지 않는 편이 합리적입니다. 반대로 주문 기능이 꼭 필요하다면, 주문을 멈추는 방법과 오류가 났을 때 사람이 확인할 절차를 먼저 정해야 합니다.
| 권한을 고를 때의 질문 | 확인 뒤의 행동 |
|---|---|
| 이 도구가 실제 주문을 보내는가 | 아니라면 주문하기 권한을 선택하지 않음 |
| 출금 기능을 쓰는가 | 아니라면 출금 관련 권한을 추가하지 않음 |
| 주문 기록만 읽으면 되는가 | 주문조회와 주문하기를 구분해 선택 |
| 도구를 더 이상 쓰지 않는가 | 기존 키를 삭제하거나 폐기 절차를 확인 |
Secret Key는 다시 볼 수 있다고 가정하지 않는다
업비트 인증 문서는 API Key가 Access Key와 Secret Key 쌍으로 구성되며, Secret Key는 발급 시에만 확인할 수 있다고 안내합니다. 발급 화면을 닫은 뒤에는 ‘나중에 복사하면 된다’고 생각하기보다, 처음부터 안전한 보관 장소와 복구 절차를 정해 두는 편이 낫습니다.
Secret Key를 메모장, 화면 캡처, 공개 저장소, 메시지방에 남기는 방식은 피해야 합니다. 한국인터넷진흥원 정보보호 API 공유 포털의 이용약관도 API Key를 환경변수 또는 보안 저장소로 관리하고, 소스코드·공개 저장소·클라이언트 코드에 노출하지 말 것을 명시합니다. 실제로 사용하는 거래소와 개발 환경의 규칙이 다를 수 있으므로, 서비스의 최신 약관과 보안 안내를 우선 확인해야 합니다.
보관 위치를 고를 때의 최소 기준
- Secret Key가 일반 문서나 캡처 파일에 남지 않게 합니다.
- 코드 저장소에 키 문자열을 직접 넣지 않습니다.
- 팀이나 외부 도구가 필요하다면 접근 가능한 사람과 교체 절차를 미리 정합니다.
- 유출이 의심되면 기존 키를 계속 쓰지 않고 해당 서비스의 삭제·재발급 안내를 확인합니다.
허용 IP는 ‘현재 내 컴퓨터 화면’이 아니라 실제 호출 환경을 본다
API 키를 발급할 때 허용 IP를 등록하는 기능이 있다면, 프로그램이 실제로 외부 통신을 보내는 환경의 공개 IP를 확인해야 합니다. 집이나 사무실 PC에서 작업하는지, 서버에서 실행하는지, 네트워크가 바뀌는지에 따라 등록할 주소가 달라질 수 있습니다.
업비트의 API Key 발급 안내는 사용 기능을 고른 뒤 해당 키를 사용할 공개 IP 주소 목록을 등록하는 절차를 안내합니다. 또한 FAQ는 거래·자산 관리 API를 고정 IP 환경의 허용 목록과 함께 사용하도록 설명합니다. 단순히 로컬 네트워크의 내부 주소를 적는다고 연결 문제가 해결되는 것은 아니므로, 오류가 났을 때는 프로그램의 실행 위치와 외부 통신에 쓰인 주소를 구분해 봐야 합니다.
| 상황 | 확인할 항목 | 흔한 오해 |
|---|---|---|
| 개인 PC에서 실행 | 외부 통신에 쓰이는 공개 IP | 공유기 내부 주소를 등록하면 된다는 생각 |
| 서버에서 실행 | 서버의 외부망 IP와 변경 가능성 | 개발 PC의 IP가 그대로 적용된다는 생각 |
| IP가 바뀐 뒤 오류 | 허용 목록과 실행 환경 | 키가 무조건 만료됐다는 판단 |
| 도구를 중단함 | 키 삭제 여부 | 프로그램만 지우면 키도 사라진다는 생각 |
주문 권한과 출금 권한은 같은 위험도로 다루지 않는다
주문 기능은 가격과 수량에 영향을 주고, 출금 기능은 자산 이동과 연결됩니다. 두 권한을 모두 필요한 경우에도 한 개의 키에 넓게 묶는 것이 항상 편리한 선택은 아닙니다. 서비스가 허용하는 범위 안에서 용도별 키를 분리할 수 있는지, 각 키의 권한을 나중에 목록에서 확인할 수 있는지를 점검해 보세요.
업비트 문서는 출금하기 권한이 포함된 키에 출금 안심차단이 적용될 수 있으며, 출금 기능 사용 전 별도 해제 절차를 안내합니다. 이 절차를 우회하려는 방법을 찾기보다, 출금이 정말 필요한 연결인지 다시 판단하고 서비스 화면의 최신 보안 절차를 따라야 합니다.
실전 예시로 자산 조회용 대시보드를 새로 연결한다면, 처음에는 조회 권한과 공식 문서에서 확인한 허용 IP만 설정한 뒤 화면이 정상적으로 동작하는지 확인할 수 있습니다. 주문이나 출금이 필요한 별도 도구를 나중에 쓰게 되더라도, 같은 키의 권한을 무작정 넓히기보다 새 용도와 관리 책임을 다시 점검하는 편이 안전합니다.
5분 점검표: 발급 직전과 발급 뒤에 나눠 확인하기
API 키 관리는 한 번 발급하고 끝나는 설정이 아닙니다. 도구를 바꾸거나 사용 목적이 달라지면 권한과 허용 IP도 다시 확인해야 합니다.
- [ ] 이 키의 목적을 조회·주문·출금 중 하나 이상의 구체적인 문장으로 적었습니다.
- [ ] 목적에 없는 권한은 선택하지 않았습니다.
- [ ] Secret Key를 코드·캡처·메신저에 남기지 않을 보관 방법을 정했습니다.
- [ ] 실제 호출 환경의 공개 IP와 허용 목록을 대조했습니다.
- [ ] 출금 권한이 필요한 이유와 서비스의 보안 절차를 확인했습니다.
- [ ] 더 이상 쓰지 않는 키의 삭제 또는 폐기 방법을 확인했습니다.
가상자산 API 키의 핵심은 가장 많은 기능을 켜는 데 있지 않습니다. 필요한 기능만 남기고, 실행 환경과 보관 방식을 함께 관리해야 연결 도구가 바뀌어도 계정 접근 범위를 파악하기 쉬워집니다.
출처
- 업비트 개발자 센터, 인증: https://docs.upbit.com/kr/reference/auth
- 업비트 개발자 센터, API Key 발급 받기: https://docs.upbit.com/kr/kr/docs/api-key
- 한국인터넷진흥원 정보보호 API 공유 포털, 서비스 이용약관: https://security-api.kisa.or.kr/portal/content/terms-service