코인원(Coinone) 자동매매 봇 (Electron 기반 데스크탑 앱)
- 🧠 평생 무료 오픈소스 AI 자율 주행 엔진 (
Groq Llama-3.1-8B탑재): 시장의 흐름과 보조 지표를 초고속 추론 환경인 Groq의 Llama 3.1 모델이 실시간으로 읽고 100% 자율적으로 매수/매도/관망 판단 (관대한 무료 티어로 24시간 1분 주기로 스캔 가능!) - 🎯 목표 자산 기반 트레이딩: 고정된 수익률 설정 없이, 사용자가 설정한 "최종 목표 금액"에 도달하기 위해 AI가 스스로 익절/손절 시점을 다이나믹하게 조정
- 🔥 단기 급등/핫 템플릿 자동 감지: 거래량이 폭발하는 시장 최상위 핫 코인 3종을 매 사이클마다 스스로 스캔하여 감시 목록에 편입
- 🖥 직관적인 데스크탑 GUI 앱: Mac/Windows 환경에서 API 설정 및 목표 금액 등을 쉽게 입력할 수 있는 사용자 친화적인 앱 제공
본 자동매매 봇은 1분마다 시장 상황을 체크하고 다수의 코인을 동시에 분석합니다. 기존 사용하던 구글 제미나이(Gemini 2.5 Flash Lite) 모델의 무료 티어는 **하루 최대 1,500회(분당 15회)**의 요청 제한이 있어, 주기를 1분으로 설정할 경우 하루 안에 반드시 한도를 초과하여 봇이 멈추는 치명적인 문제가 있었습니다. (그래서 코드상에 강제로 '최소 4분 주기' 제한이 걸려 있었습니다.)
이러한 문제를 극복하기 위해 압도적으로 관대한 무료 티어를 제공하는 Groq API로 전환(또는 혼용 지원)하게 되었습니다.
Groq 무료 티어의 장점:
- 하루 최대 14,400회 요청 (RPD): Gemini 대비 약 10배 더 관대합니다.
- 분당 최대 30회 요청 (RPM): Gemini 대비 2배 더 관대합니다.
- 코인 5종목을 1분 단위로 조회(하루 약 7,200회 요청)하더라도 무료 한도의 50% 수준만 사용하므로 매우 쾌적하게 24시간 봇을 구동할 수 있습니다.
본 자동매매 봇을 실행하려면 회원님의 코인원 계정에서 발급한 Access Token과 Secret Key가 필요합니다. 보안상 자산 출금 등의 권한은 제외하고 최소한의 거래 권한만 주어야 합니다.
- 코인원(Coinone) 접속 및 로그인 진행
- 홈페이지 우측 상단 프로필 이미지 클릭 ➞ [마이페이지] ➞ **[API 관리]**로 이동
- "API 등록(새로운 API 생성)" 버튼을 클릭
- 가장 중요한 권한 설정 단계입니다. 반드시 다음 두 개만 활성화하세요:
- ✅ 잔고조회 (자산 확인용)
- ✅ 주문하기 (매수/매도용)
- 🚨 출금하기 (절대 활성화하지 마세요! 보안상 매우 위험합니다)
- 인증 절차(OTP 등)를 거쳐 생성을 완료합니다.
- 완료 화면에 Access Token과 Secret Key가 나타납니다.
- (주의) Secret Key는 이때 단 한 번만 화면에 표시됩니다! 창을 닫기 전에 메모장 등에 안전하게 복사해 두시기 바랍니다.
- 프로젝트 폴더 최상단(루트)에
.env라는 이름의 새 파일을 만듭니다. (※ 절대로 이 파일을 깃허브 등에 업로드하지 마세요..gitignore에 자동 포함되어 있습니다.) - 아래 내용을 복사하여
.env파일에 붙여넣고, 발급받은 키 값과 봇 구동 옵션을 작성합니다. GUI 앱을 실행하면 앱 내에서 직접 값을 입력하고 저장할 수도 있습니다.
# ====== [필수] API 설정 ======
COINONE_ACCESS_TOKEN=방금_발급받은_액세스_토큰을_여기에_붙여넣으세요
COINONE_SECRET_KEY=방금_발급받은_시크릿_키를_여기에_붙여넣으세요
GROQ_API_KEY=Groq_Console에서_발급받은_무료_API_키를_넣으세요
# ====== [선택] 봇 세부 동작 설정 ======
BOT_TARGET_COINS=BTC,ETH,SOL # 기본 감시 대상 암호화폐 (AI가 핫한 코인을 알아서 더 추가함)
BOT_BUY_AMOUNT_KRW=10000 # 1회 매수 금액 (원)
BOT_TARGET_ASSET_KRW=100000 # AI가 도달하고자 하는 최종 목표 코인 자산 금액 (원)
BOT_CHECK_INTERVAL_MIN=1 # 시장 상황 체크 주기 (분 단위)
BOT_RSI_BUY=30 # (안전장치) 매수에 사용할 RSI 기준선
BOT_MAX_DAILY_TRADES=100 # 일일 최대 거래 가능 횟수
BOT_COOLDOWN_HOURS=1 # 거래 후 휴식 시간 (시간 단위)(기본 설정값을 그대로 유지해도 AI가 알아서 매매를 진행합니다.)
- 소스 코드를 다운로드하고 해당 폴더(디렉토리)로 진입합니다.
- 종속성 모듈(Node.js 패키지)을 설치합니다.
npm install
- 편리한 UI와 봇 구동이 같이 되는 데스크탑 앱(GUI) 버전을 띄우려면:
npm run gui
- 터미널 백그라운드에서 봇 프로세스만 돌리고 싶다면:
npm run bot
본인의 데스크탑 환경에 맞게 직접 실행파일(.exe, .dmg 등)로 빌드할 수 있습니다.
- Mac용 빌드 (.dmg)
npm run build:mac
- Windows용 빌드 (.exe) (※ Mac에서 윈도우용으로 빌드 시 호환을 위해
--x64옵션을 붙여야 할 수 있습니다)npx electron-builder --win --x64
빌드가 완료되면 /dist 폴더 내에 설치 파일이 생성됩니다.
- API 키 관리: 시크릿 키는 절대 타인에게 공유하거나 공개 공간(GitHub, 블로그 등)에 유출하지 마세요. 실수로라도
.env파일이 업로드되지 않도록 주의해야 합니다. - 원금 손실 위험: 암호화폐 시장은 24시간 변동성이 매우 큽니다. 봇이 항상 수익을 보장하지 않으므로, 사용으로 인해 발생하는 어떠한 금전적 손실에 대해서도 개발자는 책임지지 않습니다. 충분한 소액 테스트를 거친 뒤 사용하시기 바랍니다.