MCPcopy Index your code
hub / github.com/Drakkar-Software/OctoBot

github.com/Drakkar-Software/OctoBot @2.1.1 sqlite

repository ↗ · DeepWiki ↗ · release 2.1.1 ↗
19,338 symbols 63,768 edges 2,414 files 3,225 documented · 17%
README

OctoBot - Free Open Source Crypto Trading Bot

PyPI Downloads Dockerhub OctoBot-CI Ask DeepWiki

OctoBot free open source trading bot web user interface showcase

OctoBot Telegram Chat Discord Telegram News Twitter YouTube

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: - Strategies such as grids, DCA strategies, crypto baskets and much more, which can all be configured - AI connectors to trade using any OpenAI or Ollama model such as ChatGPT, llama or any custom model running on an Ollama server - TradingView connectors to automate trades from TradingView indicators or strategies - Social indicators to analyze social data such as Google trends or Reddit - Technical analysis indicators such as RSI, Moving Averages or MACD - 15+ exchange integrations including Binance, Coinbase, MEXC and Hyperliquid

OctoBot - Open Source Crypto Trading Bot Introduction Video from the official OctoBot YouTube Channel

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

An easy to use trading bot with a Mobile App, Web and Telegram user interfaces

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

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

Once started, an OctoBot can be followed using its web interface, making it reachable when running on a cloud server.
OctoBot can also be connected to a Telegram bot, therefore 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.

octobot mobile app dashboard with portfolio value and two live bots with news     
octobot mobile app bot view with portfolio content recent activities and historical profits

<a href='https://apps.apple.com/us/app/octobot-crypto-investment/id6502774175?utm_source=octobot-github&utm_media=readme&utm_content=mobile-app-img'><img alt='Get it on the Apple Play Store' src='../assets/apple_store.png' height="50px"/></a>
<a href='https://play.google.com/store/apps/details?id=com.drakkarsoftware.octobotapp&utm_source=octobot-github&utm_media=readme&utm_content=mobile-app-img'><img alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/images/generic/en_badge_web_generic.png' height="50px"/></a>

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 report using grid trading on eth btc with 8 percent profit

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.

list of octobot supported exchanges including binance coinbase hyperliquid mexc and more

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 model 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.

octobot market making dashboard with buy and sell orders

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

<img src="../assets/a-man-relaxing-in-his-couch-whi

Extension points exported contracts — how you extend this code

ImportMetaEnv (Interface)
(no doc)
packages/tentacles/Services/Interfaces/node_web_interface/src/vite-env.d.ts
ImportMeta (Interface)
(no doc)
packages/tentacles/Services/Interfaces/node_web_interface/src/vite-env.d.ts
FileRoutesByFullPath (Interface)
(no doc)
packages/tentacles/Services/Interfaces/node_web_interface/src/routeTree.gen.ts
FileRoutesByTo (Interface)
(no doc)
packages/tentacles/Services/Interfaces/node_web_interface/src/routeTree.gen.ts
FileRoutesById (Interface)
(no doc)
packages/tentacles/Services/Interfaces/node_web_interface/src/routeTree.gen.ts

Core symbols most depended-on inside this repo

get
called by 1676
packages/trading/octobot_trading/personal_data/portfolios/history/historical_asset_value.py
join
called by 743
packages/async_channel/async_channel/consumer.py
extend
called by 666
packages/commons/octobot_commons/dsl_interpreter/interpreter.py
find
called by 657
packages/tentacles_manager/octobot_tentacles_manager/models/tentacle.py
get_currency_portfolio
called by 656
packages/trading/octobot_trading/personal_data/portfolios/portfolio.py
debug
called by 580
packages/commons/octobot_commons/logging/logging_util.py
get
called by 558
packages/sync/octobot_sync/chain/registry.py
update
called by 500
packages/trading/octobot_trading/personal_data/state.py

Shape

Method 10,628
Function 6,426
Class 2,127
Route 135
Interface 22

Languages

Python96%
TypeScript4%

Modules by API surface

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.py151 symbols
octobot/community/authentication.py122 symbols
additional_tests/exchanges_tests/abstract_authenticated_exchange_tester.py121 symbols
packages/tentacles/Trading/Mode/staggered_orders_trading_mode/staggered_orders_trading.py120 symbols
packages/tentacles/Services/Interfaces/web_interface/models/configuration.py119 symbols
packages/trading/octobot_trading/exchanges/connectors/ccxt/ccxt_connector.py118 symbols
packages/commons/tests/dsl_interpreter/test_custom_operators.py116 symbols
packages/trading/octobot_trading/personal_data/orders/order.py93 symbols
packages/trading/octobot_trading/exchanges/abstract_exchange.py90 symbols
octobot/community/supabase_backend/community_supabase_client.py85 symbols

Dependencies from manifests, versioned

@biomejs/biome2.3.10 · 1×
@hey-api/openapi-ts0.73.0 · 1×
@hookform/resolvers5.2.2 · 1×
@playwright/test1.57.0 · 1×
@radix-ui/react-avatar1.1.11 · 1×
@radix-ui/react-checkbox1.3.3 · 1×
@radix-ui/react-dialog1.1.15 · 1×
@radix-ui/react-dropdown-menu2.1.16 · 1×
@radix-ui/react-label2.1.8 · 1×
@radix-ui/react-radio-group1.3.8 · 1×
@radix-ui/react-scroll-area1.2.10 · 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