Practical overview
When it fits
Use it when you need a self-hosted Binance automation workflow that combines configurable strategy profiles, historical backtesting, and operational monitoring. The repository's warning about active development and real-fund use makes staged evaluation important.
Who it is for
- People operating a Binance trading service on their own server.
- Developers extending a strategy-pluggable TypeScript application.
- Users evaluating grid, momentum, or rebalancing approaches with historical data before connecting trading activity.
Documented uses
- Connect a self-hosted application to a Binance account through an API key.
- Monitor selected coins and apply configured buy, sell, or wait rules.
- Organize different coins, budgets, and strategies into independent profiles.
- Replay strategies against historical candles and retain runs for comparison.
- Monitor positions, orders, signals, and symbol activity from a web dashboard.
Requirements & limits
The repository is publicly available under the Apache-2.0 license. It documents local development with Bun and Docker and describes deployment through Docker on a VM. Connecting trading activity requires a Binance API key.
- It is tied to the Binance ecosystem and uses API-key account connections.
- Strategies are configured per profile, with documented grid, momentum, and rebalancing options.
- Historical backtesting is available before risking funds and retains prior runs for comparison.
- The architecture uses Postgres with TimescaleDB and Redis with BullMQ.
- The project documentation says it is under active development and not recommended for real funds.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up the local development stack
Install dependencies, initialize the local services, and start the application for development.
Before you start
- Bun 1.4 or later; the repository pins Bun 1.4.2.
- Docker with the compose plugin.
- Commands run from the repository root.
Steps
Run
bun install.Run
bun run setupto create the environment configuration, start the local Postgres and Redis stack, and run migrations.Run
bun run devto start the API, web application, worker, and technicals services.Open the SPA at
http://localhost:5173.
Expected outcome
The local Binance Trading Bot development stack is started and the SPA is available at the documented local address.
Guide limitations
- This is a development setup, not a documented live-trading procedure.
- The repository notes that Bun 1.3.x cannot parse its lockfile.
Run the application stack in containers
Start the complete application stack through the documented container-based development command.
Before you start
- A cloned repository.
- Docker with the compose plugin.
Steps
Run
bun run docker:devfrom the repository root.Use the documented application endpoint at
http://localhost:53000.
Expected outcome
A single containerized app service runs the SPA and `/api` on the documented local port.
Guide limitations
- The source describes this as a development option and does not establish a production deployment result.
- The command depends on the repository's container configuration.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 1 October 2026
- Original website title
- chrisleekr/binance-trading-bot · Official homepage title · retained in its source language