Loading repository data…
jptsantossilva / repository
Open-source Binance spot trading bot with automated backtesting, strategy selection, market-phase analysis, dashboard monitoring, and Telegram alerts.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
Like my work?
Free and open-source automated trading app for Binance spot, combining multi-strategy execution, daily market-phase ranking, automated backtesting, market analysis dashboards, a web dashboard, and Telegram notifications.
mkdir -p /opt/bec
cd /opt/bec
curl -fsSL https://raw.githubusercontent.com/jptsantossilva/BEC/main/docker-compose.yml -o docker-compose.yml
curl -fsSL https://raw.githubusercontent.com/jptsantossilva/BEC/main/.env.example -o .env
nano .env
Fill .env with your Binance, Telegram, and OpenAI credentials.
# Binance API
binance_api=
binance_secret=
# Telegram
telegram_chat_id=
telegram_token_closed_positions=
telegram_token_errors=
telegram_token_main=
telegram_token_signals=
# OpenAI
OPENAI_API_KEY=
BEC_OPENAI_MODEL="gpt-5.5"
OPENAI_API_KEY is required for AI analysis in Backtesting Results. BEC_OPENAI_MODEL is optional and defaults to gpt-5.5.
sudo docker compose pull
sudo docker compose up -d
What you get:
http://localhost:8080 for monitoring PnL, balances, open positions, scheduled jobs, backtesting results, and settingshttp://localhost:8081 to inspect the database.Useful commands:
docker compose ps — show running containers and their status.docker compose logs -f dashboard — live logs from the dashboard.docker compose logs -f jobs_runner — live logs from the scheduler.docker compose restart — restart all services.docker compose down — stop and remove containers (keeps volumes).To remove everything:
docker compose down -v
This removes the persistent database volume. Do not use docker compose down -v
when updating an existing production install.
Follow the last updates from the change log here
If you prefer updating BEC without using terminal commands, you can manage your Docker Compose stack with Dockge.
sudo mkdir -p /opt/dockge/data
cd /opt/dockge
Create compose.yaml:
services:
dockge:
image: louislam/dockge:1
restart: unless-stopped
ports:
- "127.0.0.1:5001:5001"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- ./data:/app/data
- /opt/bec:/opt/bec
environment:
- DOCKGE_STACKS_DIR=/opt/bec
Start Dockge:
docker compose -f /opt/dockge/compose.yaml up -d
Open Dockge at http://localhost:5001, create your admin account, and import/create your BEC stack.
Update BEC from Dockge:
Security note:
Market analysis signals are informational macro/on-chain signals only. They do not create Binance orders, change position sizing, or modify stop loss, take profit, symbol selection, balances, backtesting, or trading strategy logic.
Most application code lives in the bec/ package. Thin compatibility wrappers remain in
the repository root for existing Docker, Streamlit, cron, and scheduler commands such as
streamlit run dashboard.py, python jobs_runner.py, and python main.py 1d.
Streamlit pages remain in pages/. Runtime data keeps the existing paths: data.db,
main.log, and static/backtest_results.
Backtesting report (BTCUSDC, 1d):
Open the full interactive example: BTCUSDC-ema_cross_with_market_phases-1d.html
This software is for educational purposes only. Use the software at your own risk. The authors and all affiliates assume no responsibility for your trading results. Do not risk money that you are afraid to lose. There might be bugs in the code. This software does not come with any warranty.
This project is MIT licensed.
Copyright © 2026 (https://github.com/jptsantossilva)
Selected from shared topics, language and repository description—not editorial ratings.
Stronex-Labs /
End of All Trades. Ruthless backtesting engine for long-only spot crypto strategies. Walk-forward validation, regime filtering, community leaderboard.
65/100 health