Entry bid-ask spread filter amount

The Entry bid-ask spread filter amount 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) as a fixed amount in the symbol’s quote currency (for example 0.02 is 0.02 in that currency—often $0.02 on a USD-quoted stock). If the current spread 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.

Select $ above the input to use this mode, or None to disable the filter. Entry bid-ask spread filter percent is the alternate percent cap; only one unit is active on the strategy or subscription at a time.

Spread is evaluated from live bid and ask on the quote used for that entry. In dollar mode, TradersPost compares the absolute bid–ask width (|ask − bid|) against your configured maximum. This feature requires market data (quotes) from your broker; if the broker does not support quotes, the filter is not applied (entries are not blocked for spread).

The exit bid-ask spread filters are separate: see Exit bid-ask spread filter amount and Exit bid-ask spread filter percent.

Webhook bidAskSpreadFilter (entry)

Payloads may include bidAskSpreadFilter (dollar amount in the quote currency) for a per-signal spread cap. Sending both bidAskSpreadFilter and bidAskSpreadFilterPercent in the same payload is rejected.

The effective entry cap is taken from the webhook when either:

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

When those conditions apply and the payload includes bidAskSpreadFilter, the dollar amount is the entry cap and the subscription’s configured percent is ignored for that signal. When they apply and the payload includes bidAskSpreadFilterPercent instead, the percent is the entry cap and the configured dollar amount is ignored. When they apply but the payload omits both keys, the configured Entry bid-ask spread filter amount or Entry bid-ask spread filter percent on the strategy or subscription is used (whichever mode is selected there).

If neither Allow signal overrides nor Allow signal override for Allow signal entry bid-ask spread filter is enabled, both keys in the webhook are ignored for entry planning and only the strategy or subscription’s configured entry spread filter applies.

Example webhook payloads

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

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

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

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