Changed

• Unified return representation system: Say goodbye to inconsistent return formats across your analysis! Return-based criteria now use a unified ReturnRepresentation system that lets you choose how returns are displayed—whether you prefer multiplicative (1.12 for +12%), decimal (0.12), percentage (12.0), or logarithmic formats. Set it once globally via ReturnRepresentationPolicy or customize per-criterion. No more mental math converting between formats—Ta4j handles it all automatically. Legacy addBase constructors are deprecated in favor of the more expressive ReturnRepresentation enum.

• Ratio criteria now speak your language: All ratio-producing criteria now support ReturnRepresentation, so you can format outputs consistently across your entire analysis pipeline. Whether you're comparing strategies, measuring risk, or tracking performance metrics, everything uses the same format. Updated criteria include:

  • VersusEnterAndHoldCriterion: Strategy vs. buy-and-hold comparison (e.g., 0.5 = 50% better, displayed as 0.5, 50.0, or 1.5 depending on your preference)
  • ReturnOverMaxDrawdownCriterion: Reward-to-risk ratio (e.g., 2.0 = return is 2x drawdown)
  • PositionsRatioCriterion: Win/loss percentage (e.g., 0.5 = 50% winning)
  • InPositionPercentageCriterion: Time in market (e.g., 0.5 = 50% of time)
  • CommissionsImpactPercentageCriterion: Trading cost impact (e.g., 0.05 = 5% impact)
  • AbstractProfitLossRatioCriterion (and subclasses): Profit-to-loss ratio (e.g., 2.0 = profit is 2x loss)

  All ratio criteria default to ReturnRepresentation.DECIMAL (the conventional format for ratios), but you can override per-criterion or globally. Perfect for dashboards, reports, or when you need to match external data formats. See each criterion's javadoc for detailed examples.

• Improved return representation tooling: Added factory-level exponential support to avoid premature double conversions, expanded representation parsing to accept flexible names, and aligned VaR/ES/average-return empty-record behaviour across representations.

• High-precision DecimalNum exponentials: DecimalNumFactory#exp now evaluates exponentials using the configured MathContext instead of delegating to {@code Math.exp}, preventing accidental loss of precision for high-precision numeric workflows.

• Simplified Returns class implementation: Removed unnecessary formatOnAccess complexity from Returns class, inlined trivial formatReturn() wrapper method, and improved documentation clarity. The class now has a cleaner separation of concerns with better cross-references between Returns, ReturnRepresentation, and ReturnRepresentationPolicy.

Breaking

• EMA indicators now return NaN during unstable period: EMAIndicator, MMAIndicator, and all indicators extending AbstractEMAIndicator now return NaN for indices within the unstable period (indices < beginIndex + getCountOfUnstableBars()). Previously, these indicators would return calculated values during the unstable period. Action required: Update any code that accesses EMA indicator values during the unstable period to handle NaN values appropriately, or wait until after the unstable period before reading values.
• DifferencePercentageIndicator deprecated: DifferencePercentageIndicator has been deprecated in favor of PercentageChangeIndicator, which now provides all the same functionality plus additional features. Action required: Migrate to PercentageChangeIndicator using the migration examples in the deprecation javadoc.

Added

• Added TrueStrengthIndexIndicator, SchaffTrendCycleIndicator, and ConnorsRSIIndicator to expand oscillator coverage
• Added PercentRankIndicator helper indicator to calculate the percentile rank of a value within a rolling window
• Added DifferenceIndicator helper indicator to calculate the difference between current and previous indicator values
• Added StreakIndicator helper indicator to track consecutive up or down movements in indicator values
• Added StochasticIndicator as a generic stochastic calculation indicator, extracted from SchaffTrendCycleIndicator for reuse
• AI-powered semantic release scheduler: Added automated GitHub workflow that uses AI to analyze changes, determine version bumps (patch/minor/major), and schedule releases every 14 days. Includes structured approval process for major version bumps and OIDC token-based authentication for AI model calls. Enhanced release workflows with improved error handling, tag checking, and logging.

0.19 (released November 19, 2025)

Breaking

• TradingStatement is now an interface: Converted to an interface implemented by BaseTradingStatement. This exposes the underlying Strategy and TradingRecord for advanced analysis workflows. Action required: Update any code that directly instantiates TradingStatement to use BaseTradingStatement instead.
• PnL and return criteria refactored into net/gross variants: Split ProfitLossCriterion, ProfitCriterion, LossCriterion, AverageProfitCriterion, AverageLossCriterion, ReturnCriterion, ProfitLossRatioCriterion, and ProfitLossPercentageCriterion into separate net and gross concrete classes. This provides explicit control over whether trading costs are included in calculations. Action required: Update imports and class names to use the appropriate net or gross variant based on your analysis needs.
• Indicator operation classes consolidated: #1266 Unified BinaryOperation, UnaryOperation, TransformIndicator, and CombineIndicator into a cleaner API. Action required: Replace deprecated TransformIndicator and CombineIndicator usage with the new consolidated classes.
• Drawdown criteria moved to sub-package: Relocated MaximumDrawdownCriterion and ReturnOverMaxDrawdownCriterion to the criteria/drawdown/ sub-package for better organization. Action required: Update import statements to reflect the new package location.

