When building bots in Profectus.AI, you’ll often see options for Price Level, Price Range, or Price Fraction. These terms may look similar but they mean different things — and knowing the difference is key to defining entries, stop-losses, and custom calculations.
1. Price Level
A price level is a single value taken directly from the market.
Examples:
The high of a specific candle (e.g., candle ID 1 → High).
The current Bid, Ask, or Mid price.
A value fetched from an indicator (e.g., Moving Average = 1.2345).
👉 See the example below how a price level (here: Candle high) can be stored in a variable.
2. Price Range
A price range is the difference between two levels.
Examples:
The distance between a candle’s high and low.
The highest high minus the lowest low over a session (e.g., between 3:00 and 4:30 AM).
The current price – entry price (floating profit in pips).
👉 See this example file how price ranges can be calculated and stored in a variable.
3. Price Fraction
A price fraction is a relative size of a range — often expressed as a percentage or ratio.
Examples:
ATR (Average True Range) → the average range of recent candles.
Wick size relative to total candle size (upper wick ÷ total candle).
% of Take Profit (e.g., SL set to 50% of TP).
👉 See this example file how price fractions, such as the value of the 'Average True Range' indicator can be stored in a variable and used as a stop loss.
FYI: This is just an example for how to use price fraction. If you want to use the ATR as your stop loss or take profit, there is a default function within the 'Buy now' / 'Sell Now' blocks.
Practical Example: ATR with Multiplier
Suppose you want to use the ATR as your stop-loss with a multiplier (e.g., 2 × ATR).
Open the Buy or Sell block
Navigate to the Stop-loss section and select Custom (price fraction) in Mode
Select Indicator and select Average True Range
Expand the menu by clicking on Adjust and select the "*" arithmetic and enter 2 in the field for a 2 x ATR stoploss multiplier.
Best Practices
Price Levels → single points (high, low, Bid, Ask).
Price Ranges → differences (high – low).
Price Fractions → ratios and relative measures (ATR, wick/body ratio).
Always store values in variables if you plan to reuse them across blocks.
When in doubt, run a quick backtest in visual mode to confirm the calculation works as expected.
Recap
Levels = one point.
Ranges = distance between two points.
Fractions = scaled values of a range.
These three concepts are the building blocks of most logic in Profectus.AI. Master them once, and you’ll be able to design entries, exits, and management rules with precision.