Bithumb API - 멀티 계정 자동 매수 스크립트

빗썸(Bithumb) 거래소에서 여러 계정을 관리하며 최소 금액으로 비트코인(BTC)을 자동 매수하는 Python 스크립트입니다.

주요 기능

• ✅ 멀티 계정 지원: CSV 파일로 여러 계정 관리
• ✅ 계정 선택 모드: 단일 계정 또는 전체 계정 순차 실행
• ✅ 안전한 거래: 최소 주문 금액 자동 조회 및 확인 단계
• ✅ 시장가 매수: KRW-BTC 마켓 최소 금액 매수
• ✅ 상세한 로그: 각 단계별 진행 상황 표시

설치 방법

1. Python 설치

Python 3.7 이상이 필요합니다. Python 공식 사이트에서 다운로드하세요.

2. 저장소 클론

git clone https://github.com/Cryptopia-KR/Bithumb-API.git
cd Bithumb-API/dist

3. 필요한 라이브러리 설치

pip install python-bithumb

설정 방법

API 키 발급

1. 빗썸 API 관리에서 "API 2.0 Beta" 탭으로 이동
2. "API Key 생성" 버튼 클릭
3. API 활성 항목 선택에서 다음 권한 체크:
   • ✅ 자산조회
   • ✅ 주문조회
   • ✅ 주문하기
   • ✅ 입금조회
   • ✅ 출금조회
   • ✅ 입금하기
4. IP 주소 등록 (선택사항, 보안 강화를 위해 권장)
5. 생성된 Access Key와 Secret Key를 안전하게 복사

api_keys.csv 파일 설정

dist 폴더에 api_keys.csv 파일을 생성하고 다음 형식으로 작성하세요:

account_name,access_key,secret_key
계정1,your_access_key_1,your_secret_key_1
계정2,your_access_key_2,your_secret_key_2
계정3,your_access_key_3,your_secret_key_3

예시 (아래는 실제로 작동하지 않는 샘플입니다):

account_name,access_key,secret_key
메인계정,xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx,xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
서브계정1,yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy,yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy

💡 실제 API 키는 빗썸 API 관리 페이지에서 발급받은 정확한 값을 입력해야 합니다.

⚠️ 보안 주의: api_keys.csv 파일은 절대 GitHub에 커밋하지 마세요! 이 파일은 .gitignore에 포함되어 있습니다.

사용 방법

dist 폴더에서 실행

cd dist
python bithumb_api.py

실행 화면

=== 사용 가능한 계정 목록 ===
1. 메인계정
2. 서브계정1
3. 서브계정2
4. 모든 계정 (순차 실행)
------------------------------
사용할 계정 번호를 선택하세요 (1-4):

옵션 설명

• 1, 2, 3: 해당 번호의 계정으로만 매수 실행
• 4 (모든 계정): 모든 계정에 대해 순차적으로 매수 실행

실행 예시

단일 계정 실행

사용할 계정 번호를 선택하세요 (1-4): 1
✅ '메인계정' 계정을 선택했습니다.

==================================================
계정: 메인계정
==================================================

KRW-BTC 마켓의 주문 가능 정보를 조회합니다...
✅ KRW-BTC 시장가 매수 최소 주문 금액: 5,000 KRW
------------------------------
정말로 5,000 KRW 만큼 시장가 매수를 진행하시겠습니까? (y/n): y

5,000 KRW 만큼 시장가 매수를 시도합니다...
✅ --- 매수 주문 성공 ---
{   'created_at': '2025-11-11T10:30:00+09:00',
    'executed_volume': '0.00012345',
    'market': 'KRW-BTC',
    'ord_type': 'price',
    'price': '5000.0',
    'side': 'bid',
    'state': 'done',
    'uuid': 'xxxx-xxxx-xxxx-xxxx'}

모든 계정 실행

사용할 계정 번호를 선택하세요 (1-4): 4

🔄 총 3개 계정에 대해 순차 실행합니다.

==================================================
계정: 메인계정
==================================================
[매수 진행...]

──────────────────────────────────────────────────

==================================================
계정: 서브계정1
==================================================
[매수 진행...]

──────────────────────────────────────────────────

==================================================
계정: 서브계정2
==================================================
[매수 진행...]

✅ 완료: 3/3 계정에서 주문 성공

트러블슈팅

ModuleNotFoundError: No module named 'python_bithumb'

pip install python-bithumb

API 키 오류

• API 활성 항목에서 "주문하기" 권한이 활성화되어 있는지 확인
• Access Key와 Secret Key를 정확히 복사했는지 확인
• 빗썸 API 관리 페이지에서 IP 주소 등록을 했다면, 현재 IP가 등록된 IP인지 확인

잔액 부족

• 각 계정에 최소 주문 금액(보통 5,000원) 이상의 KRW 잔액이 있는지 확인

CSV 파일 형식 오류

• 첫 줄은 반드시 account_name,access_key,secret_key로 시작
• 각 줄이 쉼표(,)로 정확히 구분되어 있는지 확인
• 공백이나 특수문자가 없는지 확인

보안 권장사항

1. ✅ api_keys.csv 파일은 절대 공유하지 마세요
2. ✅ API 키는 정기적으로 재발급하세요
3. ✅ 필요한 권한만 최소한으로 부여하세요
4. ✅ 사용하지 않는 API 키는 즉시 삭제하세요

라이선스

MIT License

문의 및 기여

• GitHub Issues: https://github.com/Cryptopia-KR/Bithumb-API/issues
• 기여는 언제나 환영합니다! Pull Request를 보내주세요.

면책 조항

이 스크립트는 교육 및 개인 사용 목적으로 제공됩니다. 실제 거래 시 발생하는 손실에 대해 개발자는 책임지지 않습니다. 자동 매매는 항상 위험을 수반하므로 신중하게 사용하세요.