Added

• Rule naming support: Added Rule#getName() and Rule#setName(String) methods to allow rules to have custom names for improved trace logging and serialization. Rules now default to JSON-formatted names that include type and component information, but can be overridden with custom labels for better readability in logs and debugging output.
• Time-based trading rules: Added HourOfDayRule and MinuteOfHourRule to enable trading strategies based on specific hours of the day (0-23) or minutes of the hour (0-59). These rules work with DateTimeIndicator to filter trading signals by time, enabling time-of-day based strategies.
• Time-based strategy examples: Added HourOfDayStrategy and MinuteOfHourStrategy as example implementations demonstrating how to use the new time-based rules in complete trading strategies.
• Enhanced backtesting with performance tracking: Introduced BacktestExecutionResult and BacktestRuntimeReport with new BacktestExecutor entry points. Users can now track per-strategy execution times, receive progress callbacks during long-running backtests, and efficiently stream top-k strategy selection for large strategy grids without loading all results into memory.
• Strategy serialization for persistence: Added StrategySerialization with Strategy#toJson() and Strategy#fromJson(BarSeries, String) methods. This enables users to save and restore complete strategy configurations (including entry/exit rules) as JSON, making it easy to share strategies, version control configurations, and build strategy libraries.
• NamedStrategy serialization with compact format: #1349 Enabled NamedStrategy serialization/deserialization with compact labels (e.g., ToggleNamedStrategy_true_false_u3). Users can now persist strategy presets alongside their parameters in a human-readable format. Added registry/permutation helper APIs and lazy package scanning via NamedStrategy.initializeRegistry(...) for efficient strategy discovery.
• Renko chart indicators: #1187 Added RenkoUpIndicator, RenkoDownIndicator, and RenkoXIndicator to detect Renko brick sequences, enabling users to build strategies based on Renko chart patterns.
• Advanced drawdown analysis: Added CumulativePnL, MaximumAbsoluteDrawdownCriterion, MaximumDrawdownBarLengthCriterion, and MonteCarloMaximumDrawdownCriterion. Users can now analyze drawdowns in absolute terms, measure drawdown duration, and estimate drawdown risk distributions through Monte Carlo simulation of different trade orderings.
• Comprehensive commission tracking: Added CommissionsCriterion to total commissions paid across positions and CommissionsImpactPercentageCriterion to measure how much trading costs reduce gross profit. This helps users understand the real impact of transaction costs on strategy performance.
• Streak and extreme position analysis: Added MaxConsecutiveLossCriterion, MaxConsecutiveProfitCriterion, MaxPositionNetLossCriterion, and MaxPositionNetProfitCriterion. Users can now identify worst loss streaks, best win streaks, and extreme per-position outcomes to better understand strategy risk and consistency.
• Position timing analysis: Added InPositionPercentageCriterion to calculate the percentage of time a strategy remains invested, helping users understand capital utilization and exposure.
• Flexible bar building options: Added AmountBarBuilder to aggregate bars after a fixed number of amount have been traded. Bars can now be built by beginTime instead of endTime, providing more flexibility in bar aggregation strategies.
• Volume-weighted MACD: Added MACDVIndicator to volume-weight MACD calculations, providing an alternative MACD variant that incorporates volume information.
• Net momentum indicator: Added NetMomentumIndicator for momentum-based strategy development.
• Vote-based rule composition: Added VoteRule class, enabling users to create rules that trigger based on majority voting from multiple underlying rules.
• Enhanced data loading: Added AdaptiveJsonBarsSerializer to support OHLC bar data from Coinbase or Binance, and new JsonBarsSerializer.loadSeries(InputStream) overload for easier data loading from streams.
• Improved charting and examples: Expanded charting utilities to overlay indicators with trading records, added NetMomentumStrategy and TopStrategiesExample, and bundled a Coinbase ETH/USD sample data set to demonstrate the new APIs.
• Automated release pipeline: Added GitHub workflow to automatically version, build, and publish artifacts to Maven Central. The pipeline uses prepare-release.sh to prepare release versions, creates release branches and tags, and publishes to Maven Central. Added scripts/tests/test_prepare_release.sh to validate release preparation functionality.
• Enhanced performance reporting: Added Gson DurationTypeAdapter, BasePerformanceReport, and revised TradingStatementGenerator so generated statements always carry their source strategy and trading record for complete traceability.
• UnaryOperation helper: Added substitute helper function to UnaryOperation for easier indicator transformations.
• Testing infrastructure: Added tests for DoubleNumFactory and DecimalNumFactory, unit tests around indicator concurrency in preparation for future multithreading features, and DecimalNumPrecisionPerformanceTest to demonstrate precision vs performance trade-offs.

