初识 Freqtrade

Freqtrade 是一个免费且开源的加密货币交易机器人，专为自动化交易设计。它支持多种交易策略、回测、超参数优化、数据下载与分析等功能，帮助用户在加密货币市场中构建、测试和部署自动化交易系统。用户可以通过命令行接口（CLI）执行各种操作，如创建配置、下载行情数据、运行回测、优化策略参数等，无需编写复杂的代码即可开始交易实验。

Freqtrade 虽然功能强大，但官方明确建议初学者在使用前具备基础的编程能力和 Python 知识。它不是开箱即用的‘一键盈利’工具，而是需要用户理解策略逻辑、参数含义和风险机制的开发平台。

使用前必须注意以下几点：

• 仅用于教育目的：官方声明该软件仅供学习和研究，不保证盈利，用户需自行承担所有交易风险。
• 必须先用 Dry-run 模式测试：在投入真实资金前，务必在模拟环境中运行足够长时间，观察策略表现、回撤和交易频率。
• 阅读源代码：强烈建议阅读策略和核心模块的源码，理解其工作原理，避免盲目复制他人策略。
• 不要投入无法承受损失的资金：加密货币交易波动剧烈，即使是经过优化的策略也可能出现连续亏损。

初学者应从官方示例策略入手，逐步修改参数，观察回测结果，再逐步过渡到实盘。

Freqtrade 提供以下核心功能：

• 策略开发：使用 Python 和 pandas 库编写自定义交易策略，官方提供示例策略供参考。
• 市场数据下载：可从支持的交易所下载历史行情数据，用于后续回测和分析。
• 回测：在历史数据上测试你的策略表现，评估其盈利能力与风险。
• 超参数优化（Hyperopt）：利用机器学习方法自动寻找最优的买入、卖出、止盈（ROI）、止损和追踪止损参数。
• 市场选择：可手动设定交易币对列表，或根据交易量和价格自动筛选，也可明确黑名单排除不感兴趣的币对。
• 实盘运行：支持两种模式：模拟交易（Dry-run，使用虚拟资金）和真实交易（Live-trade，使用真实资金）。
• 远程监控：通过 Telegram 或 WebUI 实时查看盈亏、每日摘要、当前持仓、交易记录等。
• 数据分析：可对回测结果或实盘交易历史（存储于 SQL 数据库）进行深入分析，包括自动生成标准图表和导入交互式环境（如 Jupyter）进一步处理。

这些功能共同构成一个完整的自动化交易开发与部署闭环。

要开始使用 Freqtrade，请按以下步骤操作：

1. 选择安装方式：推荐使用 Docker 安装（参见 docker_quickstart.md），因为它能自动处理所有依赖，避免环境配置问题；若选择手动安装，请参考 installation.md。
2. 创建配置文件：使用 freqtrade new-config 命令生成基础配置文件，配置交易所 API 密钥、交易币对、风险参数等。
3. 下载历史数据：使用 freqtrade download-data 命令获取你计划交易的币对的历史 K 线数据。
4. 选择或编写策略：从官方策略仓库（freqtrade-strategies）中选择一个示例策略，或使用 freqtrade new-strategy 创建新策略。
5. 进行回测：使用 freqtrade backtesting 在历史数据上测试策略表现。
6. 优化参数：使用 freqtrade hyperopt 自动寻找最优参数组合。
7. 模拟运行（Dry-run）：在不使用真实资金的情况下运行策略，观察实际交易行为。
8. 启用监控：启动 Telegram 机器人或 WebUI（通过 freqtrade webserver）来实时监控交易状态。
9. 谨慎实盘：当 Dry-run 结果稳定且符合预期后，再考虑切换为 Live-trade 模式。

建议从官方文档的《快速开始》（docker_quickstart.md）入手，逐步完成上述流程。

Freqtrade 的命令行结构采用分层设计：主命令 freqtrade 后必须跟随一个子命令（如 backtesting、download-data），然后可附加多个选项（如 --strategy、--timeframe）。例如：freqtrade backtesting --strategy MyStrategy --timeframe 1h --timerange 20230101-。子命令决定执行的功能，选项用于配置该功能的参数。所有命令都支持 -h 查看帮助，-V 显示版本，结构清晰，便于自动化脚本调用和批量操作。

要查看 Freqtrade 的版本号，可以在命令行中使用 -V 或 --version 参数。例如，运行 freqtrade -V 或 freqtrade --version，程序将输出当前安装的 Freqtrade 版本信息。这个命令不执行任何其他操作，仅用于确认你所使用的软件版本，便于排查兼容性问题或确认是否为最新版。

要查看 Freqtrade 支持的所有命令，只需在终端中运行 freqtrade 命令而不带任何参数。这将显示主帮助信息，列出所有可用的子命令，例如 trade、backtesting、download-data、hyperopt 等。每个子命令都对应一项特定功能，如交易执行、数据下载、策略优化等。这些命令构成了 Freqtrade 的核心操作体系，用户可以根据需要选择对应模块进行操作。

要获取某个命令的详细帮助信息，可以在命令后添加 -h 或 --help 参数。例如，运行 freqtrade backtesting -h 会显示该命令支持的所有选项、参数说明、默认值和使用示例。这种方式适用于任何子命令，如 freqtrade hyperopt --help 或 freqtrade plot-dataframe -h。帮助信息包含每个参数的用途和格式，是学习和正确使用 Freqtrade 各模块的最直接方式。