{"skill":{"slug":"freqtrade-tools","displayName":"Freqtrade Tools","summary":"Shell aliases and helper commands for Freqtrade (cryptocurrency trading bot) that speed up common tasks. Use when setting up Freqtrade shortcuts, downloading...","description":"---\nname: freqtrade-tools\ndescription: \"Shell aliases and helper commands for Freqtrade (cryptocurrency trading bot) that speed up common tasks. Use when setting up Freqtrade shortcuts, downloading market data quickly, running backtests from the command line, or controlling the bot. ⚠️ Bot control commands (ftstart/ftstop/ftrestart) require confirmation when connected to live trading. Covers bash/zsh (Linux/macOS) and PowerShell/Command Prompt (Windows). Trigger phrases: freqtrade aliases, freqtrade shortcuts, ftdata, ftback, freqtrade commands, freqtrade windows.\"\nmetadata: {\"clawdbot\":{\"emoji\":\"⚡\",\"requires\":{\"bins\":[\"docker\",\"docker-compose\"]},\"os\":[\"linux\",\"darwin\",\"win32\"]}}\n---\n\n# Freqtrade Tools\n\n> ⚠️ **Live Trading Warning:** Before using `ftstart`, `ftstop`, or `ftrestart`, confirm whether Freqtrade is in dry-run or live-trading mode. These commands control real trading services. Verify your config before starting the bot.\n\nShell aliases and helper commands for faster Freqtrade workflows across Linux, macOS, and Windows.\n\n## Installation\n\n**Bash/Zsh:** Copy functions from `references/bash-zsh-aliases.md` into `~/.bashrc` (Linux) or `~/.zshrc` (macOS), then `source ~/.bashrc`.\n\n**PowerShell:** Copy functions from `references/windows-equivalents.md` into your `$PROFILE` file.\n\n## Core Commands\n\n| Command | Purpose |\n|---------|---------|\n| `ftdata` | Download market data from Kraken |\n| `ftback` | Run backtesting on a strategy |\n| `ftstart` | Start docker-compose services |\n| `ftstop` | Stop docker-compose services |\n| `ftrestart` | Restart docker-compose services |\n| `ftlogs` | Stream live logs from bot |\n| `ftstatus` | Check service status + tail logs |\n| `ftlist` | List downloaded data files |\n| `ftui` | Open bot UI in browser |\n\n## ftdata — Download Data\n\nDownload market data with automatic date range calculation.\n\n**Usage:**\n```bash\nftdata \"BTC/USDT\" 90 5m           # Download 90 days of 5-min BTC/USDT data\nftdata \"ETH/USDT\" 30 1h           # 30 days of 1-hour ETH/USDT\nftdata \"SOL/USDT\"                 # Use defaults: 30 days, 5-min\nftdata \"XRP/USDT\" 365 5m --erase  # Download 1 year, erase old data first\n```\n\n**Parameters:**\n- Pair (required): Trading pair like `BTC/USDT`\n- Days (optional): Historical days to download (default: 30)\n- Timeframe (optional): Candle size — `5m`, `1h`, `4h`, `1d` (default: 5m)\n- --erase (optional): Clear cached data before downloading (use when extending range)\n\n**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.\n\n## ftback — Run Backtest\n\nRun backtesting with automatic date calculations and optional pair filter.\n\n**Usage:**\n```bash\nftback \"MyStrategy\" 60 5m                      # Test MyStrategy for 60 days\nftback \"MyStrategy\" 90 1h \"BTC/USDT\"          # Test on specific pair\nftback                                         # Use defaults: SampleStrategy, 30 days, 5m\n```\n\n## Bot Control\n\nStart, stop, restart, and monitor services:\n```bash\nftstart    # Start services\nftstop     # Stop services\nftrestart  # Restart services\nftlogs     # Stream logs (-f flag for follow)\nftstatus   # Service status + recent logs\nftlist     # View downloaded data inventory\nftui       # Open UI (auto-detect browser)\n```\n\n## Safety\n\n### Before Using Bot Control Commands\n\n- **Check trading mode:** Confirm `dry_run: true` in your config unless you intend live trading\n- **ftstart confirmation:** When `dry_run: false`, ask for explicit human confirmation before starting\n- **ftstop/ftrestart:** Always notify the human before stopping or restarting services\n\n## References\n\n- See `references/bash-zsh-aliases.md` for full function implementations\n- See `references/windows-equivalents.md` for PowerShell and Command Prompt versions\n","topics":["Cryptocurrency","Prompt","Trading"],"tags":{"latest":"1.0.4"},"stats":{"comments":0,"downloads":791,"installsAllTime":29,"installsCurrent":0,"stars":0,"versions":5},"createdAt":1774040766769,"updatedAt":1778492072793},"latestVersion":{"version":"1.0.4","createdAt":1778030008826,"changelog":"Security: add live trading warning box, Safety section with dry-run vs live-trade confirmation guidance for bot control commands.","license":"MIT-0"},"metadata":{"setup":[],"os":["linux","darwin","win32"],"systems":null},"owner":{"handle":"djc00p","userId":"s17akx17qd32yxnr1065qq0kdd83h2c3","displayName":"Deonte Cooper","image":"https://avatars.githubusercontent.com/u/45864171?v=4"},"moderation":null}