Changed

• Enhanced rule serialization with custom name preservation: Improved RuleSerialization to preserve custom rule names set via setName() during serialization and deserialization. Custom names are now properly distinguished from default JSON-formatted names, enabling better strategy persistence and debugging workflows.
• Improved trace logging with rule names: Enhanced trace logging in AbstractRule and BaseStrategy to use rule names (custom or default) in log output, making it easier to identify which rules are being evaluated during strategy execution.
• Unified logging backend: Replaced Logback bindings with Log4j 2 log4j-slf4j2-impl so examples and tests share a single logging backend. Added Log4j 2 configurations for modules and tests. This simplifies logging configuration and ensures consistent behavior across all modules. Set unit test logging level to INFO and cleaned build output of all extraneous logging.
• More accurate return calculations: Changed AverageReturnPerBarCriterion, EnterAndHoldCriterion, and ReturnOverMaxDrawdownCriterion to use NetReturnCriterion instead of GrossReturnCriterion to avoid optimistic bias. This provides more realistic performance metrics that account for trading costs.
• Improved drawdown criterion behavior: ReturnOverMaxDrawdownCriterion now returns 0 instead of NaN for strategies that never operate, and returns net profit instead of NaN for strategies with no drawdown. This makes the criterion more robust and easier to use in automated analysis.
• More flexible stop rules: StopGainRule and StopLossRule now accept any price Indicator instead of only ClosePriceIndicator. Users can now create stop rules based on high, low, open, or custom price indicators for more sophisticated exit strategies.
• Enhanced swing indicators: Reworked RecentSwingHighIndicator and RecentSwingLowIndicator with plateau-aware, NaN-safe logic and exposed getLatestSwingIndex for downstream analysis. This improves reliability and enables more advanced swing-based strategies.
• Configurable numeric precision: Reduced default DecimalNum precision from 32 to 16 digits, improving performance while still maintaining sufficient accuracy for most use cases. Users can configure precision based on their specific needs.
• Improved numeric indicator chaining: NumericIndicator's previous method now returns a NumericIndicator, enabling fluent method chaining for indicator composition.
• Enhanced trading statements: Added TradingRecord property to TradingStatement for more downstream flexibility around analytics, enabling users to access the full trading record from performance reports.
• Better code maintainability: Removed magic number 25 in UpTrendIndicator and DownTrendIndicator, making the...

What's Changed

Breaking

• Updated project Java JDK from 11 > 21
• Updated Github workflows to use JDK 21
• Extracted NumFactory as source of numbers with defined precision
• Replaced ZonedDateTime with Instant
• Renamed FixedDecimalIndicator with FixedNumIndicator
• Moved BaseBarBuilder and BaseBarBuilderFactory to bars-package and renamed to TimeBarBuilder and TimeBarBuilderFactory
• Renamed BaseBarConvertibleBuilderTest to BaseBarSeriesBuilderTest
• Renamed Indicator.getUnstableBars to Indicator.getCountOfUnstableBars
• Moved indicators/AbstractEMAIndicator to indicators/averages-package
• Moved indicators/DoubleEMAIndicator to indicators/averages-package
• Moved indicators/EMAIndicator to indicators/averages-package
• Moved indicators/HMAIndicator to indicators/averages-package
• Moved indicators/KAMAIndicator to indicators/averages-package
• Moved indicators/LWMAIndicator to indicators/averages-package
• Moved indicators/MMAIndicator to indicators/averages-package
• Moved indicators/SMAIndicator to indicators/averages-package
• Moved indicators/TripleEMAIndicator to indicators/averages-package
• Moved indicators/WMAIndicator to indicators/averages-package
• Moved indicators/ZLEMAIndicator to indicators/averages-package
• Implemented sharing of MathContext in DecimalNum. For creating numbers, NumFactory implementations are the preferred way.

Fixed

• Fixed BaseBar.toString() to avoid NullPointerException if any of its property is null
• Fixed SMAIndicatorTest to set the endTime of the next bar correctly
• Fixed SMAIndicatorMovingSeriesTest to set the endTime of the next bar correctly
• Use UTC TimeZone for AroonOscillatorIndicatorTest, PivotPointIndicatorTest
• Fixed MockBarBuilder to use Instant.now for beginTime
• Fixed RecentSwingHighIndicatorTest to create bars consistently
• Fixed LSMAIndicator to fix lsma calculation for incorrect values

