explaingit

drakkar-software/octobot

5,917PythonAudience · generalComplexity · 3/5Setup · moderate

TLDR

OctoBot is a free, open-source cryptocurrency trading bot that automatically runs your chosen trading strategies around the clock on over 15 exchanges including Binance and Coinbase.

Mindmap

mindmap
  root((octobot))
    Strategies
      Grid Trading
      DCA Averaging
      TradingView Alerts
      AI and Social Signals
    Exchanges
      Binance
      Coinbase
      MEXC and others
    Testing
      Backtesting Engine
      Paper Trading Mode
    Access
      Web Interface
      Telegram Bot
      Mobile App
    Deployment
      Docker
      Cloud Hosting
      Own Server
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Automate a grid trading or dollar-cost averaging strategy on Binance without watching charts manually.

USE CASE 2

Connect TradingView alerts to real trades so your custom indicator triggers actual buy and sell orders.

USE CASE 3

Backtest a trading strategy against historical price data before risking any real money.

USE CASE 4

Monitor live positions and portfolio value from anywhere via the web interface or mobile app.

Tech stack

PythonCCXTDocker

Getting it running

Difficulty · moderate Time to first run · 1h+

Requires exchange API keys with trading permissions, Docker is the recommended install path, connecting real funds requires extra caution during initial configuration.

In plain English

OctoBot is a free, open-source program that automatically executes cryptocurrency trading strategies on your behalf. Instead of watching charts and placing orders manually, you configure a strategy once and OctoBot runs it around the clock, connecting directly to your exchange account to buy and sell based on the rules you set. It has been in active development since 2018 and is written in Python. The bot supports several built-in strategy types. Grid trading divides a price range into a grid and automatically buys when price falls and sells when it rises. DCA (dollar-cost averaging) invests a fixed amount at regular intervals to reduce the impact of price swings. You can also connect OctoBot to TradingView, a popular charting platform, so that alerts from your own indicators or scripts there trigger real trades. There is also an AI connector that lets you hook the bot up to language models from OpenAI or locally-run Ollama models to inform trading decisions. Social signals from sources like Google Trends and Reddit are supported as well. OctoBot works with more than 15 exchanges including Binance, Coinbase, MEXC, and Hyperliquid, using a library called CCXT to communicate with them. Before committing real money, you can test a strategy using the built-in backtesting engine, which runs your strategy against historical price data, or use paper trading to simulate trades in real time without spending anything. The bot can be run on your own computer or hosted on a cloud server, and it is manageable through a web interface, a Telegram bot connection, or a mobile app available for iOS and Android. Once running on a server, the web interface lets you monitor open positions, recent trades, and portfolio value from anywhere. Installation is available via Docker, direct Python setup, or through the OctoBot cloud hosting service if you prefer not to manage your own server.

Copy-paste prompts

Prompt 1
I want to set up OctoBot to run a DCA strategy on Binance, buying a fixed amount of Bitcoin every day. Walk me through the configuration steps from installation to connecting my exchange API keys.
Prompt 2
Using OctoBot's backtesting engine, how do I test a grid trading strategy on Ethereum against 90 days of historical data and interpret the results?
Prompt 3
I have a TradingView Pine Script alert set up for RSI crossovers. How do I connect OctoBot to TradingView so those alerts automatically place real trades on my exchange?
Prompt 4
What is the difference between running OctoBot locally with Docker versus using OctoBot Cloud, and which is better if I want 24/7 uptime without leaving my computer on?
Open on GitHub → Explain another repo

← drakkar-software on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.