Documentation - PI Trading Bot

📖

User Guide

Complete guide to installation, dashboard, exchanges, and configuration.

📊

Strategy Manual

Deep dive into all 10 trading strategies with configuration tips.

🚀

Quick Start

Get up and running in 5 minutes with our quick start guide.

🔌

API Reference

REST API endpoints for advanced integrations.

Get Started

🚀 Quick Start Guide

From download to first trade in under 5 minutes.

Step 1: Download & Extract

# Download the latest release
wget https://pitradebots.com/downloads/pi-trading-bot-v1.1.zip

# Extract
unzip pi-trading-bot-v1.1.zip
cd pi-trading-bot

Step 2: Install Dependencies

# Linux / Raspberry Pi
chmod +x *.sh
./install.sh

# Windows
install.bat

The installer will set up Python virtual environment and all dependencies.

Step 3: Start the Bot

# Linux / Raspberry Pi
./start.sh

# Windows
start.bat

The bot will start in background mode. Access the dashboard at http://localhost:8000

Step 4: Configure Exchange

Open http://localhost:8000 in your browser
Click "Activate" on your preferred exchange (Kraken or MEXC)
Enter your API Key and Secret
Select your trading pairs and strategies
Configure risk management settings

Step 5: Start Trading

Enable "Paper Trading" mode first to test
Click "Start Bot" for your exchange
Monitor signals and activity in the dashboard
When confident, disable paper trading for live trades

⚠️

Important: Always start with paper trading mode to test your configuration before risking real capital.

Complete Guide

📖 User Guide

1. System Requirements

MINIMUM

2 CPU cores
1 GB RAM
Python 3.8+
100 MB storage
Stable internet connection

RECOMMENDED

Raspberry Pi 5 (4+ cores)
4 GB RAM
Python 3.10+
1 GB storage
Starlink or fiber connection

2. Installation Options

The installer script provides several options:

Virtual Environment: Isolated Python environment (recommended)
Systemd Service: Auto-start on boot (Linux/Pi only)
Port Configuration: Default 8000, configurable

3. Dashboard Overview

The web dashboard provides:

System Stats: CPU, memory, network usage
Exchange Cards: Activate and monitor exchanges
Market Data: Real-time prices and 24h changes
Signal Feed: Live trading signals with confidence scores
Activity Logs: Detailed logs per exchange
Configuration: Markets, strategies, risk settings

4. Exchange Configuration

Each exchange requires:

API Key: From your exchange account
API Secret: Keep this private!
Permissions: Trade only (never withdrawal)
IP Whitelist: Recommended for security

🔒 API keys are stored locally only. Never transmitted to any server.

5. Risk Management Settings

Setting	Description	Recommended
Stop Loss	Exit position at loss %	3-5%
Take Profit	Exit position at gain %	5-10%
Position Size	% of balance per trade	10-20%
Max Positions	Simultaneous open trades	3-5
Daily Loss Limit	Pause trading after $ loss	$50-100
Min Confidence	Signal threshold to trade	55-65%

6. Management Scripts

Action	Linux/Pi	Windows
Install	`./install.sh`	`install.bat`
Start	`./start.sh`	`start.bat`
Stop	`./stop.sh`	`stop.bat`
Status	`./status.sh`	Task Manager
View Logs	`./logs.sh`	`logs.bat`

Trading Intelligence

📊 Strategy Manual

Complete guide to all 10 trading strategies.

Signal Aggregation System

PI Trading Bot uses a weighted signal aggregation system:

Each enabled strategy analyzes current market conditions
Strategies generate BUY, SELL, or HOLD signals
Signals are multiplied by their weight (1.1x - 1.8x)
Weighted signals combine to produce final confidence score
Trade executes if confidence exceeds minimum threshold

Strategy Weights

Strategy	Weight	Type
4D Cyclical Pattern	1.8x	Multi-Factor
Heikin-Ashi Trend	1.5x	Trend
Trend Following	1.5x	Trend
Bollinger Squeeze	1.4x	Volatility
Support/Resistance	1.4x	Levels
RSI 2-Period	1.3x	Momentum
MACD Divergence	1.3x	Reversal
MA Crossover	1.2x	Trend
Volume Breakout	1.2x	Breakout
Mean Reversion	1.1x	Counter-Trend

Trading Profiles

Profile	Min Confidence	Position Size	Strategies	Daily Limit
Conservative	65%	15%	5	$50
Moderate	55%	20%	7	$100
Aggressive	40%	25%	10	$150

View Full Strategy Details

For Developers

🔌 API Reference

REST API endpoints for programmatic access.

Base URL

http://localhost:8000/api

GET /api/status

Returns bot status and system information.

{
  "status": "running",
  "uptime": 3600,
  "exchanges": {
    "kraken": {"active": true, "trading": true},
    "mexc": {"active": false, "trading": false}
  }
}

GET /api/signals

Returns recent trading signals.

{
  "signals": [
    {
      "exchange": "kraken",
      "market": "BTC/USDT",
      "action": "BUY",
      "confidence": 0.72,
      "strategies": ["4d_cyclical", "heikin_ashi"],
      "timestamp": "2025-12-23T10:30:00Z"
    }
  ]
}

GET /api/markets/{exchange}

Returns market data for an exchange.

{
  "markets": [
    {
      "symbol": "BTC/USDT",
      "price": 97500.00,
      "change_24h": 2.5,
      "volume_24h": 1250000000
    }
  ]
}

POST /api/config/{exchange}

Update configuration for an exchange.

// Request body
{
  "strategies": ["4d_cyclical", "heikin_ashi", "rsi_2"],
  "markets": ["BTC/USDT", "ETH/USDT"],
  "risk": {
    "stop_loss": 3,
    "take_profit": 6,
    "position_size": 15
  }
}

Need More Help?

Can't find what you're looking for? Check our FAQ or contact support.

View FAQ Contact Support