Changed

• Updated jfreechart dependency in ta4j-examples project from 1.5.3 to 1.5.5 to resolve CVE-2023-52070
• Updated logback-classic 1.4.12 > 1.5.6 to resolve CVE-2023-6481
• Cleaned code by using new java syntax text blocks
• Faster test execution by using String.lines() instead of String concatenation
• Improve Javadoc for DecimalNumand DoubleNum
• Allowed JUnit5 for new tests. Old remain as is.

Added

• added HeikinAshiBarAggregator: Heikin-Ashi bar aggregator implementation
• added HeikinAshiBarBuilder: Heikin-Ashi bar builder implementation
• added Bar.getZonedBeginTime: the bar's begin time usable as ZonedDateTime
• added Bar.getZonedEndTime: the bar's end time usable as ZonedDateTime
• added Bar.getSystemZonedBeginTime: the bar's begin time converted to system time zone
• added Bar.getSystemZonedEndTime: the bar's end time converted to system time zone
• added BarSeries.getSeriesPeriodDescriptionInSystemTimeZone: with times printed in system's default time zone
• added KRIIndicator
• Added constructor with amount for EnterAndHoldCriterion
• Added constructor with amount for VersusEnterAndHoldCriterion
• Added TickBarBuilder to bars-package to aggregate bars after a fixed number of ticks
• Added VolumeBarBuilder to bars-package to aggregate bars after a fixed number of contracts (volume)
• Added TickBarBuilder to bars-package
• Added VolumeBarBuilder to bars-package
• Added Indicator.isStable: is true if the indicator no longer produces incorrect values due to insufficient data
• Added WildersMAIndicator to indicators.averages-package: Wilder's moving average indicator
• Added DMAIndicator to indicators.averages-package: Displaced Moving Average (DMA) indicator
• Added EDMAIndicator to indicators.averages-package: Exponential Displaced Moving Average (EDMA) indicator
• Added JMAIndicator to indicators.averages-package: Jurik Moving Average (JMA) indicator
• Added TMAIndicator to indicators.averages-package: Trangular Moving Average (TMA) indicator
• Added ATMAIndicator to indicators.averages-package: Asymmetric Trangular Moving Average (TMA) indicator
• Added MCGinleyMAIndicator to indicators.averages-package: McGinley Moving Average (McGinleyMA) indicator
• Added SMMAIndicator to indicators.averages-package: Smoothed Moving Average (SMMA) indicator
• Added SGMAIndicator to indicators.averages-package: Savitzky-Golay Moving Average (SGMA) indicator
• Added LSMAIndicator to indicators.averages-package: Least Squares Moving Average (LSMA) indicator
• Added KiJunV2Indicator to indicators.averages-package: Kihon Moving Average (KiJunV2) indicator
• Added VIDYAIndicator to indicators.averages-package: Chande’s Variable Index Dynamic Moving Average (VIDYA) indicator
• Added VWMAIndicator to indicators.averages-package: Volume Weighted Moving Average (VWMA) indicator
• added AverageIndicator

New Contributors

• @algonell made their first contribution in #1184
• @ek-ex made their first contribution in #1232
• @brhurley made their first contribution in #1226

Full Changelog: 0.17...0.18

Release 0.17 of the Ta4j library.

This is the fourth release via GitHub Releases. Ta4j is also available on the maven central repository

www.ta4j.org

Changelog for ta4j, roughly following keepachangelog.com from version 0.9 onwards.

What's Changed

• Implemented partial sum cache for SMAIndicator by @sgflt in #1140
• Added signal line and histogram to MACDIndicator by @sgflt in #1155
• Update README.md by @TheCookieLab in #1156
• Update ProfitLossCriterion.java by @ts-00 in #1158
• Tradingrecord getters by @ts-00 in #1160
• Use Predicate instead of enum in BooleanTransformIndicator by @Petersoj in #1163
• Update ta4jexamples dependency version and fix SMAIndicatorMovingSerieTest by @TheCookieLab in #1166
• Add EnterAndHoldCriterion by @nimo23 in #1105
• add-Num#bigDecimalValue by @nimo23 in #1109
• Feature/recent swing high and low indicators by @TheCookieLab in #1125
• Feature/ttmsqueezepro indicator by @TheCookieLab in #1168
• Feature/1169 atr based stop loss rules by @TheCookieLab in #1170
• implemented kalman filter indicator for smoothing by @TheCookieLab in #1172
• Candle indicators by @btezergil in #1174
• RecentSwing*Indicator fixed look ahead bias by @TheCookieLab in #1173
• reused tr in constructor instead of creating new instance by @TheCookieLab in #1176

