# Update Bot

**Update existing bot**

<mark style="color:green;">**`POST`**</mark> **`https://api.aitrade.com/api/bots/{bot_id}`**

**Request Body**

<table><thead><tr><th width="241">Name</th><th width="121">Type</th><th width="109" data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td>exchange_pair_id</td><td>integer</td><td>false</td><td>A unique ID to identify the pair. Refer <a href="/pages/JTqVYPFsrzMdDy4isGwh">Trading Pairs</a> Api to get the list of pairs available. <code>pair_id</code> of a pair object is passed as <code>exchange_pair_id</code></td></tr><tr><td>stock_code</td><td>string</td><td>false</td><td>Stock symbol</td></tr><tr><td>initial_fund</td><td>float</td><td>false</td><td>Fund allocation for the bot</td></tr><tr><td>frequency</td><td>integer</td><td>false</td><td>options are, 1,5,15,60,240,1440</td></tr><tr><td>base_order_type</td><td>string</td><td>false</td><td>Options <code>static</code>, <code>dynamic</code>. Static will always use the same Base Order Limit set, regardless of the bots performance. Dynamic allows the bot to use profits from it’s previous trades for it’s next trade or lowers the base order if it has encountered a loss previously</td></tr><tr><td>order_type</td><td>string</td><td>false</td><td>Options are <code>limit</code>,<code>market</code> . Limit order is normally used to ensure price level especially when your take profit level is small. Market order is typically used when you need to ensure immediate Filled condition</td></tr><tr><td>base_order_percentage</td><td>integer</td><td>false</td><td>Base order limt</td></tr><tr><td>profit</td><td>float</td><td>false</td><td>take profit percentage</td></tr><tr><td>stop_loss</td><td>float</td><td>false</td><td>Stop loss percentage</td></tr><tr><td>name</td><td>string</td><td>false</td><td>A name to identify the bot created</td></tr><tr><td>bot_indicators</td><td>Object</td><td>false</td><td>An object containing the indicators.<a data-footnote-ref href="#user-content-fn-1"><br></a>Please refer to <strong>Bot Indicator Parameter Sample</strong> </td></tr><tr><td>indicator_triggers_entry</td><td>integer</td><td>false</td><td>Number of entry indicators</td></tr><tr><td>indicator_triggers_exit</td><td>integer</td><td>false</td><td>Number of exit indicators</td></tr><tr><td>category</td><td>string</td><td>false</td><td><code>manual</code>, <code>marketplace</code>, <code>marketplace_custom</code></td></tr><tr><td>apply_to_current_deal</td><td>integer</td><td>false</td><td>Options are 0 or 1</td></tr></tbody></table>

**Bot Indicator Parameter Sample**

Both exit and entry indicators are send together as an array of an object . To get the default available indicators please refer to [Indicators API](/bot-execution/indicators.md)

Several indicators support settings that require more than two values. In such cases, utilize `value3`, `value4`, `value5,` and `value6` accordingly. If a setting does not apply to a specific indicator, pass `null`

```javascript
   {
        "id": null, // Id null when creating new and is returned after creating bot. Has to pass id when updating 
        "name": "EMA",
        "description": null,
        "period_num": 50,
        "value2": 9,
        "value3": null, // null if there is no values for the indicator setting
        "value4": null,
        "value5": null,
        "value6": null,
        "updated_at": null,
        "created_at": null,
        "indicator_id": 2, // should match the id of the indicator from indicator api. 
        "type": "entry"
    },
    {
        "id": null,
        "name": "Stochastic RSI",
        "description": null,
        "period_num": 14,
        "value2": 18.5,
        "value3": 81.5,
        "value4": 1,
        "value5": 18.5,
        "value6": 81.5,
        "updated_at": null,
        "created_at": null,
        "indicator_id": 3,
        "type": "exit"
    }
]
```

**Responses:**

* **Success (200)**: Returns the details of the bot that has been created or updated. Details include ID, name, status, and other specific settings.
* **Failure (401)**: Unauthenticated, indicating you're not logged in or lack permission to carry out the request.
* **Failure (500)**: Server error.&#x20;

{% tabs %}
{% tab title="200  successfully returned" %}

```javascript
{
    "code": 200,
    "message": "Success",
    "bot": {
        "id": 13331,
        "user_id": 1,
        "name": "New Bot",
        "status": "active",
        "frequency": 15,
        "exchange_pair_id": 2,
        "strategy": "Long",
        "initial_fund": 1000,
        "base_order_percentage": 50,
        "base_order_type": "static",
        "extra_order_percentage": 25,
        "stop_loss": 0,
        "updated_at": "2024-03-26 16:13:59",
        "created_at": "2024-03-26 16:13:59",
        "pair_id": 1,
        "order_type": "market",
        "indicators":[],
        "category":"manual",
    }
}
```

{% endtab %}

{% tab title="401 Unauthenticated" %}

```
{
  "code": 401,
  "success": false,
  "message": "Unauthenticated."
}
```

{% endtab %}
{% endtabs %}

[^1]: Bot&#x20;


---

# 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://apidocs-ga092.stockhero.ai/bot-execution/update-bot.md?ask=<question>
```

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.