You can specify a different configuration file used by the bot with the -c/–config command-line option.

配置选项的优先级 ¶
所有配置选项的优先级顺序如下:
命令行参数(CLI arguments)
覆盖其他所有配置选项,优先级最高。
环境变量(Environment Variables)
优先级次之,覆盖配置文件和策略中的对应选项。
配置文件(Configuration files)
按加载顺序依次生效,最后加载的文件优先级最高。
覆盖策略中的配置选项。
策略配置(Strategy configurations)
仅在未通过配置文件、环境变量或命令行参数设置时生效。
此类选项在下方表格中会标记为 “Strategy Override(策略覆盖)”。
优先级总结(从高到低)
命令行参数 > 环境变量 > 配置文件(后加载的文件) > 配置文件(先加载的文件) > 策略配置
这一规则确保了灵活的配置方式:临时调试可使用命令行参数,敏感信息可通过环境变量注入,基础配置可放在文件中管理,而策略本身仅作为默认配置的补充。
Parameters table¶
Mandatory parameters are marked as Required, which means that they are required to be set in one of the possible ways.
配置参数说明
| 参数分类 | 参数名 | 描述 | 数据类型 | 默认值/特殊说明 | 策略覆盖(Strategy Override) |
|---|---|---|---|---|---|
| 基础交易设置 | max_open_trades |
必需。机器人允许的最大未平仓交易数量。每个交易对仅允许一个未平仓交易,因此交易对列表长度也可能构成限制。设为-1则忽略(即理论上无限制,受交易对数量限制)。 | 正整数或-1 | - | 是 |
stake_currency |
必需。用于交易的加密货币。 | 字符串 | - | 否 | |
stake_amount |
必需。机器人每笔交易的投入金额。设为"unlimited"则使用所有可用余额。 | 正浮点数或"unlimited" | - | 否 | |
tradable_balance_ratio |
机器人允许用于交易的账户总余额比例。 | 0.1-1.0之间的正浮点数 | 默认0.99(99%) | 否 | |
available_capital |
机器人的初始可用资金。在同一交易所账户运行多个机器人时有用。 | 正浮点数 | - | 否 | |
amend_last_stake_amount |
必要时使用减少的最后一笔投入金额。 | 布尔值 | 默认false | 否 | |
last_stake_amount_min_ratio |
定义最后一笔投入金额调整后必须保留的最小比例(仅当amend_last_stake_amount为true时生效)。 |
浮点数(比例) | 默认0.5 | 否 | |
amount_reserve_percent |
按最小交易对投入金额保留部分资金。计算最小投入金额时,机器人会保留amount_reserve_percent + stoploss的资金,避免交易被拒绝。 |
正浮点数(比例) | 默认0.05(5%) | 否 | |
| 时间与周期 | timeframe |
交易时间周期(如1m、5m、15m、30m、1h等)。通常在策略中指定。 | 字符串 | - | 是 |
process_only_new_candles |
仅在新K线到达时处理指标。若为false,每次循环都会计算指标(可能增加系统负载,但适用于依赖tick数据的策略)。 | 布尔值 | 默认true | 是 | |
| 止盈止损 | minimal_roi |
必需。机器人用于平仓的回报率阈值。 | 字典 | - | 是 |
stoploss |
必需。止损比例值。详情参见止损文档。 | 浮点数(比例) | - | 是 | |
trailing_stop |
启用追踪止损(基于配置或策略中的止损值)。详情参见止损文档。 | 布尔值 | - | 是 | |
trailing_stop_positive |
达到盈利后调整止损。详情参见止损文档。 | 浮点数 | - | 是 | |
trailing_stop_positive_offset |
应用trailing_stop_positive的偏移量(正数百分比)。详情参见止损文档。 |
浮点数 | 默认0.0(无偏移) | 是 | |
trailing_only_offset_is_reached |
仅当达到偏移量时应用追踪止损。详情参见止损文档。 | 布尔值 | 默认false | 是 | |
| 费用与模式 | fee |
回测/模拟交易中使用的手续费。通常无需配置(默认使用交易所手续费)。以比例表示(如0.001=0.1%),每笔交易买入和卖出时各收取一次。 | 浮点数(比例) | - | 否 |
futures_funding_rate |
当交易所无历史资金费率时使用的用户指定值(不覆盖真实历史费率)。除非测试特定币种,否则建议设为0。 | 浮点数 | 默认None | 否 | |
trading_mode |
指定交易模式:常规交易、杠杆交易或合约交易。详情参见杠杆文档。 | 字符串 | 默认"spot"(现货) | 否 | |
margin_mode |
杠杆交易时,指定保证金是共享(cross)还是逐笔隔离(isolated)。详情参见杠杆文档。 | 字符串 | - | 否 | |
liquidation_buffer |
平仓价格与止损价之间的安全缓冲比例,防止仓位触及平仓价。详情参见杠杆文档。 | 浮点数 | 默认0.05 | 否 | |
| 未成交订单超时 | unfilledtimeout.entry |
必需。机器人等待未成交入场订单完成的时间(分钟或秒),超时后取消订单。 | 整数 | - | 是 |
unfilledtimeout.exit |
必需。机器人等待未成交出场订单完成的时间(分钟或秒),超时后取消并按当前价格重新下单(只要有信号)。 | 整数 | - | 是 | |
unfilledtimeout.unit |
unfilledtimeout的单位。注意:若设为"seconds",internals.process_throttle_secs必须小于等于超时时间。 |
字符串(“minutes"或"seconds”) | 默认"minutes" | 是 | |
unfilledtimeout.exit_timeout_count |
出场订单允许超时的次数。达到次数后触发紧急平仓。0表示无限次取消。 | 整数 | 默认0 | 是 | |
| 定价设置 | entry_pricing.price_side |
选择价差的方向以获取入场价格。详情参见下方说明。 | 字符串(“ask”、“bid”、“same"或"other”) | 默认"same" | 否 |
entry_pricing.price_last_balance |
必需。插值买入价格。详情参见下方说明。 | - | - | 否 | |
entry_pricing.use_order_book |
启用使用订单簿价格入场。 | 布尔值 | 默认true | 否 | |
entry_pricing.order_book_top |
入场时使用订单簿"price_side"的前N档价格。例如,值为2则使用第2档价格。 | 正整数 | 默认1 | 否 | |
entry_pricing.check_depth_of_market.enabled |
若订单簿中买卖订单差值达到阈值则不入场(检查市场深度)。 | 布尔值 | 默认false | 否 | |
entry_pricing.check_depth_of_market.bids_to_ask_delta |
订单簿中买单与卖单的差值比例。小于1表示卖单量更大,大于1表示买单量更大。 | 浮点数(比例) | 默认0 | 否 | |
exit_pricing.price_side |
选择价差的方向以获取出场价格。详情参见下方说明。 | 字符串(“ask”、“bid”、“same"或"other”) | 默认"same" | 否 | |
exit_pricing.price_last_balance |
插值卖出价格。详情参见下方说明。 | - | - | 否 | |
exit_pricing.use_order_book |
启用使用订单簿价格出场。 | 布尔值 | 默认true | 否 | |
exit_pricing.order_book_top |
出场时使用订单簿"price_side"的前N档价格。 | 正整数 | 默认1 | 否 | |
custom_price_max_distance_ratio |
配置当前价格与自定义入场/出场价格的最大距离比例。 | 正浮点数 | 默认0.02(2%) | 否 | |
| 订单/信号处理 | use_exit_signal |
除minimal_roi外,使用策略生成的出场信号(“exit_long”/“exit_short”)。 |
布尔值 | 默认true | 是 |
exit_profit_only |
等待达到exit_profit_offset后才执行出场决策。 |
布尔值 | 默认false | 是 | |
exit_profit_offset |
仅当exit_profit_only=True时,出场信号在该值以上才生效。 |
浮点数(比例) | 默认0.0 | 是 | |
ignore_roi_if_entry_signal |
若入场信号仍有效,则忽略止盈(优先级高于minimal_roi |

最低0.47元/天 解锁文章
3966

被折叠的 条评论
为什么被折叠?



