Backpack 거래소 볼륨 봇

Backpack 거래소에서 자동으로 매수/매도를 반복하는 간단한 터미널 프로그램입니다.

---

이게 뭔가요?

• 터미널에서 실행하는 프로그램입니다
• 자동으로 매수/매도를 반복해서 거래량(볼륨)을 만듭니다
• API 키 없이도 테스트할 수 있습니다 (모의 모드)

---

완전 초보자용 설치 가이드

1단계: Python 확인하기

터미널(또는 명령 프롬프트)을 열고 이걸 입력하세요:

python3 --version

Python 3.10.x 같은 숫자가 나오면 OK!

안 나오면? -> Python 설치하기

---

2단계: 코드 받기

방법 A) Git으로 받기 (추천)

git clone https://github.com/cryptokatze/backpack_auto_vol.git
cd backpack_auto_vol

방법 B) ZIP으로 받기

1. GitHub에서 Code -> Download ZIP 클릭
2. 압축 풀기
3. 터미널에서 그 폴더로 이동

---

3단계: 가상환경 만들기

# 가상환경 만들기
python3 -m venv .venv

# 가상환경 켜기 (Mac/Linux)
source .venv/bin/activate

# 가상환경 켜기 (Windows)
.venv\Scripts\activate

터미널에 (.venv) 표시가 나타나면 성공!

---

4단계: 필요한 것들 설치하기

pip install -r requirements.txt

---

5단계: 설정 파일 만들기

프로젝트 폴더에 .env 파일을 만드세요.

처음 테스트할 때 (모의 모드):

BACKPACK_API_KEY=
BACKPACK_API_SECRET=

실제 거래할 때:

BACKPACK_API_KEY=여기에API키입력
BACKPACK_API_SECRET=여기에시크릿입력

API 키는 여기서 발급: https://backpack.exchange/portfolio/settings/api-keys

---

6단계: 실행하기

python main_tui.py

---

프로그램 사용법

실행하면 이런 메뉴가 나옵니다:

===== Backpack 터미널 =====
현재 설정: 심볼=SOL, 수량=0.01, 각 방향 주문=1회, 세트 반복=1, 대기=1.0~3.0s
API 모드=모의 | 디버그=OFF

1) 잔고/포지션 확인     <- 현재 잔고랑 포지션 보기
2) 현재 설정으로 주문 실행  <- 매수/매도 시작!
3) 모든 포지션 청산     <- 가지고 있는 거 다 팔기
4) 설정 변경          <- 심볼, 수량 등 바꾸기
5) 종료

선택:

메뉴 설명

번호	기능	설명
1	잔고/포지션 확인	내 지갑에 얼마 있는지, 뭘 들고 있는지 실시간으로 보여줌
2	주문 실행	설정한대로 매수/매도 시작
3	포지션 청산	들고 있는 코인 다 팔기
4	설정 변경	어떤 코인으로, 얼마나 거래할지 바꾸기
5	종료	프로그램 끄기

---

설정 변경하기 (4번 메뉴)

4번을 누르면 하나씩 물어봅니다:

심볼 (예: SOL):          <- 거래할 코인 (SOL, BTC, ETH 등)
1회 주문 수량:           <- 한 번에 얼마나 살지 (예: 0.01)
각 방향 주문 횟수:        <- 매수 몇 번, 매도 몇 번 할지
세트 반복 횟수:          <- 위 과정을 몇 번 반복할지 (0=무한)
최소 대기 시간(초):       <- 주문 사이 최소 쉬는 시간
최대 대기 시간(초):       <- 주문 사이 최대 쉬는 시간

예시

이렇게 설정하면:

• 심볼: SOL
• 수량: 0.01
• 각 방향 주문 횟수: 3
• 세트 반복: 2

이렇게 실행됩니다:

[세트 1]
  매수 0.01 SOL
  매수 0.01 SOL
  매수 0.01 SOL
  매도 0.01 SOL
  매도 0.01 SOL
  매도 0.01 SOL

[세트 2]
  (같은 과정 반복)

---

실행 중 조작키

주문이 돌아가는 동안 이 키를 누를 수 있어요:

키	기능
p	일시정지
r	다시 시작
q	현재 사이클 끝나면 종료
c	가진 거 다 팔고 종료

---

자주 하는 실수

"모듈을 찾을 수 없습니다" 에러

-> 가상환경을 안 켰어요!

source .venv/bin/activate   # Mac/Linux
.venv\Scripts\activate      # Windows

"API 키/시크릿이 없어 모의 모드로 시작"

-> .env 파일에 API 키를 안 넣었어요 (테스트 중이면 정상!)

"Invalid signature" 에러

-> API 시크릿을 잘못 붙여넣었어요. 공백이나 줄바꿈 없이 다시 넣어보세요

아무것도 안 돼요

-> 전체 에러 메시지를 복사해서 ChatGPT한테 물어보세요!

---

파일 구조

backpack_volume_bot/
├── main.py          <- 핵심 코드 (API 연결, 주문 실행)
├── main_tui.py      <- 터미널 UI (메뉴 화면)
├── .env             <- API 키 설정 (직접 만들어야 함)
├── .env.example     <- .env 예시
├── requirements.txt <- 필요한 라이브러리 목록
└── README.md        <- 이 파일

---

주의사항

• 처음엔 모의 모드로 테스트하세요 (API 키 없이)
• 실거래 전에 소액으로 충분히 테스트하세요
• 너무 빠른 주문은 API 제한에 걸릴 수 있어요 (분당 2000회 이하)
• 대기 시간은 최소 5초 이상 권장 (워시 트레이딩 방지)

---

더 자세한 정보

• Backpack API 문서
• 블로그 가이드

---

면책 조항

이 프로그램은 학습/연구 목적입니다. 실제 거래로 인한 손실은 본인 책임입니다. 투자는 신중하게!