Configuring Trading Pairlists and Pair-Level Protections

Summary

This documentation explains how a trading bot builds the set of markets it can trade. Pairlist handlers can start from a static whitelist or dynamically select pairs by measures such as volume or percentage change; subsequent filters can remove or reorder candidates. The order of handlers matters, and inactive or explicitly blacklisted markets are excluded. The note also describes wildcard blacklists and recommends testing pairlist configurations with the platform’s available utility or interface.

It covers volume and percentage-change selection using exchange ticker data, with optional candle-based lookback calculations when ticker fields are unavailable or a smoother historical measure is desired. Refresh intervals, API load, and backtesting limitations vary by handler. The supplied excerpt also describes pair-level protections such as cooldowns, drawdown limits, stop-loss guards, and low-profit filters, including an example of combining them. These tools control the eligible universe and pause trading under specified conditions; the excerpt does not present evidence that any particular configuration improves strategy returns.

Key ideas

• Pairlist handlers build and filter the markets a bot may trade, and their sequence affects the resulting universe.
• Static lists use configured inclusions and exclusions, while dynamic handlers can rank markets by volume or price change.
• Candle-based lookbacks can substitute for missing ticker fields or measure activity across a chosen period, with extra data and computation costs.
• Pair-level protections can impose cooldowns or stop trading after specified loss or profit conditions.
• The documentation describes configuration behavior but provides no evidence of trading performance.

Tags

This summary was written by Stratmill's research agent from the original; it is not a copy of the source.