New Contributors

• @sgflt made their first contribution in #1140
• @ts-00 made their first contribution in #1158
• @btezergil made their first contribution in #1174

Full Changelog: 0.16...0.17

Release 0.16 of the Ta4j library.

This is the third release via GitHub Releases. Ta4j is also available on the maven central repository

www.ta4j.org

Changelog for ta4j, roughly following keepachangelog.com from version 0.9 onwards.

0.16 (released May 15, 2024)

Breaking

• Upgraded to Java 11
• VersusBuyAndHoldCriterion renamed to VersusEnterAndHoldCriterion
• BarSeries constructors use any instance of Num instead of Num-Function
• GrossReturnCriterion renamed to ReturnCriterion
• NetProfitCriterion and GrossProfitCriterion replaced by ProfitCriterion
• NetLossCriterion and GrossLossCriterion replaced by LossCriterion
• LosingPositionsRatioCriterion replaced by PositionsRatioCriterion
• WinningPositionsRatioCriterion replaced by PositionsRatioCriterion
• Strategy#unstablePeriod renamed to Strategy#unstableBars*
• DateTimeIndicator moved to package indicators/helpers
• UnstableIndicator moved to package indicators/helpers
• ConvertableBaseBarBuilder renamed to BaseBarConvertableBuilder
• BarSeriesManager updated to use TradeOnNextOpenModel by default, which opens new trades at index t + 1 at the open price.
  • For strategies require the previous behaviour, i.e. trades seconds or minutes before the closing prices, TradeOnCurerentCloseModel can be passed to BarSeriesManager
    • For example:
      • BarSeriesManager manager = new BarSeriesManager(barSeries, new TradeOnCurrentCloseModel())
      • BarSeriesManager manager = new BarSeriesManager(barSeries, transactionCostModel, holdingCostModel, tradeExecutionModel)
• BarSeriesManager and BacktestExecutor moved to packge backtest
• BarSeries#getBeginIndex() methode returns correct begin index for bar series with max bar count

Fixed

• Fixed SuperTrendIndicator fixed calculation when close price is the same as the previous Super Trend indicator value
• Fixed ParabolicSarIndicator fixed calculation for sporadic indices
• ExpectancyCriterion fixed calculation
• catch NumberFormatException if DecimalNum.valueOf(Number) is NaN
• ProfitCriterion fixed excludeCosts functionality as it was reversed
• LossCriterion fixed excludeCosts functionality as it was reversed
• PerformanceReportGenerator fixed netProfit and netLoss calculations to include costs
• DifferencePercentageIndicator fixed re-calculate instance variable on every iteration
• ThreeWhiteSoldiersIndicator fixed eliminated instance variable holding possible wrong value
• ThreeBlackCrowsIndicator fixed eliminated instance variable holding possible wrong value
• TrailingStopLossRule removed instance variable currentStopLossLimitActivation because it may not be alway the correct (last) value
• sets ClosePriceDifferenceIndicator#getUnstableBars = 1
• sets ClosePriceRatioIndicator#getUnstableBars = 1
• sets ConvergenceDivergenceIndicator#getUnstableBars = barCount
• sets GainIndicator#getUnstableBars = 1
• sets HighestValueIndicator#getUnstableBars = barCount
• sets LossIndicator#getUnstableBars = 1
• sets LowestValueIndicator#getUnstableBars = barCount
• sets TRIndicator#getUnstableBars = 1
• sets PreviousValueIndicator#getUnstableBars = n (= the n-th previous index)
• PreviousValueIndicator returns NaN if the (n-th) previous value of an indicator does not exist, i.e. if the (n-th) previous is below the first available index.
• EnterAndHoldReturnCriterion fixes exception thrown when bar series was empty
• BaseBarSeries fixed UnsupportedOperationException when creating a bar series that is based on an unmodifiable collection
• Num implements Serializable

Changed

