Entry bid-ask spread filter

The Entry bid-ask spread filter sets a maximum allowed bid-ask spread for entry orders (including opening a long with buy or opening a short with sell when your strategy allows that side). If the current spread for the symbol exceeds this cap when an entry is planned, the entry order is rejected to reduce the chance of fills in illiquid or very wide-spread conditions.

The value is a positive dollar amount (for example 0.02 means $0.02). Leave blank to disable the entry filter.

Spread is evaluated from live bid and ask on the quote used for that entry. This feature requires market data (quotes) from your broker; if the broker does not support quotes, the filter is not applied.

The exit bid-ask spread filter is separate: setting one does not set the other, and the entry filter does not apply when planning an exit.

Webhook bidAskSpreadFilter (entry)

Payloads may include bidAskSpreadFilter for a per-signal spread cap. The same key is documented on the Exit bid-ask spread filter page for exit planning; only the relevant cap is evaluated for the current phase.

The effective entry cap comes from the webhook when either:

• Allow signal overrides is enabled on the strategy or subscription, or
• Allow signal override is enabled for Entry bid-ask spread filter

If signal values are allowed for this field and the payload includes bidAskSpreadFilter, that amount is the entry cap. If signal values are allowed but the payload omits bidAskSpreadFilter, the configured Entry bid-ask spread filter in the strategy or subscription is used.

If neither Allow signal overrides nor Allow signal override for Entry bid-ask spread filter is enabled, bidAskSpreadFilter in the webhook is ignored for entry planning and only the configured Entry bid-ask spread filter applies.

Example webhook payloads

Entry using only the strategy’s configured entry spread filter (no per-signal value):

{
    "ticker": "AAPL",
    "action": "buy",
    "orderType": "limit",
    "limitPrice": 150
}

Entry with a per-signal cap (requires Allow signal overrides and/or Allow signal override for Entry bid-ask spread filter as above):

{
    "ticker": "AAPL",
    "action": "buy",
    "orderType": "limit",
    "limitPrice": 150,
    "bidAskSpreadFilter": 0.02
}