Invalid Stop Loss Value Required

This message indicates that the stop loss value provided in the request is invalid because a relative (percent or amount), absolute (stopPrice / limitPrice as applicable), or portfolio PnL (pnlAmount) stop loss value is required (for non-trailing stops). TradersPost requires that one of these parameters be specified. Without a value for any of these modes, the request will not be processed.

For trailing stops, use stopLoss.type trailing_stop with trailAmount or trailPercent instead; PnL-based stop loss does not apply to trailing stops.

Invalid stop loss example where type is set but no stop loss value is provided:

{
    "ticker": "AAPL",
    "action": "buy",
    "orderType": "limit",
    "limitPrice": 100,
    "stopLoss": {
        "type": "stop"
    }
}

Valid stop loss value example (relative percent):

{
    "ticker": "AAPL",
    "action": "buy",
    "orderType": "limit",
    "limitPrice": 100,
    "stopLoss": {
        "type": "stop",
        "percent": "5"
    }
}

Valid stop loss value example (relative amount):

{
    "ticker": "AAPL",
    "action": "buy",
    "orderType": "limit",
    "limitPrice": 100,
    "stopLoss": {
        "type": "stop",
        "amount": "5"
    }
}

Valid stop loss value example (absolute stopPrice):

{
    "ticker": "AAPL",
    "action": "buy",
    "orderType": "limit",
    "limitPrice": 100,
    "stopLoss": {
        "type": "stop",
        "stopPrice": "95"
    }
}

Valid portfolio PnL stopLoss.pnlAmount example (dollar loss cap; TradersPost converts it using entry quantity calculated before the order is sent to the broker and the symbol's point value - for futures, dollar value per price point from the quote; for options, the contract multiplier (100 per contract for standard equity options)). Use with stop or stop_limit only; not trailing_stop:

{
    "ticker": "AAPL",
    "action": "buy",
    "orderType": "limit",
    "limitPrice": 100,
    "stopLoss": {
        "type": "stop",
        "pnlAmount": 100
    }
}

In the above examples, a valid stop loss order uses one appropriate mode. Combining pnlAmount with percent, amount, or absolute stop fields returns an error that stopLoss.pnlAmount cannot be combined with those fields.