← Back to Skills Marketplace
Freqtrade Tools
by
Deonte Cooper
· GitHub ↗
· v1.0.3
· MIT-0
240
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install freqtrade-tools
Description
Shell aliases and helper commands for Freqtrade (cryptocurrency trading bot) that speed up common tasks. Use when setting up Freqtrade shortcuts, downloading...
README (SKILL.md)
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
| Command | Purpose |
|---|---|
ftdata |
Download market data from Kraken |
ftback |
Run backtesting on a strategy |
ftstart |
Start docker-compose services |
ftstop |
Stop docker-compose services |
ftrestart |
Restart docker-compose services |
ftlogs |
Stream live logs from bot |
ftstatus |
Check service status + tail logs |
ftlist |
List downloaded data files |
ftui |
Open bot UI in browser |
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.mdfor full function implementations - See
references/windows-equivalents.mdfor PowerShell and Command Prompt versions
Usage Guidance
This skill appears coherent and implements exactly what it claims: convenient shell/PowerShell/cmd helpers that invoke docker-compose for Freqtrade. Before installing, copy the functions manually (or review them line-by-line) and back up your ~/.bashrc, ~/.zshrc, $PROFILE, or any startup files you edit. Confirm you have the docker and docker-compose binaries you expect (some systems use the Docker CLI 'docker compose' plugin instead of a separate docker-compose binary). Inspect the project’s docker-compose.yml and the Freqtrade Docker image you run—those determine network access, mounted volumes, and what code actually runs inside containers. Test commands with safe parameters first (e.g., short date ranges, non-destructive flags) and avoid running them with elevated privileges. If you rely on an exchange API key in your Freqtrade setup, keep those credentials out of these helper functions; the skill does not request or store secrets itself.
Capability Analysis
Type: OpenClaw Skill
Name: freqtrade-tools
Version: 1.0.3
The freqtrade-tools skill bundle provides legitimate shell aliases and helper functions for managing Freqtrade trading bots via Docker. The scripts (bash-zsh-aliases.md and windows-equivalents.md) include proactive security measures such as regex-based input validation to prevent shell injection. There is no evidence of data exfiltration, unauthorized network calls, or malicious persistence mechanisms; all commands are clearly aligned with the stated purpose of simplifying Freqtrade workflows.
Capability Assessment
Purpose & Capability
The name/description (Freqtrade helper aliases) align with the required binaries (docker, docker-compose) and the provided shell/PowerShell/cmd functions, which call docker-compose to run freqtrade tasks like download-data and backtesting.
Instruction Scope
SKILL.md and the reference files only instruct users to copy functions into shell startup files or run the functions; the functions execute docker-compose, open a localhost URL, list local data directories, and validate inputs. They do not read or exfiltrate unrelated files, ask for environment secrets, or contact external endpoints beyond the exchange parameter passed to the freqtrade command (the code uses the --exchange kraken flag but does not reach out itself).
Install Mechanism
No install spec or remote downloads are present; this is instruction-only. Nothing is written to disk by the skill itself—users manually copy definitions into their shell profiles.
Credentials
The skill requests no environment variables or credentials. The use of docker/docker-compose is proportionate to running Freqtrade containerized tasks. No unrelated secrets or config paths are requested.
Persistence & Privilege
Persistence is achieved only if the user copies the functions into their shell/profile; the skill does not auto-install or set always:true. Users should be aware that adding functions to rc/profile is a persistent change to their shell environment.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install freqtrade-tools - After installation, invoke the skill by name or use
/freqtrade-tools - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
Security fix: sanitize shell function inputs to prevent command injection (quote all vars, validate PAIR/STRATEGY/TIMEFRAME/PAIRS with regex, replace raw ERASE flag with safe boolean)
v1.0.2
Fix: Clarified crypto-exclusive scope in description
v1.0.1
Fix: Added docker-compose to required bins (all commands use docker-compose, not just docker)
v1.0.0
Initial release — ftdata, ftback, bot control aliases for bash/zsh and PowerShell/Windows. Includes single-pair warning and --erase documentation.
Metadata
Frequently Asked Questions
What is Freqtrade Tools?
Shell aliases and helper commands for Freqtrade (cryptocurrency trading bot) that speed up common tasks. Use when setting up Freqtrade shortcuts, downloading... It is an AI Agent Skill for Claude Code / OpenClaw, with 240 downloads so far.
How do I install Freqtrade Tools?
Run "/install freqtrade-tools" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Freqtrade Tools free?
Yes, Freqtrade Tools is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Freqtrade Tools support?
Freqtrade Tools is cross-platform and runs anywhere OpenClaw / Claude Code is available (linux, darwin, win32).
Who created Freqtrade Tools?
It is built and maintained by Deonte Cooper (@djc00p); the current version is v1.0.3.
More Skills