• BarSeriesManager consider finishIndex when running backtest
• BarSeriesManager add holdingTransaction
• BacktestExecutor evaluates strategies in parallel when possible
• CachedIndicator synchronize on getValue()
• BaseBar defaults to DecimalNum type in all constructors
• TRIndicator improved calculation
• WMAIndicator improved calculation
• KSTIndicator improved calculation
• RSIIndicator simplify calculation
• FisherIndicator improved calculation
• DoubleEMAIndicator improved calculation
• CMOIndicator improved calculation
• PearsonCorrelationIndicator improved calculation
• PivotPoint-Indicators improved calculations
• ValueAtRiskCriterion improved calculation
• ExpectedShortfallCriterion improved calculation
• SqnCriterion improved calculation
• NumberOfBreakEvenPositionsCriterion shorten code
• AverageReturnPerBarCriterion improved calculation
• ZLEMAIndicator improved calculation
• InPipeRule improved calculation
• SumIndicator improved calculation
• updated pom.xml: slf4j-api to 2.0.7
• updated pom.xml: org.apache.poi to 5.2.3
• updated pom.xml: maven-jar-plugin to 3.3.0
• add final to properties where possible
• improved javadoc
• SuperTrendIndicator,SuperTrendUpperIndicator,SuperTrendLowerIndicator: optimized calculation
• SuperTrendIndicator, SuperTrendLowerBandIndicator, SuperTrendUpperBandIndicator: multiplier changed to from Integer to Double
• add missing @Override annotation
• RecursiveCachedIndicator: simplified code
• LossIndicator: optimize calculation
• GainIndicator: improved calculation
• PriceVariationIndicator renamed to ClosePriceRatioIndicator for consistency with new ClosePriceDifferenceIndicator
• made UnaryOperation and BinaryOperation public

Removed/Deprecated

• removed Serializable from CostModel
• removed @Deprecated Bar#addTrade(double tradeVolume, double tradePrice, Function<Number, Num> numFunction); use Bar#addTrade(Num tradeVolume, Num tradePrice) instead.
• removed @Deprecated Bar#addTrade(String tradeVolume, String tradePrice, Function<Number, Num> numFunction); use Bar#addTrade(Num tradeVolume, Num tradePrice) instead.
• removed DecimalNum.valueOf(DecimalNum)
• delete .travis.yml as this project is managed by "Github actions"

Added

• added TradingRecord.getStartIndex() and TradingRecord.getEndIndex() to track start and end of the recording
• added SuperTrendIndicator
• added SuperTrendUpperBandIndicator
• added SuperTrendLowerBandIndicator
• added Donchian Channel indicators (Upper, Lower, and Middle)
• added Indicator.getUnstableBars()
• added TransformIndicator.pow()
• added BarSeriesManager.getHoldingCostModel() and BarSeriesManager.getTransactionCostModel() to allow extending BarSeriesManager and reimplementing run()
• added MovingAverageCrossOverRangeBacktest.java and ETH-USD-PT5M-2023-3-13_2023-3-15.json test data file to demonstrate parallel strategy evaluation
• added javadoc improvements for percentage criteria
• added "lessIsBetter"-property for AverageCriterion
• added "lessIsBetter"-property for RelativeStandardDeviation
• added "lessIsBetter"-property for StandardDeviationCriterion
• added "lessIsBetter"-property for StandardErrorCriterion
• added "lessIsBetter"-property for VarianceCriterion
• added "lessIsBetter"-property for NumberOfPositionsCriterion
• added "addBase"-property for ReturnCriterion to include or exclude the base percentage of 1
• added RelativeVolumeStandardDeviationIndicator
• added MoneyFlowIndexIndicator
• added IntraDayMomentumIndexIndicator
• added ClosePriceDifferenceIndicator
• added TimeSegmentedVolumeIndicator
• added DecimalNum.valueOf(DoubleNum) to convert a DoubleNum to a DecimalNum.
• added DoubleNum.valueOf(DecimalNum) to convert a DecimalNum to a DoubleNum.
• added "TradeExecutionModel" to modify trade execution during backtesting
• added NumIndicator to calculate any Num-value for a Bar
• added RunningTotalIndicator to calculate a cumulative sum for a period.

Fixed

• Fixed CashFlow fixed calculation with custom startIndex and endIndex
• Fixed Returns fixed calculation with custom startIndex and endIndex
• Fixed ExpectedShortfallCriterion fixed calculation with custom startIndex and endIndex
• Fixed MaximumDrawDownCriterion fixed calculation with custom startIndex and endIndex
• Fixed EnterAndHoldReturnCriterion fixed calculation with custom startIndex and endIndex
• Fixed VersusEnterAndHoldCriterion fixed calculation with custom startIndex and endIndex
• Fixed BarSeriesManager consider finishIndex when running backtest

Release 0.15 of the Ta4j library.

This is the second release via GitHub Releases. Ta4j is also available on the maven central repository

www.ta4j.org

Changelog for ta4j, roughly following keepachangelog.com from version 0.9 onwards.

0.15 (released September 11, 2022)

Breaking

• NumberOfConsecutiveWinningPositions renamed to NumberOfConsecutivePositions
• DifferencePercentage renamed to DifferencePercentageIndicator
• BuyAndHoldCriterion renamed to EnterAndHoldCriterion
• DXIndicator moved to adx-package
• PlusDMIndicator moved to adx-package
• MinusDMIndicator moved to adx-package
• analysis/criterion-package moved to root
• cost-package moved to analysis/cost-package
• AroonXXX indicators moved to aroon package

Fixed

