TP/SL

The tpSl action creates take-profit (TP) and stop-loss (SL) trigger orders for an existing position. Unlike regular orders, TP/SL orders do not consume margin when created — they sit dormant and automatically place a real closing order when the market reaches the trigger price. The action has two forms:

Position-level TP/SL (isPositionTpsl: true) — set a TP only, an SL only, or both in one request. The closing direction is determined automatically from the position side, and the position must already exist.
Standalone trigger order (isPositionTpsl: false with orderSide) — places an order when the trigger fires, for example a breakout entry. It takes exactly one of tpPrice / slPrice, and can carry an openTp* / openSl* group that sets the TP/SL of the order placed after it fires.

Endpoint

POST https://upsidemax.xyz/exchange

Request

All requests must include an ECDSA signature and a millisecond-precision nonce.

{
  "action": {
    "type": "tpSl",
    "a": 1,
    "positionSide": 0,
    "isPositionTpsl": true,
    "tpPrice": "90000",
    "slPrice": "80000",
    "tpLimitPrice": "90000",
    "slLimitPrice": "80000",
    "tpSize": "0",
    "slSize": "0",
    "tpTriggerType": 0,
    "slTriggerType": 0,
    "tpOrderType": 1,
    "slOrderType": 1
  },
  "signature": { "r": "0x...", "s": "0x...", "v": 28 },
  "nonce": 1778858600000
}

A standalone trigger order that buys when the mark price falls to the slPrice level, and whose resulting order carries its own take-profit and stop-loss:

{
  "action": {
    "type": "tpSl",
    "a": 1,
    "isPositionTpsl": false,
    "orderSide": "B",
    "reduceOnly": false,
    "slPrice": "80000",
    "slLimitPrice": "79900",
    "slSize": "1",
    "slOrderType": 1,
    "openTpPrice": "95000",
    "openTpLimitPrice": "94900",
    "openTpSize": "0",
    "openTpTriggerType": 0,
    "openTpOrderType": 1,
    "openSlPrice": "70000",
    "openSlLimitPrice": "69900",
    "openSlSize": "0",
    "openSlTriggerType": 0,
    "openSlOrderType": 2
  },
  "signature": { "r": "0x...", "s": "0x...", "v": 28 },
  "nonce": 1778858600001
}

slPrice and openSlPrice are two different layers: slPrice is when this conditional order fires; openSlPrice is the stop-loss of the order placed after it fires.

Action fields

string

required

type (required) — Fixed value: "tpSl".

int32

required

a (required) — The contract ID the TP/SL orders apply to.

int8

positionSide — Identifies the position side: 0 = ONE_WAY, 1 = LONG, 2 = SHORT. Defaults to 0.

boolean

isPositionTpsl — When true, creates position-level TP/SL orders that automatically close the position when triggered. When false, creates standalone trigger orders. Defaults to false.

string

orderSide — The side of the order placed when the trigger fires: "B" = buy, "S" = sell. Used only for standalone trigger orders (isPositionTpsl = false); for position-level TP/SL the closing direction is inferred automatically.

boolean

reduceOnly — When true, the triggered order is marked reduce-only and will only execute if it reduces an open position. Defaults to false.

string

tpPrice — Trigger price for the take-profit leg, as a raw integer string. Set to "0" or omit to skip the TP leg. With isPositionTpsl: true, at least one of tpPrice / slPrice must be greater than "0", and both may be. With isPositionTpsl: false, exactly one of them must be greater than "0".

string

slPrice — Trigger price for the stop-loss leg. Set to "0" or omit to skip the SL leg. Same rules as tpPrice.

string

tpLimitPrice — Execution price used once the TP triggers. Must be greater than zero. With tpOrderType set to limit it is the resting price of a GTC order; with market it is the price the IOC order may cross to, computed as mark price ± your slippage allowance.

string

slLimitPrice — Execution price used once the SL triggers. Must be greater than zero, with the same meaning as tpLimitPrice.

A market-type TP/SL still requires a positive execution price. "0" is not accepted as shorthand for “close at market” — supply the price you are willing to cross to.

string

tpSize — The position size to close when the TP triggers. "0" = close the entire position.

string

slSize — The position size to close when the SL triggers. "0" = close the entire position.

int8

tpTriggerType — The price feed used to evaluate the TP trigger: 0 = mark price, 1 = oracle price. Defaults to 0. Only these two values are accepted — any other value is rejected with invalid tp/sl trigger type.

int8

