Use Market Property when you want your bot to read price data from the chart or market, such as the current bid/ask price, the highest price in a candle range, or the lowest price during a specific time range.
This is useful when building breakout logic, session high/low rules, price comparisons, or strategies that need to reference recent candles.
What is Market Property?
In a Trade Rule Block, the Market Property data type lets you fetch market-related values and compare them against another value.
For example, you can use it to check:
Is the current price above the highest price of the last 5 candles?
Is the current bid price below a previous session low?
Did price break above the highest point of a selected time period?
Available Market Property options
When you select Market Property, you can choose properties such as:
Current Ask Price
Current Bid Price
Mid Price
Highest Price in Candle Period
Lowest Price in Candle Period
Highest Price in Time Period
Lowest Price in Time Period
Current Ask, Bid, and Mid Price
Current Ask Price
The current ask price from your broker.
Current Bid Price
The current bid price from your broker.
Mid Price
The midpoint between bid and ask.
This can be useful when you do not want to use only bid or ask price in your logic.
Highest or Lowest Price in Candle Period
This is one of the most important Market Property options.
Use Highest Price in Candle Period or Lowest Price in Candle Period when you want to look back over a specific candle range and fetch the highest or lowest price inside that range.
Also known as:
highest price over last candles
lowest price over last candles
candle lookback range
recent candle high
recent candle low
start candle ID and end candle ID
How the candle range works
When you select Highest Price in Candle Period or Lowest Price in Candle Period, you need to define a candle range.
You do this with:
Start Candle ID
The candle where the lookback range starts.
This is usually the candle closest to the current price within your selected range.
End Candle ID
The candle where the lookback range ends.
This number should be higher than the Start Candle ID, because it looks further back to the left on the chart.
Example: Highest Price in the last 5 candles
Imagine you select:
Property: Highest Price in Candle Period
Start Candle ID: 1
End Candle ID: 5
What to get: Price Value
The bot now looks at the candle range from Candle ID 1 to Candle ID 5.
Within that range, it searches for the highest price.
The result is then used as a value in your trade rule.
For example:
Current price > Highest Price in Candle Period Start Candle ID: 1 End Candle ID: 5 What to get: Price Value
This means the bot checks whether the current price is above the highest price found in that selected candle range.
What does “What to get” mean?
After selecting a candle-period property, you can choose what value should be returned.
Depending on the property, you may see options such as:
Price Value
Time Value
Candle ID
For most trading rules using Highest Price or Lowest Price, you usually want to select:
Price Value
That means the bot returns the actual price level of the highest or lowest point inside the selected candle range.
Example:
If the highest price between Candle ID 1 and Candle ID 5 is 1.08650, then the Market Property returns:
1.08650
This value can then be compared against another value in your Trade Rule Block.
Example: Lowest Price in a Candle Period
You can use the same logic for lows.
Example setup:
Property: Lowest Price in Candle Period
Start Candle ID: 1
End Candle ID: 10
What to get: Price Value
The bot looks back from Candle ID 1 to Candle ID 10 and returns the lowest price found inside that range.
This is useful for logic such as:
Current price < Lowest Price in Candle Period
This could be used for a downside breakout condition.
Highest or Lowest Price in Time Period
Use Highest Price in Time Period or Lowest Price in Time Period when you want to find the highest or lowest price during a specific time window.
This is useful for session-based strategies, for example:
Asian session high
London session low
New York session breakout
Previous day range
Custom intraday time range
Time Source
You can choose which time source should be used.
Server Time
Uses your broker’s server time.
Chart Time
Uses the time shown on the chart.
Local Time
Uses the time from your computer, laptop, or VPS.
Important: make sure the selected time source matches the logic of your strategy. If your strategy is based on broker server time, use Server Time.
Define the time range
For time-period properties, you need to define the start and end of the time range.
Depending on your screen size and block setup, some fields may appear further down in the settings panel.
If you do not see fields such as Start Range, End Range, or time inputs immediately, scroll down inside the block settings panel.
This is a common point users miss.
Day Offset
The Day Offset lets you select how many days back the time range should apply.
Example:
Day Offset: 0
Means today.
Day Offset: 1
Means yesterday.
Day Offset: 5
Means 5 days ago.
Example: Highest Price in a Time Period
Example setup:
Property: Highest Price in Time Period
Time Source: Server Time
Start Range: 08:00
End Range: 10:00
Day Offset: 0
What to get: Price Value
The bot checks the selected time range and returns the highest price found between 08:00 and 10:00.
Adjusting the returned value
Some Market Property values can be adjusted after they are fetched.
You can use Adjust to:
Add
Subtract
Multiply
Divide
Example:
You fetch the highest price in the last 5 candles, then subtract a small value from it.
This can be useful when creating buffer zones, breakout thresholds, or slightly adjusted price levels.
Common use cases
Market Property is useful for:
Comparing current price against recent highs or lows
Building breakout strategies
Referencing session highs and lows
Creating price-based trade rules
Checking whether price moved above or below a previous range
Using recent candle highs/lows as dynamic levels
Common mistakes
The End Candle ID is lower than the Start Candle ID
The End Candle ID should normally be higher than the Start Candle ID because it looks further back on the chart.
Example:
Start Candle ID: 1 End Candle ID: 5
Good.
Start Candle ID: 5 End Candle ID: 1
Usually incorrect.
Selecting Time Value instead of Price Value
If you want the actual high or low price, select:
Price Value
Do not select Time Value unless you specifically want the time when that high or low happened.
Missing hidden fields in the UI
Some options may appear lower in the block settings panel.
If you are looking for fields such as:
Start Range
End Range
Time inputs
Day Offset
What to get
Scroll down inside the settings panel.
Using the wrong time source
If your broker server time differs from your local time, your time-period logic may behave differently than expected.
For most broker-based strategy logic, Server Time is usually the safest option.
