티스토리 뷰

빗썸 API 키 발급과 테스트 방법을 단계별로 안내합니다. API 활성화, 보안 인증, 키 저장 및 자동매매 테스트까지 자세히 설명합니다. 안전하고 효율적인 거래를 위한 필수 가이드.


빗썸 API 거래를 위한 API 키 발행과 테스트

빗썸(Bithumb)은 암호화폐 거래소로, 사용자들이 자동매매나 데이터를 효율적으로 관리할 수 있도록 API를 제공합니다. 이 글에서는 빗썸 API 키 발급 방법과 이를 활용한 테스트 과정을 단계별로 설명합니다. 특히 초보자도 쉽게 따라할 수 있도록 상세히 정리했습니다.

 

👇👇👇 내용 자세히보기 👇👇👇 

설명 영상 바로가기


빗썸 API 키 발급 준비 사항

API 키를 발급받기 위해서는 다음이 필요합니다:

  • 빗썸 계정: 회원가입 및 로그인 완료 상태여야 합니다.
  • 2단계 인증: ARS 인증 또는 OTP 인증 설정이 필수입니다.
  • PC 환경: 모바일에서는 API 키 발급이 불가능합니다.
  • 보안 비밀번호: 계정 보안 강화를 위해 설정된 비밀번호가 필요합니다.

빗썸 API 키 발급 절차

  1. 로그인 및 메뉴 이동
    • 빗썸 홈페이지에 로그인 후, 우측 상단의 메뉴 아이콘을 클릭합니다.
    • 계정관리 > API 관리 메뉴로 이동합니다.
  2. API 활성화 항목 선택
    • API 관리 화면에서 원하는 항목을 활성화합니다.
      • 예: 회원지갑정보, 주문내역, 매수/매도 주문
    • 출금 관련 항목은 보통 활성화하지 않는 것이 안전합니다.
  3. 보안 인증
    • ARS 인증 또는 OTP 인증 중 하나를 선택하여 진행합니다.
      • ARS 인증: 전화 승인 후 완료
      • OTP 인증: 6자리 인증번호 입력 후 승인
  4. API 키 생성
    • 보안 인증이 완료되면 API KEY 생성 버튼을 클릭합니다.
    • 생성된 Connect Key와 Secret Key를 확인하고 저장합니다.
      • Secret Key는 최초 1회만 표시되므로 반드시 별도로 기록해 두어야 합니다.
  5. API 활성화
    • 생성된 API를 활성화하려면 문자로 전송된 링크를 클릭하여 최종 활성화를 진행합니다.

API 키 테스트 방법

API 키가 제대로 작동하는지 확인하려면 다음 단계를 따라하세요:

1. Public API 테스트

Public API는 인증 없이 사용할 수 있습니다. 예를 들어, 현재 시세 정보를 확인하려면 다음과 같은 명령어를 실행할 수 있습니다:

curl https://api.bithumb.com/public/ticker/BTC

응답 데이터에는 마지막 거래 가격(closing_price), 매수 대기 가격(buy_price), 매도 대기 가격(sell_price) 등이 포함됩니다.

2. Private API 테스트

Private API는 Connect Key와 Secret Key가 필요하며, 주로 거래나 계좌 정보를 조회하는 데 사용됩니다. Python을 사용한 간단한 예제는 다음과 같습니다:

import requests
import hmac
import hashlib
import time

# API 정보 입력
api_url = "https://api.bithumb.com/info/account"
connect_key = "YOUR_CONNECT_KEY"
secret_key = "YOUR_SECRET_KEY"

# 요청 헤더 생성
nonce = str(int(time.time() * 1000))
data = {'endpoint': '/info/account', 'nonce': nonce}
encoded_data = '&'.join([f"{key}={value}" for key, value in data.items()])
signature = hmac.new(secret_key.encode(), encoded_data.encode(), hashlib.sha512).hexdigest()

headers = {
    'Api-Key': connect_key,
    'Api-Sign': signature,
    'Api-Nonce': nonce,
}

# 요청 실행
response = requests.post(api_url, headers=headers)
print(response.json())

3. 자동매매 기능 테스트

자동매매 프로그램을 작성하려면 매수/매도 주문 관련 Private API를 호출해야 합니다. 실제 매매 전에는 소액으로 테스트하거나 시뮬레이션 환경에서 실행하는 것이 안전합니다.


주의사항

  • Secret Key 보관: Secret Key는 한 번만 표시되므로 반드시 안전한 곳에 저장하세요.
  • IP 제한 설정: 특정 IP에서만 접근 가능하도록 설정하면 보안을 강화할 수 있습니다.
  • 출금 권한 비활성화: 출금 관련 권한은 일반적으로 비활성화하여 계정 도용 위험을 줄이는 것이 좋습니다.

결론

빗썸 API는 자동매매와 데이터 관리에 매우 유용한 도구입니다. 하지만 보안에 각별히 신경 써야 하며, 특히 Secret Key와 IP 제한 설정은 필수적입니다. 위 가이드를 참고하여 안전하고 효율적인 거래 환경을 구축해 보세요.

 


자주 묻는 질문

Q1: 모바일에서도 API 키를 발급받을 수 있나요?
A1: 아니요, PC에서만 가능합니다.

Q2: Secret Key를 잃어버리면 어떻게 하나요?
A2: 기존 API 키를 삭제하고 새로운 키를 생성해야 합니다.

Q3: Public API와 Private API의 차이는 무엇인가요?
A3: Public API는 인증 없이 사용할 수 있는 반면, Private API는 Connect Key와 Secret Key가 필요하며 개인 계정 정보나 거래 기능에 접근할 수 있습니다.

반응형