Exit bid-ask spread filter percent

The Exit bid-ask spread filter percent sets a maximum allowed bid-ask spread for exit orders (closing a long or covering a short) as a percent cap on the bid–ask spread (for example 0.5 means 0.5%—the same units TradersPost uses when it compares live spread to your cap). If the current spread exceeds this cap when an exit is planned, the exit 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. Exit bid-ask spread filter amount is the alternate dollar-threshold mode; 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 exit. The live spread percentage is |ask − bid| / midpoint × 100, where midpoint is (ask + bid) / 2 when that value is non-zero, so long and short are treated the same way. If the midpoint is zero, TradersPost uses the quote mark as the denominator when it is non-zero. This feature requires market data (quotes) from your broker; if the broker does not support quotes, the filter is not applied (exits are not blocked for spread).

The entry bid-ask spread filters are separate: see Entry bid-ask spread filter percent and Entry bid-ask spread filter amount.

Webhook bidAskSpreadFilterPercent (exit)

For action: "exit" (and equivalent exit signals), the webhook may send bidAskSpreadFilterPercent to cap spread for that exit as a percent. Sending both bidAskSpreadFilter (dollar amount) and bidAskSpreadFilterPercent in the same payload is rejected.

The effective exit 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 exit bid-ask spread filter is enabled

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

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

Example webhook payloads

Exit using only the configured exit spread filter:

{
    "ticker": "AAPL",
    "action": "exit"
}

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

{
    "ticker": "AAPL",
    "action": "exit",
    "bidAskSpreadFilterPercent": 0.5
}