Skip to main content

How to use 'Market Property' in a 'Trade Rule' Block

Learn how to use Market Property in a Trade Rule Block, including current bid/ask price, highest or lowest price in a candle period, start and end candle IDs, time ranges, start range fields, and price value selection.

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.


Did this answer your question?