第12篇| Freqtrade 交易所接入全解:API、WebSocket、限频配置详解

Freqtrade 通过 config.json 中的 exchangeccxt_config 配置项与交易所建立连接。这一步是策略执行的前提,涉及 API 密钥、WebSocket、频率控制等多个关键参数。


想学量化交易?

点击访问:www.itrade.icu 这里有 Freqtrade 基础教程策略实战指标解析 等丰富内容,助你轻松掌握量化交易技巧!


exchange 配置项详解

"exchange": {
  "name": "binance",               // 交易所名称,如 binance、bybit、okx 等
  "key": "your_api_key",           // 你的 API Key
  "secret": "your_api_secret",     // API 密钥
  "password": "your_password",     // 某些交易所(如 OKX)必填,其他可省略
  "ccxt_config": { ... },          // CCXT 扩展配置(详见下节)
  "pair_whitelist": [ "BTC/USDT" ],// 可交易的币对列表
  "pair_blacklist": [ "*/BNB" ]    // 屏蔽的币对(可选)
}
参数说明
字段名描述
name交易所英文名称(必须支持 CCXT)
key交易所提供的 API Key,用于交易权限
secret与 key 配套的密钥
password第三项认证,适用于 OKX、bitget 等(非必填)
pair_whitelist白名单,只允许交易列表内币对
pair_blacklist黑名单,排除部分币对(如低流动性或不稳定币)
使用建议
  • API 权限需包含 读取+交易,否则无法实盘下单;
  • 为不同策略使用独立 API 密钥,便于权限隔离和风险控制;
  • 请不要将 config.json 上传到 GitHub 或其他公共平台!

️ ccxt_config — 高级连接控制项

ccxt_configFreqtrade 调用 CCXT 库时的配置项,可对数据请求频率、实时性、市场类型等进行优化。

"exchange": {
    "ccxt_config": {
        "enableRateLimit": true,          //  开启限速 防止IP被封
    },
    "enable_ws": true,                //  是否启用 WebSocket 连接,提升数据实时性
    "markets_refresh_interval": 60    //  交易对列表刷新间隔,单位为秒
}

️ enableRateLimit — 启用请求限频(推荐开启)

enableRateLimit — 启用请求限频(推荐开启)

"exchange": {
    "enableRateLimit": true
}
  • 控制是否让 Freqtrade 自动遵守交易所的 API 速率限制;
  • 防止触发交易所封 IP / 禁止交易的风控机制;
  • 强烈建议开启!

enable_ws — 启用 WebSocket 实时数据

"exchange": {
    "enable_ws": false,
},
  • 启用后,Freqtrade 会通过 WebSocket 获取实时行情和订单状态;
  • 比 REST API 更快、延迟更低,适合高频策略;
  • 需交易所支持,且部分交易所需额外权限(如 OKX);
  • 若策略无高频需求,也可关闭。

markets_refresh_interval — 市场信息刷新间隔

"exchange": {
    "markets_refresh_interval": 60    //  交易对列表刷新间隔,单位为秒
}
  • 单位为秒;
  • 控制多久重新拉取一次交易对数据;
  • 默认 60 秒,足够稳定;
  • 设置太低可能导致 API 频率过高被限流。

检查配置是否生效

配置完成后,可使用如下命令测试交易所是否连接成功:

freqtrade list-markets --config user_data/config.json

成功返回交易对列表,说明 API Key、市场类型配置正常 如果提示 authentication error403,请检查:

  • 是否填写正确的 API Key / Secret
  • 是否赋予交易权限
  • 是否启用了两步验证限制了 API 使用

转存失败,建议直接上传图片文件

推荐配置组合

"exchange": {
    "name": "binance",
    "key": "your_api_key",
    "secret": "your_api_secret",
    "enable_ws": true,
    "markets_refresh_interval": 60,
    "ccxt_config": {
        "enableRateLimit": true,
        "options": {
            "defaultType": "spot"
        }
    }
}

小结清单

参数名功能描述建议设置
exchange.name连接交易所名binance, bybit
exchange.key/secretAPI 授权信息必填
enableRateLimit是否限制请求频率,防止被风控true
enable_ws是否启用 WebSocket 实时数据true(如支持)
markets_refresh_interval多久刷新一次币对信息一般设置为 60
本站提供的所有下载资源均来自互联网,仅提供学习交流使用,版权归原作者所有。如需商业使用,请联系原作者获得授权。 如您发现有涉嫌侵权的内容,请联系我们 邮箱:[email protected]