거래소 API 키는 비밀번호와 별개로 어떤 기능을 허용할지(권한)와 어느 공인 IP에서만 부를지(허용 IP)를 발급 때 정하는 열쇠입니다. 업비트 개발자센터는 권한을 최소 하나 이상 고르고 허용 IP를 입력하게 하며, 출금하기 권한이 있는 키에는 출금 안심차단을 자동으로 건다고 안내합니다. 이 글은 업비트 문서 한 곳의 기준만 읽었으므로 다른 거래소가 같다고 말할 수 없고, IP 제한이 키 유출 피해를 어디까지 막는지도 문서가 설명하지 않아 확정하지 않습니다.
확인 기준일 2026-10-27 · 다음 확인 예정 2026-11-26
발급 조건과 권한 목록
발급은 PC 웹에서만 가능하고, 고객 확인과 2채널 인증을 마친 뒤에 할 수 있습니다. 한 포켓에서 만들 수 있는 키는 메인포켓 최대 10개, 서브포켓당 최대 5개입니다. 포켓 문서는 서브포켓을 키에 부여된 권한 안에서 독립적으로 동작하고 외부 입출금이 제한되는 공간으로 설명합니다.
| 권한명 | 주요 기능 |
|---|---|
| 자산조회 | 해당 포켓의 보유자산·잔고 조회 |
| 주문조회 / 주문하기 | 체결·미체결 주문 조회 / 매수·매도 주문 접수와 취소 |
| 입금조회 / 입금하기 | 디지털 자산·원화 입금 내역 조회 / 원화 입금 요청과 트래블룰 검증 등 |
| 출금조회 / 출금하기 | 출금 내역 조회 / 디지털 자산·원화 출금 요청 |
| 포켓관리 / 자산이전 | 모든 포켓의 자산 조회·이전 실행과 포켓 정보 조회 / 해당 포켓 기준의 포켓 간 이전 실행과 내역 조회 |
이 표에서 읽을 수 있는 실용적 기준은 권한을 쓸 기능만큼만 고르는 것입니다. 조회용 프로그램이라면 조회 권한만으로 충분한지 먼저 따져 보면 됩니다. 다만 어느 권한이 어느 포켓에서 선택되는지는 표의 표시가 모호해 옮기지 않았습니다.
허용 IP와 출금 안심차단
허용 IP는 외부 통신에 쓰이는 공인 IP를 입력해야 하며 사설 IP는 등록할 수 없습니다. 문서는 유동 IP 환경을 권장하지 않고 고정 IP를 쓰라고 안내합니다. 등록되지 않은 IP에서 호출하면 no_authorization_ip 오류가 나고, 허용 IP를 추가한 뒤 다시 요청하라고 합니다. 출금하기 권한이 있는 키는 발급 때 출금 안심차단이 자동 적용되어 출금 API를 호출할 수 없고, 해제는 모바일 앱의 Open API 관리에서 합니다. 문서는 이 차단이 원화와 디지털 자산 출금 모두에 적용된다고 답합니다. 거래소 쪽 출금 주소 제한은 출금 주소 화이트리스트 글에서 보호 범위를 따로 다뤘습니다.
유출 때와 운영 습관
Secret key는 최초 발급 화면에서만 확인할 수 있어 별도로 안전하게 보관해야 하고, 노출되면 해킹 위험이 있다고 문서가 적습니다. 분실이나 유출 때는 기존 키를 삭제하고 새 키를 발급받으라는 안내입니다. Exchange API의 요청 한도는 포켓 단위로 적용되고 같은 포켓의 키는 한도를 공유한다고 하니, 키를 여러 개 만들어도 한도가 늘지 않을 수 있습니다. 한도 변경 공지를 읽는 법은 API 호출 한도 변경 공지 글에 있습니다. 전반적인 계정 점검은 계정 보안 점검 글을 이어 보세요.
자주 묻는 질문
허용 IP만 걸어 두면 키가 새어도 안전한가요?
문서는 IP 제한의 보호 효과를 그렇게 설명하지 않습니다. 이 글은 안전하다고 단정하지 않으며, 유출이 의심되면 키 삭제와 재발급이 문서의 안내입니다.
집 인터넷의 IP가 바뀌면 어떻게 되나요?
문서는 유동 IP 환경을 권장하지 않습니다. 등록되지 않은 IP에서의 요청은 오류가 나므로 허용 IP를 변경해야 합니다.
다른 거래소 API도 같은 구조인가요?
이번에는 업비트 문서만 읽었습니다. 다른 거래소의 권한 구성과 IP 정책은 각 공식 문서를 확인해야 합니다.
