Passivbot: A Comprehensive Guide to the Automated Trading Bot

Introduction to Passivbot

Passivbot is a sophisticated cryptocurrency trading bot designed to operate with minimal user intervention. Written in Python and Rust, it supports multiple exchanges including Bybit, OKX, Bitget, GateIO, Binance, and Hyperliquid.

👉 Explore Passivbot's advanced features

Disclaimer: Use at your own risk. Current version: v7.3.13.

How Passivbot Works

Core Functionality

Passivbot operates on perpetual futures markets, acting as a contrarian market maker. Unlike predictive bots, it stabilizes prices by placing limit orders that resist price movements in both directions. Key features include:

• Automated order management: Creates/cancels limit orders dynamically.
• Backtesting & Optimization: Uses Rust-powered tools for historical analysis and config refinement via evolutionary algorithms.

Trading Strategy

Inspired by Martingale, Passivbot employs a grid-based approach:

1. Small initial entries followed by strategic re-entries to average down.
2. Take-profit orders placed after each re-entry to capitalize on minor reversals.
3. Trailing orders (optional) enhance profit capture by reacting to retracements.

Advanced Features

• Forager: Targets high-volatility markets using real-time volatility metrics.
• Unstucking Mechanism: Exits underperforming positions systematically to preserve capital.

Installation Guide

Prerequisites

• Python ≥ 3.8
• Rust (for performance-critical components)

Step-by-Step Setup

1. Clone the Repository:

   git clone https://github.com/enarjord/passivbot.git
   cd passivbot

2. Install Rust via rust-lang.org.

3. Set Up a Virtual Environment:

   python -m venv venv
   source venv/bin/activate  # Linux/Mac
   venv\Scripts\activate    # Windows

4. Install Dependencies:

   pip install -r requirements.txt

5. Build Rust Extensions (optional):

   cd passivbot-rust
   maturin develop --release

6. Configure API Keys:

   • Copy api-keys.json.example to api-keys.json and input exchange credentials.

7. Launch the Bot:

   python src/main.py -u your_account_name

   Or use a custom config:

   python src/main.py path/to/config.json

Optimizing Performance

Backtesting & Configuration

• Use the included Rust backtester for historical strategy validation.
• Leverage the optimizer to automate parameter tuning.

👉 Maximize profits with optimized settings

FAQ

Q1: Is Passivbot suitable for beginners?

A: While powerful, it requires basic knowledge of Python and crypto trading. Start with default configs and small funds.

Q2: How does Passivbot handle market crashes?

A: Its contrarian strategy and unstucking mechanism mitigate risks, but no bot is crash-proof.

Q3: Can I run Passivbot 24/7?

A: Yes, it’s designed for continuous operation. Monitor periodically for updates.

Support & Community

Documentation

• Detailed guides available in the /docs folder of the repository.

Third-Party Tools

• Passivbot GUI: pbgui GitHub
• Managed Services: Passivbot Manager

Contributions

• Donate via USDT (BEP20/Arbitrum) or BTC to support development.
• Referrals: Binance, Bybit, OKX, and other links are available in the repository.

License

Passivbot is open-source and free for any use. Modify, distribute, or commercialize without restrictions.

**Notes**: