https://github.com/jakesee/binance-trader
https://github.com/jakesee/binance-trader
binance bot cryptocurrency trade
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/jakesee/binance-trader
- Owner: jakesee
- License: gpl-3.0
- Created: 2018-01-28T12:57:02.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2019-05-20T17:14:34.000Z (about 7 years ago)
- Last Synced: 2025-06-02T22:03:58.200Z (about 1 year ago)
- Topics: binance, bot, cryptocurrency, trade
- Language: TypeScript
- Size: 494 KB
- Stars: 10
- Watchers: 6
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# binance-trader
This is a trading bot that triggers buy and sell orders based on price and technical indicator triggers set by the user.
_While the author(s) of this trading bot is using this application to automate trades, this application will not guarantee profits. Please use this application at your own risk._
# Crypto Exchange
Currently only Binance is supported.
# Installation
## Core Requirements
* NodeJS
* TypeScript
* npm
## Production
This application is designed to run on heroku.
* Set up environment variables on Heroku
* audit - values allowed: "trace", "debug", "warn", "info"
* key - the Binance API key
* secret - the Binance API secret key
* NODE_ENV - "heroku"
* Then simply push to Heroku and it should automatically run npm install.
## Development or running locally
Instead of environment variables, the values are defined in src/config/secret.json. Simply replace the values to your own.
To build, run: npm run build
## Testing
No tests at the moment. (Yes, very bad. You are warned!)
# Organisation
* app.ts - entry point of application
* binance.ts - provides exchange data and functionality
* trader.ts - takes care of the act of trading by taking data from exchange and applying calculations to make trade decisions
* symbol.ts - data structure to hold state and config of traded symbol
* config/default.json - user settings for running the bot
* configurator.ts - prepares the config for each symbol based on user settings
# Configuration
## Buying Strategies
* single ema and price spread
* ema slow and fast spread
* macd
* rsi
* bollinger bands
* dca
## Selling Strategy
* percentage gain
# Dollar Cost Averaging (DCA)
When in selling mode, and the price is falling, the bot can be set to buy more coins at each DCA percentage level to lower the overall costs. If user buys more coins manually, an event will be triggered to update the coin quantity and cost, and the next DCA price level will be calculated at the new cost.
# Warning
Bot will sell everything in your bag that are not locked in any open orders.