# Rasa Solver TP/SL Implementation Rasa’s conditional orders handler lets you set take-profit and stop-losses to an existing position. Instead of polling and closing positions manually, you send a conditional order to Rasa and it will automatically request the close when your trigger price is hit. This version of the API: * Uses the **instant trading login flow** (no more manual JSON signing) * Requires **MultiAccount delegation** so Rasa can request closes on your behalf * Supports **multiple conditional orders per quote** (e.g. one TP and one SL) **Base URL** ``` https://conditional-orders-handler.rasa.capital/api/v4/ ``` Before sending TP/SL orders, you must have: 1. **MultiAccount delegation set up** In your MultiAccount, you must delegate at least the following functions to the [Rasa PartyB address](/api-endpoints-and-deployments/solver-addresses-and-endpoints.md): * `requestToClosePosition(`**`0x501e891f`**`)` * `requestToCancelCloseRequest(`**`0xa63b9363`**`)` This lets Rasa submit/modify close requests on your sub-account when the TP/SL triggers. 1. **Instant trading login (Bearer token)** You must log in to the Rasa hedger using the **instant trading** flow (SIWE) and obtain an `access_token`. * See: [*Instant Trading / Login with Hedger*](/exchange-builder-documentation/frontend-builder-technical-guidance/instant-trading.md). * That token will be sent as `Authorization: Bearer ` when you call the conditional orders API. 2. **An open SYMMIO position (quote)** * You need a valid `quote_id` from an existing open position. * You must know: * `account_address` (PartyA sub-account) * `symbol_id` * `multi_account_address` * Rasa PartyB address for the chain (goes in `hedger_whitelist`). ## POST api/v4/ ### Request Payload Example payload for **one TP and one SL** on the same quote: ```json { "account_address": "0xB6492A3963DDa0910329787478df3Bb02C7b0DA3", "quote_id": 179921, "conditional_orders": [ { "quantity": "7.2", "price": "1.9683", "conditional_price": "2.1870", "conditional_price_type": "last_close", "order_type": 1, "position_type": 0, "conditional_order_type": "take_profit", "leverage": 1 }, { "quantity": "7.2", "price": "1.7808", "conditional_price": "1.9787", "conditional_price_type": "last_close", "order_type": 1, "position_type": 0, "conditional_order_type": "stop_loss", "leverage": 1 } ], "symbol_id": 4, "multi_account_address": "0x95605c64356572eb5C076Cb9c027c88b527A2059", "hedger_whitelist": [ "0x9206D9d8F7F1B212A4183827D20De32AF3A23c59" ] } ``` *** ### Request Fields: * **`account_address:`** \ PartyA sub-account address for this position (the MultiAccount child that owns the quote). * **`quote_id:`** The SYMMIO quote ID you want to attach TP/SL to (must be OPEN). * **`symbol_id:`** The SYMMIO symbol ID (e.g. XRP = `4` in your example). * **`multi_account_address:`** The MultiAccount contract address deployed by a frontend builder. * **`hedger_whitelist`**\ Array of PartyB addresses allowed to execute these conditional orders.\ For Rasa on Base, this is their PartyB address: ```json "hedger_whitelist": ["0x9206D9d8F7F1B212A4183827D20De32AF3A23c59"] ``` * **`conditional_orders`**\ Array of TP/SL instructions for this quote. You can send one or multiple (e.g. one TP + one SL). #### `conditional_orders[]` object Each object describes a single TP or SL: * **`quantity` (string) —** How much of the position should be closed when this order triggers. * **`price` (string)** – This is the **minimum price you’re willing to accept when closing**, after slippage. * For **LONGS**, a common pattern is: ``` price = conditional_price * (1 - slippage) ``` e.g. for 10% slippage: `price = conditional_price * 0.9` * For **SHORTS**, the direction is inverted: ``` price = conditional_price * (1 + slippage) ``` e.g. for 10% slippage: `price = conditional_price * 1.1` The solver will only close the trade if it can get at least this price (for longs) or at most this price (for shorts). * **`conditional_price` (string)** – The price level at which this TP/SL should attempt to close. * **`conditional_price_type` (string) —** How the trigger price is interpreted: * `"last_close"` – use the last close price feed for that symbol. * `"market`" — uses the market price for that symbol * **`order_type` (number) —** Order type used when closing: `1` for market orders, `2` for limit. * **`position_type` (number) —** The direction of the position: `0` – Long, `1` – Short. This is important because TP and SL logic, as well as slippage direction, depend on whether the position is long or short. * **`conditional_order_type` (string)** * `"take_profit"` – close when price moves **in your favor** to lock in gains. * `"stop_loss"` – close when price moves **against you** to cap losses. * **`leverage` (number)** The leverage used for the position. ### Authentication & Headers Before calling the conditional-orders API, you must **log in** to Rasa using the [instant-trading login](/exchange-builder-documentation/frontend-builder-technical-guidance/instant-trading/instant-login-eoa.md) flow and obtain an `access_token`. When sending the request: ```http POST https://conditional-orders-handler.rasa.capital/api/v4/ Content-Type: application/json Accept: application/json App-Name: Cloverfield # App Name Authorization: Bearer ``` ### Flow Summary 1. **Delegate permissions** via MultiAccount: Allow Rasa’s PartyB address to call `requestToClosePosition` and `requestToCancelCloseRequest` for your sub-account. 2. **Login to Rasa** via the instant-trading flow and get a Bearer token. 3. **Build your conditional orders payload** 4. **POST the payload** with the `Authorization: Bearer ` header. 5. When the market reaches your `conditional_price` and execution is possible above/below your `price` threshold. *** ## GET /api/v4/{quote\_id}/ You can query which TP/SL (or other conditional) orders are currently registered for a quote. **Endpoint** ```http GET https://conditional-orders-handler.rasa.capital/api/v4/{quote_id}/ Authorization: Bearer Accept: application/json ``` **Path params** * `quote_id` – the SYMMIO quote ID you want to inspect. **Example response** ```json [ { "quote_id": 179967, "party_a_address": "0xB6492A3963DDa0910329787478df3Bb02C7b0DA3", "symbol_id": 4, "conditional_order_type": "take_profit", "quantity": 7.2, "price": 2.2513, "conditional_order_price": 2.0466, "order_type": 1, "state": "new", "action_price_type": "last_close", "position_type": 1 } ] ``` *** ## DELETE /api/v4/{quote\_id}/{conditional\_order\_type} You can remove an existing TP, SL, or other conditional order for a quote. **Endpoint** ```http DELETE https://conditional-orders-handler.rasa.capital/api/v4/{quote_id}/{conditional_order_type} Authorization: Bearer Accept: application/json ``` **Path params** * `quote_id` – the quote ID of the conditional order you want to cancel. * `conditional_order_type` – one of: * `take_profit` * `stop_loss` This will cancel **that specific type** of conditional order for the quote.\ For example: * Cancel only the stop loss for quote `179921`: ```http DELETE https://conditional-orders-handler.rasa.capital/api/v4/179921/stop_loss Authorization: Bearer ``` * Cancel the take profit: ```http DELETE https://conditional-orders-handler.rasa.capital/api/v4/179921/take_profit Authorization: Bearer ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.symm.io/api-endpoints-and-deployments/solver-addresses-and-endpoints/rasa-capital/rasa-solver-tp-sl-implementation.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.