MCPcopy Create free account
hub / github.com/Drakkar-Software/OctoBot

github.com/Drakkar-Software/OctoBot

Chat with this repo
repository ↗ · DeepWiki ↗ · release 3.0.0-beta1 ↗ · + Follow · compare 2 versions
27,373 symbols 88,833 edges 3,356 files ⚖ custom 4,811 documented · 18% updated 2d ago3.0.0-beta1 · 2026-07-30★ 6,291148 open issues

Browse by type

Functions 23,558 Types & classes 3,617 Endpoints 198
What it actually does AI analysis from the code graph
loading…
README

OctoBot - Free Open Source Crypto Trading Bot

PyPI Downloads Dockerhub OctoBot-CI Ask DeepWiki

Telegram Chat Discord Telegram News Twitter YouTube

The new OctoBot beta is live

The latest release runs in node mode by default. Your node acts as the backend for the new OctoBot interface and mobile app, where you manage wallets, automations, and multiple strategies from a unified and secure dashboard.

From the node interface, you can also start a manual OctoBot instance for backtesting, Telegram, TradingView, and other classic OctoBot workflows.

Read the full beta announcement to learn more about the largest OctoBot update ever.

Please note that the new OctoBot beta is a work in progress. You may hit bugs or incomplete features.

Open source crypto trading bot with a visual user interface

OctoBot is an open source cryptocurrency trading robot designed for crypto investors who want to automate their investment strategies. The bot can automate strategies using built-in:

The trading bot is written in Python and built as a free open source software since 2018. It can be installed on your system or executed on a cloud provider.

Control OctoBot from desktop, mobile, web, or Telegram

Are you looking for a bot you can set up from the peaceful environment of your home computer and that you can follow from anywhere using your phone?

OctoBot beta: node mode and the new interface

Install the latest release and run OctoBot on your computer or server. Connect to it from the new OctoBot interface in your browser, or from the mobile app.

From one node, run multiple automations (DCA, grids, crypto baskets, TradingView, and more) and monitor your full portfolio in one dashboard.

The new OctoBot's philosophy revolves around 3 pillars: 1. Multi-portfolio analysis and automation 2. Self custody: your keys never leave your devices 3. Zero knowledge privacy: all your data is end-to-end encrypted, no one can read them except you

Classic OctoBot: web interface and Telegram

OctoBot is designed for crypto investors who want to automate their trading strategies in a simple way, using a graphic interface to:

  • Configure the details of their strategy and its traded markets and exchange(s)
  • Test and optimize the strategy using backtesting
  • Live test it with paper money
  • Execute it on a real exchange account, by automatically sending orders to the exchange

A manual OctoBot instance can still be configured and followed using its built-in web interface, making it reachable when running on a cloud server. OctoBot can also be connected to a Telegram bot, turning OctoBot into a Telegram trading bot.

You can also follow your trading bot from the OctoBot mobile app, which is designed to automate octobot.cloud strategies. The app can also be used to follow your open source OctoBot's profits, portfolio, open orders and trades.

The public (non-beta) OctoBot mobile app is designed for octobot.cloud strategies. To manage your open source OctoBot in beta, use the new OctoBot interface or mobile beta app instead.

Live and backtesting trading strategies automation

OctoBot is more than just a strategy execution engine, it can also simulate investments using risk-free paper trading.

Even better, the trading robot comes with its built-in backtesting engine to help you test and optimize your strategy over a long period of time with a simulated portfolio and historical exchange data.

Backtesting your trading strategy and portfolio will give you accurate insights on the past performance and behavior of your trading strategy starting from its initial portfolio. This analysis tool gives you all the metrics to create the best version of your strategy before automating it with your real funds, on your exchange account.

Your trading bot for Binance, Coinbase, Hyperliquid and 15+ other exchanges

OctoBot supports the vast majority of crypto exchanges thanks to the great CCXT library.

This wide range of supported exchanges makes it easy to create investment strategies on any crypto, from Bitcoin, Ethereum or Solana to altcoins from the darkest depths of the altcoin forest.

Supported exchanges notably include:

  • Binance spot and futures trading using the REST and websocket APIs
  • Coinbase spot trading using the REST and websocket APIs
  • Bybit spot and futures trading using the REST and websocket APIs. Note: due to a recent update, the Bybit API will soon be available again on OctoBot
  • Hyperliquid spot trading (with API Keys) using the REST and websocket APIs
  • MEXC spot trading using the REST and websocket APIs
  • Kucoin spot and futures trading using the REST and websocket APIs
  • All HollaEx-Powered exchanges. Learn more on HollaEx, the open source white label exchange
  • Many other such as OKX, Binance US, Crypto.com, HTX, Bitget, BingX, CoinEx, BitMart, Phemex, Gate.io, Ascendex and more on the full list of supported exchanges.

Automate your trading strategies

OctoBot is designed as a one-stop-shop for crypto trading strategies. If you think of a crypto trading strategy, it can most likely be automated by OctoBot, unless it requires very complex custom mechanisms.