slTriggerType — The price feed used to evaluate the SL trigger: 0 = mark price, 1 = oracle price. Defaults to 0. Same restriction as tpTriggerType.

int8

tpOrderType — Type of order placed when the TP triggers: 1 = limit, 2 = market. Required whenever tpPrice is greater than "0", and must be omitted or 0 when the TP leg is unset.

int8

slOrderType — Type of order placed when the SL triggers: 1 = limit, 2 = market. Required whenever slPrice is set, with the same rule as tpOrderType.

A standalone trigger order is exactly one leg. With isPositionTpsl: false, setting both tpPrice and slPrice returns 400 INVALID_PARAM (reason TOO_MANY). To place two standalone triggers, send two requests. Position-level TP/SL is not limited this way.

Open TP/SL fields

These fields set the take-profit and stop-loss of the order placed after a standalone trigger fires. They are accepted only with isPositionTpsl: false; a position-level request that carries them is rejected, because a position TP/SL closes a position rather than opening one. Each leg follows the same rules as the tp* / sl* legs above.

string

openTpPrice — Take-profit trigger price of the resulting order. "0" or omitted sets none.

string

openTpLimitPrice — Execution price once that take-profit triggers, greater than zero. Same meaning as tpLimitPrice.

string

openTpSize — Quantity that take-profit closes. "0" closes the entire position.

int8

openTpTriggerType — Price source for that trigger: 0 = mark price, 1 = oracle price.

int8

openTpOrderType — Order type placed when that take-profit triggers: 1 = limit, 2 = market. Required whenever openTpPrice is greater than "0".

string

openSlPrice — Stop-loss trigger price of the resulting order. Mirrors openTpPrice.

string

openSlLimitPrice — Execution price once that stop-loss triggers. Mirrors openTpLimitPrice.

string

openSlSize — Quantity that stop-loss closes. Mirrors openTpSize.

int8

openSlTriggerType — Price source for that trigger. Mirrors openTpTriggerType.

int8

openSlOrderType — Order type placed when that stop-loss triggers. Mirrors openTpOrderType.

Response

Success

{
  "status": "ok",
  "response": {
    "type": "tpSl",
    "data": { "tpOrderId": 123, "slOrderId": 124 }
  }
}

Rejection

A rejected request still returns HTTP 200 with status: "ok", carrying errorCode and errorMessage inside response.data. Common causes are no open position, both tpPrice and slPrice at "0", not being enrolled in the market deployer, an unknown contract, and a position-level request that carries openTp* / openSl* fields.

Response fields

int64

The order ID assigned to the take-profit trigger order. Returns 0 if the TP leg was not set (i.e., tpPrice was "0").

int64

The order ID assigned to the stop-loss trigger order. Returns 0 if the SL leg was not set (i.e., slPrice was "0").

number

Present only when the request is rejected; a non-zero value means nothing was created.

string

Present together with errorCode. The rejection reason.

Save the returned tpOrderId and slOrderId values if you need to cancel individual legs later using cancelConditional. To cancel all TP/SL orders for a position at once, use cancelTpSl.

Errors

HTTP	`code`	Cause
400	`INVALID_PARAM`	A field failed validation — for example both `tpPrice` and `slPrice` on a standalone trigger (reason `TOO_MANY`). `errors[]` names the field, the `reason`, and the `expected` value. Nothing is created.
400	`BAD_REQUEST`	Malformed body, or the signer has no registered account.
400	`SYNC_NOT_APPLICABLE`	The envelope carried `sync`. This action always answers synchronously.
400	`DUPLICATE_NONCE`	A request with the same `nonce` from this signer is still in flight.
401	`SIGNATURE_INVALID`	Signature recovery failed or did not match.
429	`RATE_LIMITED`	Too many requests.
503	`DOWNSTREAM_UNAVAILABLE` / `WARMING_UP`	Temporarily unavailable; retry later.
504	`DOWNSTREAM_TIMEOUT`	No result within the waiting window. The trigger orders may already exist — reconcile before retrying; see Timeouts and retries.

Overview

Account

Orders

Margin & Leverage

Conditional Orders

Collateral Transfers

API Wallet

Endpoint

Request

Action fields

Open TP/SL fields

Response

Success

Rejection

Response fields

Errors

​Endpoint

​Request

​Action fields

​Open TP/SL fields

​Response

​Success

​Rejection

​Response fields

​Errors

Endpoint

Request

Action fields

Open TP/SL fields

Response

Success

Rejection

Response fields

Errors