Freqtrade Tools

Shell aliases and helper commands for faster Freqtrade workflows across Linux, macOS, and Windows.

Installation

Bash/Zsh: Copy functions from references/bash-zsh-aliases.md into ~/.bashrc (Linux) or ~/.zshrc (macOS), then source ~/.bashrc.

PowerShell: Copy functions from references/windows-equivalents.md into your $PROFILE file.

Core Commands

ftdata — Download Data

Download market data with automatic date range calculation.

Usage:

ftdata "BTC/USDT" 90 5m           # Download 90 days of 5-min BTC/USDT data
ftdata "ETH/USDT" 30 1h           # 30 days of 1-hour ETH/USDT
ftdata "SOL/USDT"                 # Use defaults: 30 days, 5-min
ftdata "XRP/USDT" 365 5m --erase  # Download 1 year, erase old data first

Parameters:

• Pair (required): Trading pair like BTC/USDT
• Days (optional): Historical days to download (default: 30)
• Timeframe (optional): Candle size — 5m, 1h, 4h, 1d (default: 5m)
• --erase (optional): Clear cached data before downloading (use when extending range)

Why --erase? Kraken enforces data continuity. When extending a download window (e.g., 30→90 days), you must erase existing data first to prevent overlaps.

ftback — Run Backtest

Run backtesting with automatic date calculations and optional pair filter.

Usage:

ftback "MyStrategy" 60 5m                      # Test MyStrategy for 60 days
ftback "MyStrategy" 90 1h "BTC/USDT"          # Test on specific pair
ftback                                         # Use defaults: SampleStrategy, 30 days, 5m

Bot Control

Start, stop, restart, and monitor services:

ftstart    # Start services
ftstop     # Stop services
ftrestart  # Restart services
ftlogs     # Stream logs (-f flag for follow)
ftstatus   # Service status + recent logs
ftlist     # View downloaded data inventory
ftui       # Open UI (auto-detect browser)

References

• See references/bash-zsh-aliases.md for full function implementations
• See references/windows-equivalents.md for PowerShell and Command Prompt versions