AI trading bot

OctoBot can be an AI trading bot using OpenAI models such as ChatGPT. The ChatGPT trading mode is the dedicated OctoBot configuration to give market context to a LLM model, ask for its opinion and trade accordingly.

Local LLM models, such as Ollama llama or any custom model running on your Ollama server can also be used by the bot for deeper customization and cost management.

Grid trading bot

Grid trading is a strategy that extracts value from volatility. Unlike most strategies, it relies on pure math and no statistics. It will "simply" create and maintain many buy and sell orders at regular intervals and generate profits every time both buy and sell orders are executed. The OctoBot grid trading bot can be heavily customized and optimized to be perfectly adapted to your market and exchange.

DCA trading bot

Dollar Cost Averaging (DCA) is a well known investment strategy where you buy on a regular basis in order to profit from local price drops. It allows investors to reduce their overall buying costs. As a DCA trading bot, OctoBot can optimize your investment strategies for short or long term gains with heavy customization and backtesting capabilities.

TradingView trading bot

Use OctoBot as your TradingView trading bot and simply emit alerts from your TradingView indicators or strategies. Use these alerts to trade any crypto market, on any exchange from your TradingView native strategy.
Whether it's from a visual TradingView indicator or a heavily optimized Pine Script strategy, your trades can be automated.

Crypto basket trading bot

Crypto baskets are similar to stock indexes or ETFs. They enable you to invest into many cryptocurrencies, all at once, in a simple way. A crypto basket is a simple way to invest in the whole crypto market at once, or follow coin categories, such as AI or RWA coins.
OctoBot can be used as a crypto basket trading bot and make it simple to invest in customized crypto indexes or follow baskets from the wide range of OctoBot cloud's crypto baskets.

Market Making trading bot

OctoBot can also automate market making strategies to help token creators provide liquidity to their markets.

Advanced market making strategies can be automated on market-making.octobot.cloud, the self-service market making platform based on OctoBot. Feel free to contact us if you have any questions about it.

Institutional custom strategies

If you represent an institution that is interested in a commercial license or custom development to suit your specific needs or strategy, please contact us at contact@drakkar.software.

Installing OctoBot, open source crypto trading bot

Starting the latest release runs OctoBot in node mode. See the getting-started guide to connect the new OctoBot interface to your node.

OctoBot can be deployed on the cloud or for free on your computer, server or Raspberry Pi.

Deploying OctoBot with one click on DigitalOcean

OctoBot can be easily launched in the cloud from the DigitalOcean Marketplace.

Deploy on DigitalOcean

Using the OctoBot Executable

This is the easiest way to download and install OctoBot on your computer or server. Here is [our executable installation guide](https://www.octobot.cloud/en/guides/octobot-installation/install-octobot-on-your-comput

Extension points exported contracts — how you extend this code

browse all types & interfaces →

Core symbols most depended-on inside this repo

browse all functions →

Shape

Method 15,042
Function 8,516
Class 3,564
Route 198
Interface 53

Languages

Python94%
TypeScript6%

Modules by API surface

packages/tentacles/Meta/DSL_operators/octobot_process_operators/tests/test_octobot_process_ops.py184 symbols
packages/tentacles/Trading/Exchange/polymarket/ccxt/polymarket_sync.py154 symbols
packages/tentacles/Trading/Exchange/polymarket/ccxt/polymarket_async.py154 symbols
packages/trading/octobot_trading/exchanges/types/rest_exchange.py150 symbols
packages/trading/octobot_trading/exchanges/connectors/ccxt/ccxt_connector.py135 symbols
octobot/community/authentication.py132 symbols
additional_tests/exchanges_tests/abstract_authenticated_exchange_tester.py132 symbols
packages/tentacles/Trading/Mode/staggered_orders_trading_mode/staggered_orders_trading.py123 symbols
packages/tentacles/Services/Interfaces/web_interface/models/configuration.py122 symbols
packages/commons/tests/dsl_interpreter/test_custom_operators.py116 symbols
packages/node/tests/scheduler/workflows/test_automation_workflow.py96 symbols
packages/trading/octobot_trading/personal_data/orders/order.py94 symbols

Dependencies from manifests, versioned

@biomejs/biome2.4.13 · 1×
@docusaurus/core3.9.2 · 1×
@docusaurus/module-type-aliases3.9.2 · 1×
@docusaurus/plugin-client-redirects3.9.2 · 1×
@docusaurus/preset-classic3.9.2 · 1×
@docusaurus/types3.9.2 · 1×
@drakkar.software/octochat-sdk0.8.1 · 1×
@drakkar.software/starfish-identities3.0.0-alpha.27 · 1×
@hey-api/openapi-ts0.73.0 · 1×
@hookform/resolvers5.2.2 · 1×
@mdx-js/react3.0.0 · 1×

Datastores touched

temp_empty_databaseDatabase · 1 repos
dbDatabase · 1 repos
dbos_exampleDatabase · 1 repos

For agents

$ claude mcp add OctoBot \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page