https://github.com/m1chlcz/bingo-bot
Bingo-Bot: A Binance-Go-Based Experimental Trading Bot. Automated trading bot for Binance, written in Go. Designed for flexibility, extensibility, and experimentation. Create custom strategies, integrate with other exchanges, and manage trades with ease.
https://github.com/m1chlcz/bingo-bot
algorithmic-trading automated-trading-in-financial-markets binance binance-trade-bot crypto crypto-bot cryptocurrency experimental go golang trading-bot work-in-progress
Last synced: 6 months ago
JSON representation
Bingo-Bot: A Binance-Go-Based Experimental Trading Bot. Automated trading bot for Binance, written in Go. Designed for flexibility, extensibility, and experimentation. Create custom strategies, integrate with other exchanges, and manage trades with ease.
- Host: GitHub
- URL: https://github.com/m1chlcz/bingo-bot
- Owner: M1chlCZ
- License: mit
- Created: 2024-11-22T03:47:35.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-11-23T01:06:37.000Z (8 months ago)
- Last Synced: 2025-11-23T03:10:48.683Z (8 months ago)
- Topics: algorithmic-trading, automated-trading-in-financial-markets, binance, binance-trade-bot, crypto, crypto-bot, cryptocurrency, experimental, go, golang, trading-bot, work-in-progress
- Language: Go
- Homepage:
- Size: 779 KB
- Stars: 5
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
- Audit: audit/init.go
- Security: security/binance_client.go
Awesome Lists containing this project
README
# Bingo-Bot 🚀
Bingo-Bot (Binance GO Bot) is a **work-in-progress**, **experimental trading bot** for Binance, built with **Go** and designed to be flexible, extensible, and easy to use. Whether you're testing strategies or building a robust trading system, Bingo-Bot is here to help!
---
## ⚡ Features
- **Automated Trading**: Works with Binance for spot trading. More exchanges coming soon!
- **Custom Strategies**: Easily implement your own strategies in the `./strategies/` folder.
- **Market Analysis**: Bot automatically analyzes markets and trades based on market conditions.
- **Automatic pairs add/remove**: Bot automatically adds new pairs and removes pairs that are not profitable.
- **Pluggable Exchanges**: Add other exchanges by adhering to the shared interface in `./interfaces/shared.go`.
- **Stop-Loss and Take-Profit**: Dynamic risk management for trades.
- **Multi-Pair Trading**: Manage multiple trading pairs with thread-safe operations.
- **Trend Filtering**: Combines indicators like RSI and MACD for smarter trades.
- **Docker Support**: Deploy quickly with Docker Compose.
- **Performance Logging**: Tracks your trades for performance analysis.
---
## 🚀 Getting Started
### Prerequisites
- **Go** (1.23)
- **Docker** and **Docker Compose** (optional)
- A **Binance API Key and Secret**
---
### Installation
1. **Clone the Repository**
```bash
git clone https://github.com/your-repo/bingo-bot.git
cd bingo-bot
```
2. **Prepare Environment Variables**
- Rename `.env.sample` to `.env`:
```bash
mv .env.sample .env
```
- Fill in your Binance API Key and Secret in the `.env` file:
```env
BINANCE_API_KEY=your_api_key
BINANCE_API_SECRET=your_api_secret
```
3. **Run with Docker Compose**:
- Update the database volume in the `docker-compose.yml` file if needed:
```yaml
volumes:
- /path/to/local/folder:/app/sqlite_data
```
- Start the bot:
```bash
docker-compose up --build
```
4. **Run Directly with Go**:
- Build and run:
```bash
go build -o bingo-bot main.go
./bingo-bot
```
- Or use `go run`:
```bash
go run main.go --log=debug
```
---
## ⚙️ Configuration
### Strategies
You can find the default strategies in the `./strategies/` folder. To add your own:
1. Implement a new struct that adheres to the `Strategy` interface in `./interfaces/shared.go`.
2. Add your logic for signal generation (e.g., RSI, MACD, Moving Averages).
3. The bot's trading logic manages multiple pairs using `MultiPairTradingBot`. Ensure your strategy is compatible with this multi-pair setup.
**Example**:
```go
type MyCustomStrategy struct {}
func (self *MyCustomStrategy) Calculate(candles []models.CandleStick, pair string, trend bool) (int, error) {
return 0, nil
}
```
### 🔧 Configuration Explained
Bingo-Bot uses a flexible configuration system found in the config package to manage strategies and settings for different market states. This system allows you to fine-tune how the bot behaves under varying market conditions.
#### MultiTrading Struct
##### The core configuration is handled by the MultiTrading struct, which defines:
**•** Market State Strategies: Separate strategy configurations (Default, Chaotic, Trending, etc.) for different market conditions.
**•** Intervals & Filters: Set how often the bot trades and analyzes the market, and filter markets to include or exclude certain trading pairs.
**•** Analyzer Config: Contains parameters for technical indicators (RSI, MACD, etc.) used in market analysis.
#### Updating Configurations
##### The bot provides methods to update configurations at runtime:
**•** UpdateStrategy(state, strategy): Change the strategy for a specific market state after validating it.
**•** UpdateAnalyzerConfig(analyzerConfig): Update the market analyzer’s parameters.
**•** Other update methods adjust intervals, include/exclude markets, and more.
You can also use default configurations or create your own by modifying the config package.
```
conf := config.DefaultMultiTradingConfig()
bt := bot.NewMultiPairTradingBot(cl, &conf)
```
### Exchanges
1. **Binance** is currently supported. More exchanges are coming soon!
2. To add a new exchange, implement the `ExchangeClient` interface in `./interfaces/shared.go`.
3. PRs are welcome for new exchange integrations.
### Adding New Exchanges
To integrate a new exchange:
1. Implement the `Exchange` interface in `./interfaces/shared.go`.
2. Provide methods for fetching market data, creating orders, and managing balances.
### Mutex and Thread Safety
The bot manages multiple trading pairs using internal thread-safe mechanisms.
- Mutexes are used to handle concurrent access to shared resources such as trading pairs and market data.
- No manual mutex handling is required for users implementing new strategies or adding pairs. The bot's `MultiPairTradingBot` handles this automatically.
For advanced users integrating new exchanges or modifying the bot, ensure proper thread safety by leveraging `sync.RWMutex` where applicable.
---
## 🌟 Example Use Cases
1. **Day Trading with RSI and MACD**:
- Uses a combination of RSI and MACD for smarter trading decisions.
- Stop-loss and take-profit are configured dynamically.
2. **Backtesting Strategies**:
- Simulate trading strategies on historical data.
---
## 📂 Project Structure
```plaintext
bingo-bot/
├── algos/ # Algos used for trading
├── analysis/ # Market analysis
├── bot/ # Core bot logic for trading
├── client/ # Binance API client
├── config/ # Config for trading bot
├── db/ # SQLite integration for logging trades
├── interfaces/ # Shared interfaces for strategies and exchanges
├── logger/ # Logger implementation
├── metrics/ # metrics reporting (wip)
├── ml/ # experimental ml model for predicting when to buy (wip/experimental)
├── models/ # structs for data models
├── plotter/ # Plotting for performance of the bot (wip)
├── strategies/ # Default and custom trading strategies
├── types/ # Custom types structs for the bot
├── utils/ # Utility functions (Performance, Time, etc.)
├── main.go # Entry point for the bot
├── Dockerfile # Docker file for building the bot
└── docker-compose.yml # Docker Compose for easy deployment
```
---
## ⚠️ Experimental 🚨
- **Bingo-Bot is experimental and should NOT be used with real money unless fully tested!**
- Trading involves risk. Use at your own discretion.
---
## 🤝 Contributing
Contributions are **welcome and encouraged**!
Feel free to submit **pull requests**, **bug reports**, or **feature requests**.
---
## 🔧 TODO
- [ ] Add backtesting framework.
- [x] Improve logging and analytics.
- [ ] Integrate more exchanges.
- [X] Add more strategies (Bollinger Bands, Stochastic Oscillator, etc.).
---
## 📜 License
MIT License.
---
### Happy Trading! 🚀
---