Skip to content
All library documents

Freqtrade V2-to-V3 Strategy Migration for Long and Short Trades

Article Freqtrade docs

Summary

This document outlines interface and configuration changes for upgrading Freqtrade strategies from version 2 to version 3, especially when adding short trades or leverage. It maps older buy and sell signals to entry and exit terminology, including renamed strategy methods, dataframe columns, trade fields, callbacks, order settings, notifications, and helper functions. It also notes new side arguments and the leverage callback, and recommends setting the strategy interface version to 3.

The examples show how entry and exit signal methods and several custom callbacks change. The document also describes updated FreqAI data-cleaning and normalization pipelines, including pipeline definition, fitting, transformation, and label inversion. It is a migration reference rather than a trading method, and contains no performance evidence. Some material is duplicated or truncated, and the final FreqAI excerpt appears incomplete, so users should check the version-specific documentation before applying changes.

Key ideas

  • Version 3 replaces buy and sell terminology with entry and exit terminology across strategy signals and settings.
  • Strategies using short trades need to account for new trade properties and callback arguments.
  • Several callback names and trade fields have changed, including successful-entry counts and exit reasons.
  • Stop-loss helpers now need the trade direction when calculating values for short positions.
  • FreqAI data preparation now uses configurable feature and label pipelines for transformations.

Tags

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