• LosingPositionsRatioCriterion correct betterThan
• VersusBuyAndHoldCriterionTest NaN-Error.
• Fixed ChaikinOscillatorIndicatorTest
• DecimalNum#remainder() adds NaN-check
• Fixed ParabolicSarIndicatorTest fixed openPrice always 0 and highPrice lower than lowPrice
• UlcerIndexIndicator using the max price of current period instead of the highest value of last n bars
• DurationBarAggregator fixed aggregation of bars with gaps

Changed

• KeltnerChannelMiddleIndicator changed superclass to AbstractIndicator; add GetBarCount() and toString()
• KeltnerChannelUpperIndicator add constructor to accept pre-constructed ATR; add GetBarCount() and toString()
• KeltnerChannelLowerIndicator add constructor to accept pre-constructed ATR; add GetBarCount() and toString()
• BarSeriesManager removed empty args constructor
• Open|High|Low|Close do not cache price values anymore
• DifferenceIndicator(i1,i2) replaced by the more flexible CombineIndicator.minus(i1,i2)
• DoubleNum replace redundant toString() call in DoubleNum.valueOf(Number i) with i.doubleValue()
• ZeroCostModel now extends from FixedTransactionCostModel

Removed/Deprecated

• Num removed Serializable
• PriceIndicator removed

Added

• NumericIndicator new class providing a fluent and lightweight api for indicator creation
• AroonFacade, BollingerBandFacade, KeltnerChannelFacade new classes providing a facade for indicator groups by using lightweight NumericIndicators
• AbstractEMAIndicator added getBarCount() to support future enhancements
• ATRIndicator "uncached" by changing superclass to AbstractIndicator; added constructor to accept TRIndicator and getter for same; added toString(); added getBarCount() to support future enhancements
• 🎉 Enhancement added possibility to use CostModels when backtesting with the BacktestExecutor
• 🎉 Enhancement added Num#zero, Num#one, Num#hundred
• 🎉 Enhancement added possibility to use CostModels when backtesting with the BacktestExecutor
• 🎉 Enhancement added Indicator#stream() method
• 🎉 Enhancement added a new CombineIndicator, which can combine the values of two Num Indicators with a given combine-function
• Example added a json serialization and deserialization example of BarSeries using google-gson library
• EnterAndHoldCriterion added constructor with TradeType to begin with buy or sell
• 🎉 Enhancement added Position#getStartingType() method
• 🎉 Enhancement added SqnCriterion
• 🎉 Enhancement added StandardDeviationCriterion
• 🎉 Enhancement added RelativeStandardDeviationCriterion
• 🎉 Enhancement added StandardErrorCriterion
• 🎉 Enhancement added VarianceCriterion
• 🎉 Enhancement added AverageCriterion
• 🎉 Enhancement added javadoc for all rules to make clear which rule makes use of a TradingRecord
• Enhancement prevent Object[] allocation for varargs log.trace and log.debug calls by wrapping them in if blocks
• 🎉 Enhancement added FixedTransactionCostModel
• 🎉 Enhancement added AnalysisCriterion.PositionFilter to handle both sides within one Criterion.

Release 0.14 of the Ta4j library.

This is the first release via GitHub Releases. Ta4j is also available on the maven central repository

www.ta4j.org

CHANGELOG:

0.14 (released April 25, 2021)

Breaking

• Breaking: PrecisionNum renamed to DecimalNum
• Breaking: AverageProfitableTradesCriterion renamed to WinningTradesRatioCriterion
• Breaking: AverageProfitCriterion renamed to AverageReturnPerBarCriterion
• Breaking: BuyAndHoldCriterion renamed to BuyAndHoldReturnCriterion
• Breaking: RewardRiskRatioCriterion renamed to ReturnOverMaxDrawdownCriterion
• Breaking: ProfitLossCriterion moved to PnL-Package
• Breaking: ProfitLossPercentageCriterion moved to PnL-Package
• Breaking: TotalProfitCriterion renamed to GrossReturnCriterion and moved to PnL-Package.
• Breaking: TotalProfit2Criterion renamed to GrossProfitCriterion and moved to PnL-Package.
• Breaking: TotalLossCriterion renamed to NetLossCriterion and moved to PnL-Package.
• Breaking: package "tradereports" renamed to "reports"
• Breaking: NumberOfTradesCriterion renamed to NumberOfPositionsCriterion
• Breaking: NumberOfLosingTradesCriterion renamed to NumberOfLosingPositionsCriterion
• Breaking: NumberOfWinningTradesCriterion renamed to NumberOfWinningPositionsCriterion
• Breaking: NumberOfBreakEvenTradesCriterion renamed to NumberOfBreakEvenPositionsCriterion
• Breaking: WinningTradesRatioCriterion renamed to WinningPositionsRatioCriterion
• Breaking: TradeStatsReport renamed to PositionStatsReport
• Breaking: TradeStatsReportGenerator renamed to PositionStatsReportGenerator
• Breaking: TradeOpenedMinimumBarCountRule renamed to OpenedPositionMinimumBarCountRule
• Breaking: Trade.class renamed to Position.class
• Breaking: Order.class renamed to Trade.class
• Breaking: package "tradereports" renamed to "reports"
• Breaking: package "trading/rules" renamed to "rules"
• Breaking: remove Serializable from all indicators
• Breaking: Bar#trades: changed type from int to long

