Set TP/SL

Sets or updates take-profit (TP) and stop-loss (SL) prices for an existing order or open position.

Invalid TP/SL placement may close your position immediately

If your TP or SL levels are set on the wrong side of the current price, they may trigger instantly and close your position.

• Long position: TP below or SL above the current price → may trigger immediately

• Short position: TP above or SL below the current price → may trigger immediately

This endpoint allows users to modify an existing order by attaching or updating take-profit and stop-loss prices.

You must specify both the symbol and the orderId of the target order.

If TP or SL prices are provided, they will be linked to the active order or open position for automated risk management.

If a field is omitted or set to null, that parameter remains unchanged.

Authentication with a valid API key and trade permission scope is required.

Set TP/SL

put

Required scopes

This endpoint requires the following scopes:

Authorizations

thirdPartyApiKeyAuth

api-keystringRequired

For third party retail API users

Body

application/json

symbolstringRequired

Trading symbol

Example: BTCUSDT.PERPPattern: ^[A-Z0-9]+(\.[A-Z0-9]+)?$

orderIdstring · uuidRequired

newTakeProfitPricestring · nullableOptional

the price set to close the position for a profit.

Example: ###.###

newStopLossPricestring · nullableOptional

the price set to close the position to limit losses.

Example: ###.###

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

put

/api/v1/trade/order

HTTPcURLJavaScriptPython

PUT /api/v1/trade/order HTTP/1.1
Host: trading-api.flipster.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 134

{
  "symbol": "BTCUSDT.PERP",
  "orderId": "123e4567-e89b-12d3-a456-426614174000",
  "newTakeProfitPrice": "###.###",
  "newStopLossPrice": "###.###"
}

{
  "order": {
    "orderId": "123e4567-e89b-12d3-a456-426614174000",
    "symbol": "BTCUSDT.PERP",
    "side": "BUY",
    "orderType": "MARKET",
    "quantity": "###.###",
    "amount": "###.###",
    "price": "###.###",
    "triggerPrice": "###.###",
    "status": "PENDING_NEW",
    "timeInForce": "FOK",
    "takeProfitPrice": "###.###",
    "stopLossPrice": "###.###",
    "leavesQty": "###.###"
  }
}