가이드 센터로 돌아가기
Upbit beginner path

업비트 API 키 발급 가이드

PC 웹에서 전용 Open API Key를 만들고, 조회 권한과 고정 IP부터 확인한 뒤 BlockNuri에 등록합니다.

Before you start
  • PC 웹에서 진행
  • 전용 키 이름 사용
  • 출금/입출금 권한 제외
  • BlockNuri 고정 IP 등록
  • Secret Key 즉시 등록

업비트 공식 문서는 PC 웹 발급, 고객확인/2채널 인증, 허용 IP 등록, Secret Key 최초 1회 표시를 안내합니다.

Step-by-step

화면을 닫기 전까지 이 순서대로 확인합니다.

  1. 01

    업비트 PC 웹 로그인

    모바일 앱이 아니라 PC 웹에서 로그인한 뒤 고객확인과 2채널 인증 상태를 먼저 확인합니다.

    마이페이지에서 Open API 관리 화면으로 이동합니다.

  2. 02

    전용 키 목적 정하기

    BlockNuri 자동 적립 전용으로 구분할 수 있는 이름을 정하고, 기존 봇이나 개인 테스트 키와 섞지 않습니다.

    전용 이름을 메모한 뒤 새 API Key 발급을 시작합니다.

  3. 03

    권한은 조회부터 선택

    처음 연결은 자산 조회와 주문 조회 수준의 최소 권한으로 시작합니다. 주문 권한은 라이브 안전 게이트를 통과한 뒤에만 검토합니다.

    출금, 입출금 관리, 불필요한 권한은 선택하지 않습니다.

  4. 04

    허용 IP 등록

    업비트는 키에 사용할 공개 IP를 등록해야 합니다. 서비스 설정 화면에 표시되는 BlockNuri 고정 outbound IP를 입력합니다.

    개인 PC 사설 IP나 유동 IP를 대신 넣지 않습니다.

  5. 05

    2채널 인증 후 Secret 등록

    2채널 인증이 끝나면 Access Key와 Secret Key가 표시됩니다. Secret Key는 최초 발급 화면에서만 확인할 수 있습니다.

    복사 직후 BlockNuri 설정 화면에 등록하고 브라우저/메모장에 남기지 않습니다.

Avoid mistakes

초보자가 가장 많이 놓치는 부분

아래 항목 중 하나라도 애매하면 키를 등록하지 말고 새 전용 키를 만드는 편이 운영상 더 안전합니다.

출금 권한 선택 금지

BlockNuri의 지원 흐름은 출금 가능한 키를 필요로 하지 않습니다. 출금 권한이 있는 키는 새로 만드는 편이 안전합니다.

Secret Key 재노출 불가

Secret Key를 잃어버렸다면 기존 키를 삭제하고 새 키를 발급해야 합니다. BlockNuri도 저장 후 다시 보여주지 않습니다.

허용 IP 불일치

`no_authorization_ip` 오류가 보이면 업비트에 등록한 IP와 BlockNuri 서비스 IP가 다른 상태입니다.

BlockNuri flow

키를 만든 뒤 BlockNuri에서는 이렇게 확인합니다.

설정 > 거래소 API 키

업비트를 선택하고 Access Key와 Secret Key를 한 번만 입력합니다.

조회 확인

키 복호화, 권한, 허용 IP, 계정 조회가 통과하는지 확인합니다.

전략 운용금

거래소 총자산이 아니라 별도로 정한 운용금과 주문 한도만 사용합니다.

페이퍼 준비

실거래 전에는 paper ready 상태와 감사 로그를 먼저 확인합니다.

Troubleshooting

연결이 안 될 때 먼저 보는 체크

Open API Key 발급 버튼이 비활성화됨

권한을 하나 이상 선택했는지, IP 주소를 입력했는지, 필수 동의 체크를 완료했는지 확인합니다.

`expired_access_key` 오류

만료된 키를 삭제하고 새 전용 키를 발급한 뒤 BlockNuri에 다시 등록합니다.

`no_authorization_ip` 오류

업비트 Open API 관리에서 허용 IP를 BlockNuri 설정 화면의 서비스 IP로 수정합니다.

Source

세부 발급 화면은 거래소 정책에 따라 바뀔 수 있으므로 최종 확인은 공식 문서를 기준으로 합니다.

업비트 공식 API Key 문서