Fixed

• Fixed Trade: problem with profit calculations on short trades.
• Fixed TotalLossCriterion: problem with profit calculations on short trades.
• Fixed BarSeriesBuilder: removed the Serializable interface
• Fixed ParabolicSarIndicator: problem with calculating in special cases
• Fixed BaseTimeSeries: can now be serialized
• Fixed ProfitLossPercentageCriterion: use entryPrice#getValue() instead of entryPrice#getPricePerAsset()

Changed

• Trade: Changed the way Nums are created.
• WinningTradesRatioCriterion (previously AverageProfitableTradesCriterion): Changed to calculate trade profits using Trade's getProfit().
• BuyAndHoldReturnCriterion (previously BuyAndHoldCriterion): Changed to calculate trade profits using Trade's getProfit().
• ExpectedShortfallCriterion: Removed unnecessary primitive boxing.
• NumberOfBreakEvenTradesCriterion: Changed to calculate trade profits using Trade's getProfit().
• NumberOfLosingTradesCriterion: Changed to calculate trade profits using Trade's getProfit().
• NumberOfWinningTradesCriterion: Changed to calculate trade profits using Trade's getProfit().
• ProfitLossPercentageCriterion: Changed to calculate trade profits using Trade's entry and exit prices.
• TotalLossCriterion: Changed to calculate trade profits using Trade's getProfit().
• TotalReturnCriterion (previously TotalProfitCriterion): Changed to calculate trade profits using Trade's getProfit().
• WMAIndicator: reduced complexity of WMAIndicator implementation

Removed/Deprecated

• MultiplierIndicator: replaced by TransformIndicator.
• AbsoluteIndicator: replaced by TransformIndicator.

Added

• Enhancement Improvements on gitignore
• Enhancement Added TradeOpenedMinimumBarCountRule - rule to specify minimum bar count for opened trade.
• Enhancement Added DateTimeIndicator a new Indicator for dates.
• Enhancement Added DayOfWeekRule for specifying days of the week to trade.
• Enhancement Added TimeRangeRule for trading within time ranges.
• Enhancement Added floor() and ceil() to Num.class
• Enhancement Added getters getLow() and getUp() in CrossedDownIndicatorRule
• Enhancement Added BarSeriesUtils: common helpers and shortcuts for BarSeries methods.
• Enhancement Improvements for PreviousValueIndicator: more descriptive toString() method, validation of n-th previous bars in
• Enhancement Added Percentage Volume Oscillator Indicator, PVOIndicator.
• Enhancement Added Distance From Moving Average Indicator, DistanceFromMAIndicator.
• Enhancement Added Know Sure Thing Indicator, KSTIndicator.
  constructor of PreviousValueIndicator
• 🎉 Enhancement added getGrossProfit() and getGrossProfit(BarSeries) on Trade.
• 🎉 Enhancement added getPricePerAsset(BarSeries) on Order.
• 🎉 Enhancement added convertBarSeries(BarSeries, conversionFunction) to BarSeriesUtils.
• 🎉 Enhancement added UnstableIndicator.
• 🎉 Enhancement added Chainrule.
• 🎉 Enhancement added BarSeriesUtils#sortBars.
• 🎉 Enhancement added BarSeriesUtils#addBars.
• 🎉 Enhancement added Num.negate() to negate a Num value.
• 🎉 Enhancement added GrossLossCriterion.class.
• 🎉 Enhancement added NetProfitCriterion.class.
• 🎉 Enhancement added chooseBest() method with parameter tradeType in AnalysisCriterion.
• 🎉 Enhancement added AverageLossCriterion.class.
• 🎉 Enhancement added AverageProfitCriterion.class.
• 🎉 Enhancement added ProfitLossRatioCriterion.class.
• 🎉 Enhancement added ExpectancyCriterion.class.
• 🎉 Enhancement added ConsecutiveWinningPositionsCriterion.class.
• 🎉 Enhancement added LosingPositionsRatioCriterion.class
• 🎉 Enhancement added Position#hasProfit.
• 🎉 Enhancement added Position#hasLoss.
• 🎉 Enhancement exposed both EMAs in MACD indicator