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

빗썸 API 키 발급 가이드

API 관리에서 필요한 활성 항목만 선택하고, IP 제한과 Secret Key 보관을 확인한 뒤 활성화합니다.

Before you start
  • PC 계정관리에서 진행
  • 자산조회 먼저 선택
  • 출금하기 제외
  • BlockNuri 고정 IP 등록
  • 활성화 전 Secret 복사

빗썸 공식 안내는 PC 계정관리 > API 관리, API 활성 항목, IP 제한, 보안 인증, 활성화 전 Secret Key 복사를 안내합니다.

Step-by-step

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

  1. 01

    빗썸 PC 웹 로그인

    PC에서 로그인한 뒤 계정관리의 API 관리 화면으로 이동합니다. 키 발급 전 본인 인증과 보안 설정을 확인합니다.

    마이페이지 또는 계정관리에서 API 관리 화면을 엽니다.

  2. 02

    API 활성 항목 선택

    처음에는 자산조회와 주문조회처럼 상태 확인에 필요한 항목부터 선택합니다. 주문하기는 라이브 준비 전까지 보류합니다.

    출금하기와 불필요한 고위험 항목은 선택하지 않습니다.

  3. 03

    IP 제한 입력

    API를 사용할 수 있는 IP를 제한합니다. BlockNuri 설정 화면의 서비스 outbound IP를 입력해 키 사용 범위를 좁힙니다.

    개인 PC IP 대신 서비스 IP를 기준으로 등록합니다.

  4. 04

    보안 인증과 Key 생성

    로그인 비밀번호와 보안 인증을 완료한 뒤 API Key 생성을 진행합니다.

    인증 중 화면을 닫지 말고 Access/Secret 표시까지 확인합니다.

  5. 05

    활성화 전 Secret 등록

    빗썸 안내에 따르면 활성화 이전에 Secret Key를 복사해 안전하게 관리해야 합니다.

    Secret Key를 복사한 직후 BlockNuri에 등록하고 키를 활성화합니다.

Avoid mistakes

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

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

출금하기 선택 금지

BlockNuri의 기본 연결에는 출금 권한이 필요하지 않습니다. 출금 권한을 선택했다면 새 키를 만드는 편이 안전합니다.

활성화 전 Secret 확인

Secret Key를 복사하지 않고 활성화하거나 화면을 닫으면 다시 확인하기 어렵습니다.

미사용 키 비활성화

빗썸 안내는 활성화 후 이용 이력이 없는 API Key가 비활성화될 수 있다고 설명합니다.

BlockNuri flow

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

설정 > 거래소 API 키

빗썸을 선택하고 Access Key와 Secret Key를 한 번만 입력합니다.

조회 확인

Bithumb `/v1/accounts` 계정 조회 경계에서 read check를 통과하는지 확인합니다.

전략 운용금

운용금, 1회 주문 한도, 일일 한도, 최소 현금 보유율을 별도로 설정합니다.

페이퍼 준비

주문 권한과 라이브 동의 전에는 paper-first 상태로 흐름을 검증합니다.

Troubleshooting

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

키를 만들었는데 조회 확인 실패

API 활성 항목에 자산조회가 포함되어 있는지, IP 제한에 BlockNuri 서비스 IP가 들어갔는지 확인합니다.

Secret Key를 복사하지 못함

기존 키를 폐기하고 새 키를 발급한 뒤 활성화 전 Secret Key를 바로 등록합니다.

키가 비활성화됨

빗썸 API 관리에서 활성 상태를 확인하고, 필요하면 새 전용 키를 발급합니다.

Source

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

빗썸 공식 API Key 안내