https://github.com/toniton/ml-crypto-trading
This is a free and open-source cryptocurrency trading bot written in Python.
https://github.com/toniton/ml-crypto-trading
bot cryptocurrency docker trading
Last synced: 4 months ago
JSON representation
This is a free and open-source cryptocurrency trading bot written in Python.
- Host: GitHub
- URL: https://github.com/toniton/ml-crypto-trading
- Owner: toniton
- License: lgpl-3.0
- Created: 2023-08-09T08:57:17.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2026-02-01T00:45:52.000Z (5 months ago)
- Last Synced: 2026-02-01T11:51:35.330Z (5 months ago)
- Topics: bot, cryptocurrency, docker, trading
- Language: Python
- Homepage:
- Size: 3.84 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# MCT Trading Bot
[](https://github.com/toniton/ml-crypto-trading/actions/workflows/ci.yml)
[](https://github.com/pylint-dev/pylint)
[](https://codecov.io/github/toniton/ml-crypto-trading)
[](https://github.com/pre-commit/pre-commit)
[](https://hub.docker.com/r/toniton/ml-crypto-trading)
[](https://discord.gg/vZh8w3Sz)
MCT (stands for ML-Crypto-Trading) is a high-performance trading engine that features a **Dynamic Expression Engine**
allowing users to define position sizing and risk management logic using familiar, spreadsheet-like functions.
> [!TIP]
> **Financial Logic Without the Code.**
> If you can write an Excel-style formula, you can define trading logic in MCT. The engine provides access to real-time
> market data, balances, and technical indicators (RSI, EMA, SMA) directly in your configuration.
> Caveat Utilitor! For educational and research purposes only.
---
## Community
Join our Discord community to discuss strategies, report issues, and collaborate with other traders:
[](https://discord.gg/vZh8w3Sz)
---
## Quick Start
The easiest way to run the bot is using **Docker**.
### Prerequisites
- **Docker & Docker Compose**: Installed and running on your system.
- **PostgreSQL**: A running instance (local or remote) to store trading history.
### 1. Configuration
Create your asset configuration and environment variables.
**assets.yaml**
```yaml
assets:
- name: "Bitcoin (Safety First)"
base_ticker_symbol: "BTC"
exchange: "CRYPTO_DOT_COM"
min_quantity: 0.00001
schedule: 4
# Dynamic logic: Use 2% of balance
dynamic_quantity: "max(min_qty, (balance * 0.02) / close)"
- name: "Ethereum (Aggressive)"
base_ticker_symbol: "ETH"
exchange: "CRYPTO_DOT_COM"
min_quantity: 0.01
schedule: 2
# Scaling logic: Scale up by 50% if RSI < 30
dynamic_quantity: "(balance * 0.05 / close) * (1.5 if rsi(14) < 30 else 1.0)"
```
**.env**
```env
APP_ENV=production
CRYPTO_DOT_COM__API_KEY=your_api_key
CRYPTO_DOT_COM__SECRET_KEY=your_secret_key
DATABASE_CONNECTION_HOST=localhost:5432
POSTGRES_USER=postgres
POSTGRES_PASSWORD=your_password
POSTGRES_DATABASE=trading_bot
```
### 2. Run Modes
#### 📊 Backtesting (Historical Data)
Test your strategy without risking real funds using historical CSV data.
```bash
docker run -v $PWD:/workspace toniton/ml-crypto-trading \
--assets-conf=/workspace/assets.yaml \
--backtest-mode=true \
--backtest-source=/workspace/history/
```
#### 🧪 Simulated Trading (Real-time Paper Trading)
Run the bot with real-time market data but simulate order execution in memory.
```bash
docker run --env-file .env -v $PWD:/workspace toniton/ml-crypto-trading \
--assets-conf=/workspace/assets.yaml \
--simulated=true
```
#### 🚀 Live Trading (Real Exchange)
Execute real trades on the configured exchange.
```bash
docker run --env-file .env -v $PWD:/workspace toniton/ml-crypto-trading \
--assets-conf=/workspace/assets.yaml
```
*For multi-container setups (with Database), check the included `docker-compose.yml`.*
---
## Documentation
For more detailed information, please refer to the documentation in the `docs/` directory:
- [Introduction & Features](docs/introduction.md)
- [Core Concepts](docs/concepts.md)
- [Configuration & System Properties](docs/configuration.md)
- [Architecture & Diagrams](docs/architecture.md)
- [Logging Architecture](docs/logging.md)
- [Community & Contributing](docs/community.md)
---
## License
This source code is available on GitHub under
the [GNU Lesser General Public License v3.0](https://www.gnu.org/licenses/lgpl-3.0.en.html).