BlackSharkAlgo Pro User Input Guide

1. License Activation (LicenseM)

• License Key: Your unique license key. Required for EA activation.
• Product ID: Identifier provided with your license. Enter as provided.

2. Web Request Permissions (Webaddresses)

These URLs are essential for the EA's functionality and must be added to your terminal's WebRequest allowed URLs. Find this in Tools > Options > Expert Advisors.

• news_link: URL for economic news data. Used by the News Filter. (Default: https://nfs.faireconomy.media/ ) // *News data source.*
• webaddress2: URL for time synchronization. (Default: https://worldtimeserver.com ) // *Time server for accuracy.*
• webaddress4: URL for license verification. (Default: https://hamoon.net ) // *License validation server.*

3. General Trading Settings (Settings)

• Symbols: Select trading symbols. Options include:
• [Symbol] : Comma-separated symbols (e.g., EURUSD,GBPJPY,XAUUSD). Specify symbols precisely.
• 9Pairs, 28Pairs, 29Pairs (28+XAUUSD): Predefined currency pair sets. MajorPairs, NonCorrelated1, NonCorrelated2, CommodityPairs, ExoticPairs, RiskOffSymbols, Whole: Predefined categories, or "Whole" for all Market Watch symbols.
• • Examples:
    • Symbols = EURUSD,GBPUSD,EURGBP (Trades these pairs)
    • Symbols = 29Pairs (Trades a list of 29 pairs including XAUUSD)
    • Symbols = 28Pairs (Trades a list of 28 pairs)
      
    • Symbols = MajorPairs (Trades major currency pairs)
• InitLongStrategy, InitShortStrategy, AddLongStrategy, AddShortStrategy: Choose strategy types for entries.
• InitLongStrategy : Long (buy) entry strategy selection.
• InitShortStrategy : Short (sell) entry strategy selection.
• AddLongStrategy : Strategy for adding to long positions.
• AddShortStrategy : Strategy for adding to short positions.

Select a number from 0 to 7, or -1 for dynamic selection within each category:

• 0-5 : Different strategy variations. Experiment to find suitable options.
• 6 : Combination of strategy types. Potentially balanced approach.
• 7 : Another strategy combination. Potentially more conservative.
• -1 : Dynamic strategy selection. Consider for varied market conditions. Use with caution.
• maxTrades: Maximum allowed simultaneous trades. Manage risk by limiting open positions.
• UseRecovery: Enable (true) or disable (false) the trade recovery system. Mechanism to manage trades. Evaluate risk carefully.
• AddInitialTrades: (Active if UseRecovery = true)
  • true : Adds initial positions during recovery. Potentially more active recovery.
  • false : Opens only the first initial trade for recovery. Potentially more controlled recovery.
• PropMode: Enable (true) or disable (false) proprietary trading firm features. Features for compliance.
• AllowLong: Enable (true) or disable (false) opening long (buy) positions.
• AllowShort: Enable (true) or disable (false) opening short (sell) positions.
• ClosedRecovery: (Active if UseRecovery = true) Enable (true) or disable (false) recovery for closed losing trades. Recovery consideration for past trades.
• Conservative: Enable (true) or disable (false) Conservative Mode. Recommended: set to true for simulated trade analysis before real orders.
• ConservativeLevel: (Active if Conservative = true) Number of simulated trades before real positions. Lower values: potentially more aggressive. Higher values: potentially more conservative. Recommended: 3.
• Correlation Filter: Filter correlated pairs to avoid simultaneous trading. (Recommended = true)
• Correlation Threshold: Correlation level for pair filtering. Higher value: broader filtering. Lower value: stricter filtering. Recommend: 0.5.

4. Money Management (MoneyManagement)

These settings control position sizing and risk parameters.

• initSize: Initial lot size when LotSizeType is FIXED.
• LotSizeType: Method for calculating lot sizes:
  • FIXED : Uses the static initSize.
  • DYNAMIC_PER_BALANCE : Scales lot size based on account balance and balancePerLot.
  • SIZE_BASED_ON_RISK : Calculates lot size based on RiskInPercent and Stop Loss. Risk-based position sizing.
• RiskInPercent: (Used with LotSizeType = SIZE_BASED_ON_RISK) Percentage of account balance risked per trade. Key risk control parameter.
• SizeMultiplierMode: Determines how lot sizes are adjusted in the recovery system:
  • NORMAL : Uses a fixed multiplier (LotMulti).
  • FIBONACCI : Adjusts using a Fibonacci-like sequence.
  • SQUARE : Adjusts using a square-based progression.
  • ACCELERATED_GROWTH : Two-tiered multiplier for varied scaling.
• LotMulti: Lot size multiplier for NORMAL SizeMultiplierMode.
• balancePerLot: Account balance per lot for DYNAMIC_PER_BALANCE LotSizeType.
• gridStepPips: Base spacing between recovery trades in pips.
• gridStepPipsMultiplier: Multiplier to increase gridStepPips at each recovery level.
• MaxSizeLimit: Absolute maximum lot size the EA will use. Safety limit for position size.
• maxLossPercent: (Only in PropMode = true) Daily maximum equity loss percentage to halt trading. Prop firm risk parameter.
• MaxAllowedDrawdown: Maximum drawdown percentage to halt initial trades (requires ActivateDrawdownCheck = true). Drawdown control.
• ActivateDrawdownCheck: Enable (true) or disable (false) drawdown check for initial trades.
• threshold, smallMultiplier, largeMultiplier: (Used with SizeMultiplierMode = ACCELERATED_GROWTH) Parameters for two-tiered lot size scaling. Customize accelerated growth behavior.

5. Stop Loss / Take Profit (SLTP)

• SLTPType: Method for setting Stop Loss (SL) and Take Profit (TP):
  • NO_SL_TP : No static SL/TP. Uses Hidden TP (see Trade Management).
  • RISK_PERCENTAGE : SL based on RiskPercentage, TP as ratio of SL (TPSLRatio).
  • FIXED_PIPS : Fixed pip values for SL (FixedSL) and TP (calculated using TPSLRatio).
  • SUPERTREND_BASED : SL and TP based on SuperTrend indicator.
  • ATR_BASED : SL and TP based on Average True Range (ATR) indicator.
  • Elastic_Net : Dynamic Stop Loss (potentially for recovery trades).
• FixedSL: Fixed Stop Loss in pips (FIXED_PIPS and RISK_PERCENTAGE modes).
• SuperTrendMultiplier: Multiplier for SuperTrend indicator (SUPERTREND_BASED mode).
• RiskPercentage: Risk percentage for SL calculation in RISK_PERCENTAGE mode.
• atrPeriod, atrMultiplier: Parameters for the ATR indicator (ATR_BASED mode).
• TPSLRatio: Take Profit to Stop Loss ratio. e.g., 2 means TP is twice the SL distance.
• ElasticNetMultiplier, ElasticNetATRPeriod: Parameters for Elastic Net Stop Loss (Elastic_Net mode). Customize dynamic stop loss behavior.

6. Trailing Stop (TrailingStop)

• UseTrailingStop: Enable (true) or disable (false) Trailing Stop. Feature to lock in profits.
• TrailingStopMode: Trailing Stop method:
  • 1 fixed : Fixed-pip Trailing Stop.
  • 2 SuperTrend : Based on SuperTrend indicator.
  • 3 ATR : Based on Average True Range (ATR) indicator.
  • 4 ParabolicSar : Based on Parabolic SAR indicator.
  • 5 PortfolioCoG : Portfolio Center of Gravity (CoG) Trailing Stop (for PortfolioMode).
• FixedTrailingStop: Fixed Trailing Stop value in pips (1 fixed mode).
• SARInitialAcceleration, SARMaxAcceleration, SARAccelerationStep: Parameters for Parabolic SAR indicator (4 ParabolicSar mode). Adjust SAR sensitivity.
• TrailingStopActivation: Profit (in pips) to activate Trailing Stop.
• CoGRiskFactor, CoGATRPeriod: Parameters for Portfolio CoG Trailing Stop (5 PortfolioCoG mode). Customize portfolio trailing stop.

7. Trade Management (TradeManagement)

Settings for overall trade management and Take Profit behavior.

• CurrencyMultiplierMode: Currency Multiplier adjustment method:
  • CM_NORMAL : No adjustment. Consistent Take Profit behavior.
  • CM_MODIFIED_EXPONENTIAL : Gradual adjustment. Potentially more conservative Take Profit.
  • CM_SMOOTH_DECAY : Smooth adjustment. Potentially balanced Take Profit behavior.
  • (Normal TP Value - consistent behavior, Exponential/Smooth adjustment - potentially more conservative)
• k: Adjustment parameter for CurrencyMultiplierMode (exponential or smooth). Higher values: potentially stronger adjustment.
• currencyMultiplier: Base Currency Multiplier for Take Profit calculations.
• VirtualcurrencyMultiplier: Currency Multiplier for simulated trades in Conservative Mode.
• minTradesToUseTP: Minimum open trades to activate Take Profit logic.
• PortfolioMode: Enable (true) or disable (false) Portfolio Mode. Portfolio-wide Take Profit management. May close multiple symbols together.
• AdjustTPByMarginLevel: Enable (true) or disable (false) Take Profit adjustment based on individual symbol margin level.
• AdjustTPByWholeMarginLevel: Enable (true) or disable (false) Take Profit adjustment based on overall account margin level.
• MarginLevelThreshold: Margin Level threshold (%) for Take Profit adjustments.
• exitafterbars: Enable (true) or disable (false) Exit After Bars feature.
• exitafterbarsvalue: Number of bars after which trades will be closed (if exitafterbars = true).
• TotalTrailingStopRatio: Ratio to activate the Hidden Trailing Stop.
• UseHiddenTrailingStop: Enable (true) or disable (false) Hidden Trailing Stop. Dynamic trailing stop not shown on chart.
• HiddenTrailingStopMode: Growth pattern for Hidden Trailing Stop:
  • 1 Cubic Growth
  • 2 Sigmoid growth Growth
  • 3 Parabolic growth

8. News Filter (News)

• NewsFilter: Enable (true) or disable (false) News Filter. Recommended to avoid trading during significant news events.
• min_before: Minutes *before* news event to close existing trades.
• min_before_zero: Minutes *before* news event to close trades at zero profit (break-even).
• min_after: Minutes *after* news event to pause new trading.
• include_high, include_medium, include_low: News impact levels to include in the filter.
• use_title: Enable (true) or disable (false) filtering by news event titles.
• title_phrase: Keywords for title-based news filtering (if use_title = true).
• news_update_hour: Frequency (in hours) to update the news calendar.
• symbol_type: Method for news currency checking:
  • type1 Chart Symbol : News for the chart's currency pair.
  • type2 Custom Symbols : News for a custom currency list.
• news_symbols: Custom currencies for news filtering (comma-separated) if symbol_type = type2.
• close_only_news_pair: If true, only close trades on the currency pair directly related to news. If false, broader trade management during news.
• draw_news_lines: Enable (true) or disable (false) vertical lines for news events on the chart.
• Line_Color, Line_Style, Line_Width: Appearance of news event lines.

9. Order Management for NEWS (info2)

• close_open: Immediately close *all* open trades (true). Use with extreme caution!
• close_pending: Delete *all* pending orders (true). Use with caution!
• close_zero: Close profitable trades. (true). Use with caution!
• close_profit: Account currency profit level to activate close_zero.

10. Notifications and Alerts For NEWS (info3)

• send_notif: Enable (true) or disable (false) push notifications.
• send_alert: Enable (true) or disable (false) pop-up alerts on your trading terminal.
• delay: Delay (in seconds) for internal error handling.