Freqtrade US Setup Guide
⚠️ Security First: This guide emphasizes legal, secure setup for US users. Never use VPNs to bypass exchange geo-restrictions — it violates ToS, risks fund freezes, and may be illegal.
1-Minute Intro
Freqtrade (the Python bot) is legal in the US. The catch: many exchanges block US traders. Use Kraken — it's stable, US-compliant, and officially supported.
Quick Start
Step 1: Generate Kraken API Keys
- 1. Log into Kraken → Settings → API
- Create a new key with these permissions exactly:
- ✅
Funds: Query
- ✅
Orders: Query open orders & trades
- ✅
Orders: Query closed orders & trades
- ✅
Orders: Create & modify orders
- ✅
Orders: Cancel & close orders
- ❌
NEVER enable Withdraw (critical security risk)
Step 2: Docker Setup
CODEBLOCK0
Step 3: Secure Your Keys
Freqtrade uses a specific double-underscore env var pattern (FREQTRADE__SECTION__KEY) that overrides config values at runtime. Create a .env file in your Freqtrade directory:
CODEBLOCK1
Add to .gitignore immediately:
CODEBLOCK2
In user_data/config.json, leave the exchange key and secret as empty strings — Freqtrade will populate them from the env vars automatically:
CODEBLOCK3
Step 4: Validate & Test
CODEBLOCK4
Before Going Live
- 1. Dry-run minimum: 1-2 weeks of paper trading
- Backtest: Verify your strategy works historically
- Start small: Go live with a conservative stake amount
- Monitor: Watch closely for first 24-48 hours
When to Read References
- - exchange-comparison.md → Comparing Kraken, Binance.US, Coinbase
- security-checklist.md → API key management, fund protection, common mistakes
Disclaimer: Freqtrade is open-source, experimental software. Trading involves financial risk. This guide is provided as-is with no guarantees. Use at your own risk.
Questions? See references/ or check Freqtrade's official docs at https://www.freqtrade.io
Freqtrade 美国用户设置指南
⚠️ 安全第一： 本指南强调美国用户的合法、安全设置。切勿使用VPN绕过交易所的地域限制——这违反服务条款，可能导致资金冻结，甚至违法。
1分钟简介
Freqtrade（Python交易机器人）在美国合法。问题在于：许多交易所屏蔽美国交易者。使用Kraken——它稳定、合规美国法规，且官方支持。
快速开始
第一步：生成Kraken API密钥
- 1. 登录Kraken → 设置 → API
- 创建一个新密钥，精确设置以下权限：
- ✅
资金：查询
- ✅
订单：查询未结订单与交易
- ✅
订单：查询已结订单与交易
- ✅
订单：创建与修改订单
- ✅
订单：取消与关闭订单
- ❌
切勿启用提现（严重安全风险）
第二步：Docker设置
bash
克隆Freqtrade
git clone https://github.com/freqtrade/freqtrade.git
cd freqtrade
创建配置（交互式向导）
docker-compose run --rm freqtrade new-config --config /freqtrade/user_data/config.json
当提示时：
- 交易所：kraken
- 质押货币：USDT（或USD）
- 模拟交易：是（始终从纸面交易开始！）
第三步：保护您的密钥
Freqtrade使用特定的双下划线环境变量模式（FREQTRADESECTIONKEY），可在运行时覆盖配置值。在Freqtrade目录中创建.env文件：
bash
Kraken API（必需）
FREQTRADE
EXCHANGEKEY=您的kraken-api密钥
FREQTRADE
EXCHANGESECRET=您的kraken密钥
Web界面（可选）
FREQTRADE
API_SERVERUSERNAME=您的用户名
FREQTRADE
API_SERVERPASSWORD=您的密码
FREQTRADE
API_SERVERJWT
SECRETKEY=您的jwt密钥
FREQTRADE
APISERVERWS_TOKEN=您的ws令牌
Telegram（可选——如不使用则留空）
注意：通过环境变量设置多机器人Telegram尚未验证。
如遇问题，请查阅Freqtrade文档了解具体设置。
切勿将敏感令牌硬编码到可能提交至git的文件中。
FREQTRADE
TELEGRAMTOKEN=
FREQTRADE
TELEGRAMCHAT_ID=
立即添加到.gitignore：
bash
echo .env >> .gitignore
在user_data/config.json中，将交易所密钥和密钥留为空字符串——Freqtrade会自动从环境变量中填充：
json
{
exchange: {
name: kraken,
key: ,
secret: ,
ccxt_config: {},
ccxtasyncconfig: {}
},
stake_currency: USDT,
dry_run: true,
maxopentrades: 3
}
第四步：验证与测试
bash
下载历史数据
docker-compose run --rm freqtrade download-data \
--pairs BTC/USDT ETH/USDT \
--timeframe 5m \
--timerange 20240101-
上线前运行模拟交易1-2周
docker-compose up
上线前准备
- 1. 模拟交易最低时长： 1-2周纸面交易
- 回测： 验证策略在历史数据中的表现
- 从小开始： 以保守的质押金额上线
- 监控： 前24-48小时密切关注
何时查阅参考资料
- - exchange-comparison.md → 比较Kraken、Binance.US、Coinbase
- security-checklist.md → API密钥管理、资金保护、常见错误
免责声明： Freqtrade是开源实验性软件。交易涉及财务风险。本指南按原样提供，不提供任何保证。使用风险自负。
有问题？ 请参阅参考资料/或查看Freqtrade官方文档：https://www.freqtrade.io
