Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chrisleekr/binance-trading-bot
Automated Binance trading bot - Trade multiple cryptocurrencies. Buy low/sell high with Grid Trading. Integrated with TradingView technical analysis
https://github.com/chrisleekr/binance-trading-bot
binance binance-api binance-api-node binance-trading-bot bot cryptocurrency cryptotrading grid-trading technical-analysis-indicators trading-bot traidingview
Last synced: 21 days ago
JSON representation
Automated Binance trading bot - Trade multiple cryptocurrencies. Buy low/sell high with Grid Trading. Integrated with TradingView technical analysis
- Host: GitHub
- URL: https://github.com/chrisleekr/binance-trading-bot
- Owner: chrisleekr
- License: mit
- Created: 2020-08-10T13:52:04.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-07-20T04:11:33.000Z (4 months ago)
- Last Synced: 2024-10-01T19:41:25.138Z (about 1 month ago)
- Topics: binance, binance-api, binance-api-node, binance-trading-bot, bot, cryptocurrency, cryptotrading, grid-trading, technical-analysis-indicators, trading-bot, traidingview
- Language: JavaScript
- Homepage:
- Size: 6.87 MB
- Stars: 5,011
- Watchers: 141
- Forks: 1,094
- Open Issues: 100
-
Metadata Files:
- Readme: README.ko.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- stars - chrisleekr/binance-trading-bot - Automated Binance trading bot - Trade multiple cryptocurrencies. Buy low/sell high with Grid Trading. Integrated with TradingView technical analysis (JavaScript)
README
# 바이낸스 자동 매매 트레이딩 봇
[](https://github.com/chrisleekr/binance-trading-bot/releases)
[](https://github.com/chrisleekr/binance-trading-bot/actions?query=workflow%3Amain)
[](https://codecov.io/gh/chrisleekr/binance-trading-bot)
[](https://hub.docker.com/r/chrisleekr/binance-trading-bot)
[](https://github.com/chrisleekr/binance-trading-bot/graphs/contributors)
[](https://github.com/chrisleekr/binance-trading-bot/blob/master/LICENSE)
> 추적 매수/매도 기법(Trailing buy/sell strategy)을 이용한 자동화된 바이낸스 자동매매 프로그램
---
[](https://github.com/chrisleekr/binance-trading-bot/blob/master/README.md)
[](https://github.com/chrisleekr/binance-trading-bot/blob/master/README.zh-cn.md)
이 프로젝트는 제 코드를 테스트 하기 위한 단순한 테스트 프로젝트 입니다.
**최신 업데이트 정보는 [README.md](https://github.com/chrisleekr/binance-trading-bot#binance-trading-bot)에 서 확인 가능합니다. 이 페이지는 한국어로 프로그램에 대한 설명만 적혀있습니다.**
## 경고
**이 프로그램을 이용하여 돈을 벌 수 있을지 없을지는 절대 보장하지 않습니다.**
**리스크를 감당하실 수 있을 경우에만 사용하세요! 이 코드를 이용하여 직/간접적으로 생긴 손실이나 경제적인 어려움이 생길 경우 절대 책임지지 않습니다.**
**프로그램을 업데이트하기 전에, 구매 가격을 꼭 적어두시기 바랍니다. 환경설정이나 구매 가격 정보가 손실될 수 있습니다.**
## 작동 방법
### 추적 매수 프로그램
이 프로그램은 가격의 하락/상승 추세를 따라가며 추적 매수/추적 매도를 하는 기법을 기반으로 작성되었습니다.
- 이 프로그램은 환경설정에 따라 여러번의 매수/매도가 가능합니다.
- 이 프로그램은 여러개의 코인을 모니터링 가능합니다. 각 코인들은 1초마다 가격 확인 및 매수/매도 처리가 됩니다.
- 이 프로그램은 지속적인 데이터베이스로 MongoDB를 사용합니다. 하지만 라즈베리파이 32bit 지원을 위해 최신 버젼을 사용하지 않습니다. 사용된 MongoDB 버젼은 [apcheamitru](https://hub.docker.com/r/apcheamitru/arm32v7-mongo)에서 제공된 3.2.20입니다
- 이 프로그램은 리눅스와 라즈베리파이 4 32비트에서만 테스트/작동 확인하였습니다. 다른 플랫폼은 테스트하지 않았습니다.
#### 매수 신호
이 프로그램은 그리드 트레이딩 환경설정에 따라 코인을 모니터링합니다.
그리드 트레이딩 #1은 가장 현재 가격이 낮은 가격에 도달했을 경우에, 매수를 위한 STOP-LOSS-LIMIT 주문을 넣습니다. 현재 가격이 계속 떨어질 경우, 이전 주문을 취소하고, 새로운 가격으로 STOP-LOSS-LIMIT 주문을 넣습니다.
그리드 트리이딩 #1 이후로는, 이전 매수 가격에 따라 코인을 모니터링합니다.
- 매도를 위한 코인이 충분할 경우 (보통 $10정도), 그리드 트레이딩 #1의 매수 주문을 넣지않습니다.
- 총 금액이 매수 가격 삭제 가격보다 낮을 경우 매수 가격을 삭제하지 않습니다.
##### 매수 시나리오
예를 들어, 그리드 트레이딩 매수 환경설정이 다음과 같이 되었다고 가정해봅시다:
- 그리드 트레이드 수 (Number of grids): 2
- 그리드 트레이드
| 번호# | 매수 시작 퍼센트(Trigger Percentage) | 스탑 가격 퍼센트(Stop Price Percentage) | 리밋 가격 퍼센트(Limit price percentage) | USDT |
| --- | ------------------- | --------------------- | ---------------------- | ---- |
| 1 | 1 | 1.05 | 1.051 | 50 |
| 2 | 0.8 | 1.03 | 1.031 | 100 |
이해를 쉽게 할수 있도록, USDT를 `$`로 표시하도록 하겠습니다. 또한, 쉽게 계산할 수 있도록 커미션은 계산에 넣지 않았습니다. 실제 거래에서는 수량이 다를 수 있습니다.
첫번째 그리드 트레이드의 설정은 다음과 같습니다:
- 그리드 트레이드 번호#: 1
- 매수 시작 퍼센트 (Trigger percentage): 1
- 스탑 가격 퍼센트 (Stop percentage): 1.05 (5.00%)
- 리밋 가격 퍼센트 (Limit percentage): 1.051 (5.10%)
- 최대 매수 금액 (Max purchase amount): $50
현재 가격이 최저 가격($100)까지 떨어지고, 전고점(All-Time High) 제한 가격보다 낮을 경우, 프로그램은 새로운 STOP-LOSS-LIMIT 매수 주문을 넣습니다.
- 스탑 가격 (Stop price): $100 * 1.05 = $105
- 리밋 가격 (Limit price): $100 * 1.051 = $105.1
- 수량 (Quantity): 0.47573
마켓이 다음과 같이 변동되었다고 가정해봅시다:
- 현재 가격 (Current price): $95
그러면 프로그램은 가격 하락을 따라가면서, 새로운 STOP-LOSS-LIMIT 매수 주문을 다음과 같이 넣습니다:
- 스탑 가격 (Stop price): $95 * 1.05 = $99.75
- 리밋 가격 (Limit price): $95 * 1.051 = $99.845
- 수량 (Quantity): 0.5
마켓이 다음과 같이 변동되었다고 가정해봅시다:
- 현재 가격 (Current price): $100
이때, 첫번째 매수가 체결됩니다. 이때, 매수 가격 (Last buy price)를 `$99.845`로 기록합니다. 매수 수량은 `0.5` 입니다.
매수가 체결되면, 프로그램은 매도를 위해 모니터링을 함과 동시에, 다음 매수 그리드 트레이딩를 모니터링합니다.
두번째 그리드 트레이딩의 설정은 다음과 같습니다:
- 그리드 트레이딩 번호#: 2
- 매수 가격 (Current last buy price): $99.845
- 매수 시작 퍼센트 (Trigger percentage): 0.8 (20%)
- 스탑 가격 퍼센트 (Stop percentage): 1.03 (3.00%)
- 리밋 가격 퍼센트 (Limit percentage): 1.031 (3.10%)
- 최대 매수 금액 (Max purchase amount): $100
만약 현재 가격이 20% 낮은 `$79.876`까지 떨어지면, 프로그램은 두번째 그리드 트레이딩을 위한 STOP-LOSS-LIMIT 매수 주문을 넣습니다.
마켓이 다음과 같이 변동되었다고 가정해봅시다:
- 현재 가격 (Current price): $75
이때 프로그램은 가격 하락을 따라가면서, 새로운 STOP-LOSS-LIMIT 매수 주문을 다음과 같이 넣습니다.
- 스탑 가격 (Stop price): $75 * 1.03 = $77.25
- 리밋 가격 (Limit price): $75 * 1.031 = $77.325
- 수량 (Quantity): 1.29
마켓이 다음과 같이 변동되었다고 가정해봅시다:
- 현재 가격 (Current price): $78
이때, 두번째 매수가 체결됩니다. 매수 가격 (Last buy price)는 자동으로 아래와 같이 계산 됩니다:
- 최종 매수 가격: : ($50 + $100)/(0.5 COIN + 1.29 COIN) = $83.80
##### 매수 환경설정
상세한 매수 환경설정에 대한 설명은 아래에서 보실 수 있습니다.
[https://github.com/chrisleekr/binance-trading-bot/wiki/Buy-Scenario](https://github.com/chrisleekr/binance-trading-bot/wiki/Buy-Scenario)
### 매도 신호
만약 매도를 위한 충분한 코인이 있고 매수 가격(Last buy price)가 저장되었을 경우, 프로그램은 첫번째 그리드 트레이딩을 위한 매도 신호를 모니터링하기 시작합니다. 현재 가격이 매도 시작 가격에 도달한다면, 프로그램은 매도 STOP-LOSS-LIMIT 주문을 넣습니다. 만약 현재 가격이 계속 상승한다면, 프로그램은 이전 주문을 취소하고, 새 가격으로 매도 STOP-LOSS-LIMIT 주문을 넣습니다.
- 만약 매수 가격(Last buy price)가 저장되지 않았다면, 코인을 매도하지 않습니다.
- 만약 코인 평가금이 매수 가격 삭제 금액보다 낮다면, 매수 가격 (Last buy price) 기록을 삭제합니다.
- 만약 코인 평가금이 최소 주문 금액보다 낮다면, 코인을 매도하지 않습니다.
#### 매도 시나리오
예를 들어, 그리드 트레이딩 매도 환경설정이 다음과 같이 되었다고 가정해봅시다:
- 그리드 트레이딩 수: 2
- 그리드 트레이딩
| 번호# | 매도 시작 퍼센트(Trigger Percentage) | 스탑 가격 퍼센트(Stop Price Percentage) | 리밋 가격 퍼센트(Limit price percentage) | 매도 수량 퍼센트(Sell Quantity Percentage) |
| --- | ------------------- | --------------------- | ---------------------- |------------------------- |
| 1st | 1.05 | 0.97 | 0.969 | 0.5 |
| 2nd | 1.08 | 0.95 | 0.949 | 1 |
매수와 다르게, 매도는 수량 퍼센트를 설정합니다. 만약 보유한 모든 수량을 매도할려면, 간단하게 `1` (100%)로 설정하시면 됩니다.
위에서 매수한 코인은 다음과 같습니다:
- 현재 수량 (Current quantity): 1.79
- 현재 매수 가격 (Current last buy price): $83.80
첫번째 그리드 트레이드의 설정은 다음과 같습니다:
- 그리드 트레이딩 번호# 1
- 매도 시작 퍼센트 (Trigger percentage): 1.05
- 스탑 가격 퍼센트 (Stop price percentage): 0.97
- 리밋 가격 퍼센트 (Limit price percentage): 0.969
- 매도 수량 퍼센트 (Sell amount percentage): 0.5
마켓이 다음과 같이 변동되었다고 가정해봅시다:
- 현재 가격 (Current price): $88
현재 가격이 매도 시작 가격 ($87.99) 보다 높기 때문에, 새로운 STOP-LOSS-LIMIT 매도 주문을 다음과 같이 넣습니다:
- 스탑 가격 (Stop price): $88 * 0.97 = $85.36
- 리밋 가격 (Limit price): $88 * 0.969 = $85.272
- 수량 (Quantity): 0.895
마켓이 다음과 같이 변동되었다고 가정해봅시다:
- 현재 가격 (Current price): $90
그러면 프로그램은 가격 상승을 따라가면서, 새로운 STOP-LOSS-LIMIT 주문을 다음과 같이 넣습니다:
- 스탑 가격 (Stop price): $90 * 0.97 = $87.30
- 리밋 가격 (Limit price): $90 * 0.969 = $87.21
- 수량 (Quantity): 0.895
마켓이 다음과 같이 변동되었다고 가정해봅시다:
- 현재 가격 (Current price): $87
이때, 첫번째 매도 주문이 체결됩니다. 그러면 프로그램은 두번째 그리드 트레이딩 매도 시작 가격($83.80 * 1.08 = $90.504)을 기다립니다.
- 현재 수량 (Current quantity): 0.895
- 현재 매수 가격 (Current last buy price): $83.80
마켓이 다음과 같이 변동되었다고 가정해봅시다:
- 현재 가격 (Current price): $91
현재 가격 ($91)은 두번째 매도 시작 가격 ($90.504)보다 높기 때문에, 프로그램은 새로운 STOP-LOSS-LIMIT 주문을 다음과 같이 넣습니다:
- 스탑 가격 (Stop price): $91 * 0.95 = $86.45
- 리밋 가격 (Limit price): $91 * 0.949 = $86.359
- 수량 (Quantity): 0.895
마켓이 다음과 같이 변동되었다고 가정해봅시다:
- 현재 가격 (Current price): $100
그러면 프로그램은 가격 상승을 따라가면서, 새로운 STOP-LOSS-LIMIT 주문을 다음과 같이 넣습니다:
- 스탑 가격 (Stop price): $100 * 0.95 = $95
- 리밋 가격 (Limit price): $100 * 0.949 = $94.9
- 수량 (Quantity): 0.895
마켓이 다음과 같이 변동되었다고 가정해봅시다:
- 현재 가격 (Current price): $94
이때 두번째 매도 주문이 체결됩니다.
최종 수익은 다음과 같습니다.
- 첫번째 매도: $94.9 * 0.895 = $84.9355
- 두번째 매도: $87.21 * 0.895 = $78.05295
- 최종 수익: $162 (8% 수익)
##### 매도 환경설정
상세한 매도 환경설정에 대한 설명은 아래에서 보실 수 있습니다.
[https://github.com/chrisleekr/binance-trading-bot/wiki/Sell-Scenario](https://github.com/chrisleekr/binance-trading-bot/wiki/Sell-Scenario)
### [기능](https://github.com/chrisleekr/binance-trading-bot/wiki/Features)
- 수동 거래
- 소규모 자산 BNB로 전환하기
- 모든 코인 거래하기
- 여러 코인들을 동시에 모니터링하기
- 스탑-로스
- 최고가일 경우 매수 제한하기
- 매수/매도 그리드 트레이딩
- TradingView 기술적 지표 지원
### 프론트엔드 + 웹 소켓
프론트엔드는 React.js 기반으로 개발 되었으며 웹소켓을 통해 통신합니다:
- 지정한 코인들의 매수/매도 신호와 현재 주문을 모니터링 할 수 있습니다.
- 계좌 현황을 볼 수 있습니다.
- 전체 환경 설정/코인 환경설정을 할 수 있습니다.
- 모니터링 되지 않은 코인의 캐시 정보를 지울 수 있습니다.
- 외부 링크를 볼수 있습니다.
- 홈 화면에 추가하기 기능을 지원합니다.
- 프론트엔드 암호 설정을 지원합니다.
## 환경 변수 (Environment parameters)
환경 변수를 이용해 환경 설정을 변경 가능합니다.
`/config/custom-environment-variables.json` 코드를 확인하시면 설정 가능한 환경변수 목록을 볼 수 있습니다.
아니면 프로그램 실행 후, 프론트엔드에서 설정을 변경 가능합니다.
## 사용 방법
1. 먼저 `.env.dist` 파일을 `.env` 파일로 복사합니다
| 환경 변수명 | 설명 | 예시 |
| ------------------------------ | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| BINANCE_LIVE_API_KEY | 실서버 Binance API key | (from [Binance](https://binance.zendesk.com/hc/en-us/articles/360002502072-How-to-create-API)) |
| BINANCE_LIVE_SECRET_KEY | 실서버 Binance API secret | (from [Binance](https://binance.zendesk.com/hc/en-us/articles/360002502072-How-to-create-API)) |
| BINANCE_TEST_API_KEY | 테스트서버 Binance API key | (from [Binance Spot Test Network](https://testnet.binance.vision/)) |
| BINANCE_TEST_SECRET_KEY | 테스트서버 Binance API secret | (from [Binance Spot Test Network](https://testnet.binance.vision/)) |
| BINANCE_SLACK_ENABLED | 슬랙(Slack) 활성화/비활성화 | true |
| BINANCE_SLACK_WEBHOOK_URL | 슬랙(Slack) 웹훅(webhook) URL | (from Slack) |
| BINANCE_SLACK_CHANNEL | 슬랙(Slack) 채널(channel)명 | "#binance" |
| BINANCE_SLACK_USERNAME | 슬랙(Slack) username | Chris |
| BINANCE_LOCAL_TUNNEL_ENABLED | 로컬터널([local tunnel](https://github.com/localtunnel/localtunnel)) 활성화/비활성화 | true |
| BINANCE_LOCAL_TUNNEL_SUBDOMAIN | 외부 링크를 위한 로컬터널(local tunnel) 서브도메인 | binance |
| BINANCE_AUTHENTICATION_ENABLED | 프론트엔드 인증 활성화/비활성화 | true |
| BINANCE_AUTHENTICATION_PASSWORD | 프론트엔드 인증 암호 | 123456 |
*로컬 터널은 봇을 외부에서 접근이 가능하도록 설정합니다. 로컬 터널의 하위도메인은 자신만 기억할 수 있는 서브도메인으로 설정하시기 바랍니다.*
*프론트엔드 인증 암호를 꼭 변경하시기 바랍니다. 변경하지 않으면 기본 암호를 사용하게 됩니다.*
2. docker-compose를 이용하여 프로그램을 실행하시기 바랍니다.
먼저 최신 코드를 Pull합니다:
```bash
git pull
```
실서버 모드를 사용하실려면, DockerHub에서 최근에 빌드된 이미지를 사용하실 수 있습니다:
```bash
docker-compose -f docker-compose.server.yml pull
docker-compose -f docker-compose.server.yml up -d
```
테스트 모드를 사용하실려면, 아래 명령어를 실행하시면 됩니다:
```bash
docker-compose up -d
```
3. 브라우저를 열어 `http://0.0.0.0:8080`에 접근하시면 프론트엔드에 접근하실 수 있습니다.
- 프로그램 실행시, 외부 URL은 슬랙(Slack)에 공지 됩니다.
- 봇을 사용시 문제가 발생할 경우, 먼저 로그를 확인하시기 바랍니다. 참조: [Troubleshooting](https://github.com/chrisleekr/binance-trading-bot/wiki/Troubleshooting)
## 스크린샷
| Password Protected | Frontend Mobile |
| ------------------ | --------------- |
|  |  |
| Setting | Manual Trade |
| ------- | ------------ |
|  |  |
| Frontend Desktop | Closed Trades |
| ----------------- | ------------- |
|  |  |
### 샘플 거래
| 차트 | 매수 주문 | 매도 주문 |
| -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
|  |  |  |
## 기부
이 프로젝트가 도움이 되셨다면, 개발자에게 작은 [기부](https://github.com/chrisleekr/binance-trading-bot/blob/master/DONATIONS.md)를 하실 수 있습니다.
## 면책 조항
저는 이 프로젝트에 포함된 정보 및 자료의 정확성이나 안정성에 대해서 어떠한 보증도 하지 않으며 어떠한 책임을 지지 않습니다. 손해의 가능성에 사전에 통보한 경우더라도, 이 코드나 연결된 코드를 직간접적으로 사용함으로써 발생하는 모든 청구, 손해, 손실, 비용 또는 책임 (이익 손실, 업무 중단 또는 정보 손실로 인한 직/간접적인 손해 포함)에 대해 어떠한 경우에도 책임을 지지 않습니다.
**그러니 리스크를 감당하실 수 있을 경우에만 사용하십시요!**