출금하기 선택 금지
BlockNuri의 기본 연결에는 출금 권한이 필요하지 않습니다. 출금 권한을 선택했다면 새 키를 만드는 편이 안전합니다.
가이드 센터로 돌아가기
Bithumb beginner path
빗썸 API 키 발급 가이드
API 관리에서 필요한 활성 항목만 선택하고, IP 제한과 Secret Key 보관을 확인한 뒤 활성화합니다.
Before you start
- PC 계정관리에서 진행
- 키 종류 먼저 정하기
- 출금하기 제외
- BlockNuri 고정 IP 등록
- 활성화 전 Secret 복사
빗썸 공식 안내는 PC 계정관리 > API 관리, API 활성 항목, IP 제한, 보안 인증, 활성화 전 Secret Key 복사를 안내합니다.
Step-by-step
화면을 닫기 전까지 이 순서대로 확인합니다.
- 01
빗썸 PC 웹 로그인
PC에서 로그인한 뒤 계정관리의 API 관리 화면으로 이동합니다. 키 발급 전 본인 인증과 보안 설정을 확인합니다.
마이페이지 또는 계정관리에서 API 관리 화면을 엽니다.
- 02
API 활성 항목 선택
자동 매매까지 쓰려면 자산조회·주문조회·주문하기를 선택합니다(「API 키 빠른 등록」의 기본 키 종류 「자동 매매까지」). 모의·분석만 하려면 자산조회·주문조회만 선택한 「조회만」 키로 만듭니다.
출금하기와 불필요한 고위험 항목은 선택하지 않습니다.
- 03
IP 제한 입력
API를 사용할 수 있는 IP를 제한합니다. 「API 키 빠른 등록」 2단계와 설정의 「서비스 IP」 칸에 표시되는 BlockNuri IP를 입력해 키 사용 범위를 좁힙니다.
개인 PC IP 대신 서비스 IP를 기준으로 등록합니다.
- 04
보안 인증과 Key 생성
로그인 비밀번호와 보안 인증을 완료한 뒤 API Key 생성을 진행합니다.
인증 중 화면을 닫지 말고 Access/Secret 표시까지 확인합니다.
- 05
활성화 전 Secret 등록
빗썸 안내에 따르면 활성화 이전에 Secret Key를 복사해 안전하게 관리해야 합니다.
Secret Key를 복사한 직후 BlockNuri에 등록하고 키를 활성화합니다.
Avoid mistakes
초보자가 가장 많이 놓치는 부분
아래 항목 중 하나라도 애매하면 키를 등록하지 말고 새 전용 키를 만드는 편이 운영상 더 안전합니다.
활성화 전 Secret 확인
Secret Key를 복사하지 않고 활성화하거나 화면을 닫으면 다시 확인하기 어렵습니다.
미사용 키 비활성화
빗썸 안내는 활성화 후 이용 이력이 없는 API Key가 비활성화될 수 있다고 설명합니다.
BlockNuri flow
키를 만든 뒤 BlockNuri에서는 이렇게 확인합니다.
API 키 빠른 등록
빗썸을 선택하고 키 종류를 고른 뒤 Access Key와 Secret Key를 한 번만 입력합니다. 「출금 권한을 끄고 발급했습니다」와 「안내한 IP 를 등록했습니다」는 직접 체크합니다.
조회 확인
등록 직후 한 번, 이후에는 설정의 「조회 확인」 버튼으로 빗썸 계정 조회(/v1/accounts)가 통과하는지 확인합니다.
전략 운용금
운용금, 1회 주문 한도, 일일 한도, 최소 현금 보유율을 별도로 설정합니다.
페이퍼 준비
주문 권한 확인과 라이브 동의 전에는 페이퍼(모의) 상태로 흐름을 먼저 검증합니다. 키 없이 대시보드에서 모의 운용부터 해 볼 수도 있습니다.
Troubleshooting
연결이 안 될 때 먼저 보는 체크
키를 만들었는데 조회 확인 실패
API 활성 항목에 자산조회가 포함되어 있는지, IP 제한에 BlockNuri 서비스 IP가 들어갔는지 확인합니다.
Secret Key를 복사하지 못함
기존 키를 폐기하고 새 키를 발급한 뒤 활성화 전 Secret Key를 바로 등록합니다.
키가 비활성화됨
빗썸 API 관리에서 활성 상태를 확인하고, 필요하면 새 전용 키를 발급합니다.
Source
세부 발급 화면은 거래소 정책에 따라 바뀔 수 있으므로 최종 확인은 공식 문서를 기준으로 합니다.