strategy_helpers

This library is designed to aid traders and developers in calculating risk metrics efficiently across different asset types like equities, futures, and forex. It includes comprehensive functions that calculate the number of units or contracts to trade, the value at risk, and the total value of the position based on provided entry prices, stop levels, and risk percentages. Whether you're managing a portfolio or developing trading strategies, this library provides essential tools for risk management. Functions also automatically select the appropriate risk calculation method based on asset type, calculate leverage levels, and determine potential liquidation points for leveraged positions. Perfect for enhancing the precision and effectiveness of your trading strategies.

Library "strategy_helpers"
Provides tools for calculating risk metrics across different types of trading strategies including equities, futures, and forex. Functions allow for precise control over risk management by calculating the number of units or contracts to trade, the value at risk, and the total position value based on entry prices, stop levels, and desired risk percentage. Additional utilities include automatic risk calculation based on asset type, leverage level calculations, and determination of liquidation levels for leveraged trades.

calculate_risk(entry, stop_level, stop_range, capital, risk_percent, trade_direction, whole_number_buy)
  Calculates risk metrics for equity trades based on entry, stop level, and risk percent
  Parameters:
    entry (float): The price at which the position is entered. Use close if you arent adding to a position. Use the original entry price if you are adding to a position.
    stop_level (float): The price level where the stop loss is placed
    stop_range (float): The price range from entry to stop level
    capital (float): The total capital available for trading
    risk_percent (float): The percentage of capital risked on the trade. 100% is represented by 100.
    trade_direction (bool): True for long trades, false for short trades
    whole_number_buy (bool): True to adjust the quantity to whole numbers
  Returns: A tuple containing the number of units to trade, the value at risk, and the total value of the position: [number_of_underlying, value_of_risk, value_of_position]

calculate_risk_futures(risk_capital, stop_range)
  Calculates risk metrics for futures trades based on the risk capital and stop range
  Parameters:
    risk_capital (float): The capital allocated for the trade
    stop_range (float): The price range from entry to stop level
  Returns: A tuple containing the number of contracts to trade, the value at risk, and the total value of the position: [contracts, value_of_risk, value_of_position]

calculate_risk_forex(entry, stop_level, stop_range, capital, risk_percent, trade_direction)
  Calculates risk metrics for forex trades based on entry, stop level, and risk percent
  Parameters:
    entry (float): The price at which the position is entered. Use close if you arent adding to a position. Use the original entry price if you are adding to a position.
    stop_level (float): The price level where the stop loss is placed
    stop_range (float): The price range from entry to stop level
    capital (float): The total capital available for trading
    risk_percent (float): The percentage of capital risked on the trade. 100% is represented by 100.
    trade_direction (bool): True for long trades, false for short trades
  Returns: A tuple containing the number of lots to trade, the value at risk, and the total value of the position: [number_of_underlying, value_of_risk, value_of_position]

calculate_risk_auto(entry, stop_level, stop_range, capital, risk_percent, trade_direction, whole_number_buy)
  Automatically selects the risk calculation method based on the asset type and calculates risk metrics
  Parameters:
    entry (float): The price at which the position is entered. Use close if you arent adding to a position. Use the original entry price if you are adding to a position.
    stop_level (float): The price level where the stop loss is placed
    stop_range (float): The price range from entry to stop level
    capital (float): The total capital available for trading
    risk_percent (float): The percentage of capital risked on the trade. 100% is represented by 100.
    trade_direction (bool): True for long trades, false for short trades
    whole_number_buy (bool): True to adjust the quantity to whole numbers, applicable only for non-futures and non-forex trades
  Returns: A tuple containing the number of units or contracts to trade, the value at risk, and the total value of the position: [number_of_underlying, value_of_risk, value_of_position]

leverage_level(account_equity, position_value)
  Calculates the leverage level used based on account equity and position value
  Parameters:
    account_equity (float): Total equity in the trading account
    position_value (float): Total value of the position taken
  Returns: The leverage level used in the trade

calculate_liquidation_level(entry, leverage, trade_direction, maintenance_margine)
  Calculates the liquidation price level for a leveraged trade
  Parameters:
    entry (float): The price at which the position is entered
    leverage (float): The leverage level used in the trade
    trade_direction (bool): True for long trades, false for short trades
    maintenance_margine (float): The maintenance margin requirement, expressed as a percentage
  Returns: The price level at which the position would be liquidated, or na if leverage is zero