feat: createTakeProfitStopLossOrder tool handles and/or

Author: coccoinomane

projects/binance/README.md

@@ -22,13 +22,19 @@ Integration between HeyAnon.ai and Binance Spot and Futures trading.
 
     - Market buy 1 BTC with USDT on @binance
     - Buy 1 BTC at 40000 USDT on @binance
+    - Sell half of my BTC at 40000 USDT on @binance
 
-1. **Trigger orders**
+1. **Conditional orders**
 
     - Market buy 1 BTC on @binance when the price goes below 50000 USDT
     - Buy 1 BTC at 45000 USDT on @binance when the price goes below 50000 USDT
     - Sell 100 USDT for BTC for 10% profit on @binance
 
+1. **Take profit & stop loss (OCO)**
+
+    - Sell 0.01 BTC with a 10% take profit and a 15% stop loss on @binance
+    - Sell all of my BTC with a 10% take profit and a 15% stop loss on @binance
+
 1. **Cancel orders**
 
     - Cancel all my orders on @binance

projects/binance/src/functions/createTakeProfitStopLossOrder.ts

@@ -1,6 +1,7 @@
 import { FunctionReturn, toResult } from '@heyanon/sdk';
 import { FunctionOptionsWithExchange } from '../overrides';
-import { createBinanceOcoOrder } from '../helpers/orders';
+import { createBinanceOcoOrder, createTriggerOrder } from '../helpers/orders';
+import { formatOrderSingleLine } from '../helpers/format';
 
 interface Props {
     market: string;
@@ -13,15 +14,15 @@ interface Props {
 }
 
 /**
- * Create two orders: a take profit order and a stop loss order, bundled together in
- * an OCO (one-cancels-the-other) order.
+ * Create take profit and/or stop loss orders.  If both are provided, they will be
+ * created as an OCO (one-cancels-the-other) order.
  *
  * @param {Object} props - The function input parameters
  * @param {string} props.market - Symbol of the market to trade, for example "BTC/USDT" or "AAVE/ETH"
  * @param {'buy' | 'sell'} props.side - Side of the order; either "buy" or "sell"
  * @param {number} props.amount - Amount of base currency to buy or sell
- * @param {number} props.takeProfitTriggerPrice - Price at which the take profit order will be activated
- * @param {number} props.stopLossTriggerPrice - Price at which the stop loss order will be activated
+ * @param {number|null} props.takeProfitTriggerPrice - Price at which the take profit order will be activated
+ * @param {number|null} props.stopLossTriggerPrice - Price at which the stop loss order will be activated
  * @param {number|null} props.takeProfitLimitPrice - Price for limit orders (optional)
  * @param {number|null} props.stopLossLimitPrice - Price for limit orders (optional)
  * @param {FunctionOptions} options
@@ -31,21 +32,52 @@ export async function createTakeProfitStopLossOrder(
     { market, side, amount, takeProfitTriggerPrice, takeProfitLimitPrice, stopLossTriggerPrice, stopLossLimitPrice }: Props,
     { exchange }: FunctionOptionsWithExchange,
 ): Promise<FunctionReturn> {
-    try {
-        await createBinanceOcoOrder(
-            exchange,
-            market,
-            side,
-            amount,
-            takeProfitTriggerPrice,
-            stopLossTriggerPrice,
-            takeProfitLimitPrice ?? undefined,
-            stopLossLimitPrice ?? undefined,
-        );
-        return toResult(`Successfully created order`);
-        // return toResult(`Successfully created ${formatOrderSingleLine(order, undefined, false)}`);
-    } catch (error) {
-        console.error(error);
-        return toResult(`Error creating order: ${error}`, true);
+    // We need a trigger price
+    if (!takeProfitTriggerPrice && !stopLossTriggerPrice) {
+        return toResult(`Error: Either take profit or stop loss trigger price must be provided`, true);
+    }
+    // Trigger prices cannot be the same
+    if (takeProfitTriggerPrice && stopLossTriggerPrice && takeProfitTriggerPrice === stopLossTriggerPrice) {
+        return toResult(`Error: The take profit and stop loss trigger prices cannot be the same`, true);
+    }
+    // Case of a take profit order
+    if (takeProfitTriggerPrice && !stopLossTriggerPrice) {
+        try {
+            const order = await createTriggerOrder(exchange, market, side, amount, takeProfitTriggerPrice, takeProfitLimitPrice === null ? undefined : takeProfitLimitPrice);
+            return toResult(`Successfully created ${formatOrderSingleLine(order, undefined, false)}`);
+        } catch (error) {
+            console.error(error);
+            return toResult(`Error creating take profit order: ${error}`, true);
+        }
+    }
+    // Case of a stop loss order
+    if (!takeProfitTriggerPrice && stopLossTriggerPrice) {
+        try {
+            const order = await createTriggerOrder(exchange, market, side, amount, stopLossTriggerPrice, stopLossLimitPrice === null ? undefined : stopLossLimitPrice);
+            return toResult(`Successfully created ${formatOrderSingleLine(order, undefined, false)}`);
+        } catch (error) {
+            console.error(error);
+            return toResult(`Error creating stop loss order: ${error}`, true);
+        }
+    }
+    // Case of a take profit AND stop loss order (OCO)
+    else {
+        try {
+            await createBinanceOcoOrder(
+                exchange,
+                market,
+                side,
+                amount,
+                takeProfitTriggerPrice,
+                stopLossTriggerPrice,
+                takeProfitLimitPrice ?? undefined,
+                stopLossLimitPrice ?? undefined,
+            );
+            return toResult(`Successfully created order`);
+            // return toResult(`Successfully created ${formatOrderSingleLine(order, undefined, false)}`);
+        } catch (error) {
+            console.error(error);
+            return toResult(`Error creating OCO order: ${error}`, true);
+        }
     }
 }

projects/binance/src/tools.ts

@@ -66,7 +66,7 @@ export const tools: AiTool[] = [
     },
     {
         name: 'createTakeProfitStopLossOrder',
-        description: 'Create two orders: a take profit order and a stop loss order.',
+        description: 'Create take profit and/or stop loss orders.  If both are provided, they will be created as an OCO (one-cancels-the-other) order.',
         required: ['market', 'side', 'amount', 'takeProfitTriggerPrice', 'takeProfitLimitPrice', 'stopLossTriggerPrice', 'stopLossLimitPrice'],
         props: [
             {
@@ -87,8 +87,8 @@ export const tools: AiTool[] = [
             },
             {
                 name: 'takeProfitTriggerPrice',
-                type: 'number',
-                description: 'Price at which the take profit order will be activated',
+                type: ['number', 'null'],
+                description: 'Price at which the take profit order will be activated.  If not specified, the take profit order will not be created.',
             },
             {
                 name: 'takeProfitLimitPrice',
@@ -97,8 +97,8 @@ export const tools: AiTool[] = [
             },
             {
                 name: 'stopLossTriggerPrice',
-                type: 'number',
-                description: 'Price at which the stop loss order will be activated',
+                type: ['number', 'null'],
+                description: 'Price at which the stop loss order will be activated.  If not specified, the stop loss order will not be created.',
             },
             {
                 name: 'stopLossLimitPrice',