Entry bid-ask spread filter percent

The Entry bid-ask spread filter percent 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 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 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 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 entry. 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 (entries are not blocked for spread).

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

Webhook bidAskSpreadFilterPercent (entry)

Payloads may include bidAskSpreadFilterPercent for a per-signal percent spread cap. Sending both bidAskSpreadFilter (dollar amount) 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 bidAskSpreadFilterPercent, the percent is the entry 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 entry cap and the configured percent is ignored. When they apply but the payload omits both keys, the configured Entry bid-ask spread filter percent or Entry 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 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 as a percent (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,
    "bidAskSpreadFilterPercent": 0.5
}