Edit Grid Bot

PATCH

/ver1/grid_bots/:id/manual

Permission: BOTS_WRITE

Security: SIGNED

Updates an existing Grid Bot using its ID.

---

Path Parameter

idintegerrequired

Unique 3Commas ID for this Grid Bot entity.

Body Parameters

nameintegerrequired

Grid Bot name specified by the user.

upper_pricenumberrequired

The maximum price of the trading range, above which the bot will not place sell orders.

lower_pricenumberrequired

The minimum price of the trading range, below which the bot will not place buy orders.

grids_quantitynumberrequired

The number of grid levels between the upper and lower price boundaries.

This value is limited based on the exchange’s rules for rates, limits, and leverage.

More attributes

grid_typestring

quantity_per_gridnumberrequired

upper_stop_loss_enabledboolean

upper_stop_loss_actionstring

upper_stop_loss_pricenumber

lower_stop_loss_enabledboolean

lower_stop_loss_actionstring

lower_stop_loss_pricenumber

leverage_typestring

leverage_custom_valuenumber

max_active_sell_linesinteger

trailing_up_enabledboolean

trailing_down_enabledboolean

expansion_down_enabledboolean

expansion_down_stop_pricenumberrequired

expansion_up_enabledboolean

expansion_up_stop_pricebooleanrequired

ignore_warningsboolean

notestring

Example Request

PATCH

/ver1/grid_bots/2291725/manual

{
  "name": "CHANGED USDT_BTCUSDT EXAMPLE",
  "upper_price": 70000.0,
  "lower_price": 56000.0,
  "quantity_per_grid": 150,
  "grids_quantity": 40,
  "order_currency_type": "quote",
  "profit_currency_type": "quote",
  "trailing_up_enabled": true,
  "trailing_down_enabled": false,
  "grid_type": "arithmetic",
  "expansion_down_enabled": true,
  "expansion_down_stop_price": 54000.0,
  "expansion_up_enabled": false,
  "lower_stop_loss_enabled": true,
  "lower_stop_loss_price": 50000.0,
  "lower_stop_loss_action": "stop_bot_and_close_position",
  "upper_stop_loss_enabled": true,
  "upper_stop_loss_price": 75000.0,
  "upper_stop_loss_action": "stop_bot",
  "note": "Example bot",
  "leverage_type": "cross",
  "leverage_custom_value": 10,
  "mode": "long"
}

Response Parameters

If successful, the response includes a copy of the updated Grid Bot entity.

Example Response

200 OK

{
  "id": 2291725,
  "account_id": 12555712,
  "account_name": "Binance Futures",
  "is_enabled": false,
  "grids_quantity": "40",
  "created_at": "2024-07-17T15:03:24.406Z",
  "updated_at": "2024-07-17T15:14:16.852Z",
  "strategy_type": "manual",
  "upper_stop_loss_enabled": true,
  "lower_stop_loss_enabled": true,
  "note": "Example bot",
  "editable": false,
  "lower_price": "56000.0",
  "lower_stop_loss_price": "50000.0",
  "lower_stop_loss_action": "stop_bot_and_close_position",
  "upper_price": "70000.0",
  "upper_stop_loss_price": "75000.0",
  "upper_stop_loss_action": "stop_bot",
  "quantity_per_grid": "150.0",
  "leverage_type": "cross",
  "leverage_custom_value": "10.0",
  "name": "CHANGED USDT_BTCUSDT EXAMPLE",
  "pair": "USDT_BTCUSDT",
  "start_price": "65030.3",
  "grid_price_step": "358.974358974358974358974358974358974359",
  "current_profit": "0.0",
  "current_profit_usd": "0.0",
  "total_profits_count": "0",
  "bought_volume": "0.0",
  "sold_volume": "0.0",
  "profit_percentage": "0.0",
  "current_price": "65030.3",
  "max_active_buy_lines": "50",
  "max_active_sell_lines": "50",
  "order_currency_type": "quote",
  "profit_currency_type": "quote",
  "trailing_up_enabled": "true",
  "grid_type": "arithmetic",
  "investment_base_currency": "0.0",
  "investment_quote_currency": "0.0",
  "unrealized_profit_loss": "0.0",
  "current_profit_loss": null,
  "current_profit_loss_percent": null,
  "orderbook_price_currency": "USDT",
  "expansion_down_enabled": "true",
  "expansion_down_stop_price": "54000.0",
  "grid_lines": [
    {"id": 253750913, "price": "64974.4", "side": null, "order_placed": false},
    {"id": 253750927, "price": "70000.0", "side": "sell", "order_placed": false},
    {"id": 253750926, "price": "69641.0", "side": "sell", "order_placed": false},
    {"id": 253750925, "price": "69282.1", "side": "sell", "order_placed": false},
    {"id": 253750924, "price": "68923.1", "side": "sell", "order_placed": false},
    {"id": 253750923, "price": "68564.1", "side": "sell", "order_placed": false},
    {"id": 253750922, "price": "68205.1", "side": "sell", "order_placed": false},
    {"id": 253750921, "price": "67846.2", "side": "sell", "order_placed": false},
    {"id": 253750920, "price": "67487.2", "side": "sell", "order_placed": false},
    {"id": 253750919, "price": "67128.2", "side": "sell", "order_placed": false},
    {"id": 253750918, "price": "66769.2", "side": "sell", "order_placed": false},
    {"id": 253750917, "price": "66410.3", "side": "sell", "order_placed": false},
    {"id": 253750916, "price": "66051.3", "side": "sell", "order_placed": false},
    {"id": 253750915, "price": "65692.3", "side": "sell", "order_placed": false},
    {"id": 253750914, "price": "65333.3", "side": "sell", "order_placed": false},
    {"id": 253750888, "price": "56000.0", "side": "buy", "order_placed": false},
    {"id": 253750889, "price": "56359.0", "side": "buy", "order_placed": false},
    {"id": 253750890, "price": "56717.9", "side": "buy", "order_placed": false},
    {"id": 253750891, "price": "57076.9", "side": "buy", "order_placed": false},
    {"id": 253750892, "price": "57435.9", "side": "buy", "order_placed": false},
    {"id": 253750893, "price": "57794.9", "side": "buy", "order_placed": false},
    {"id": 253750894, "price": "58153.8", "side": "buy", "order_placed": false},
    {"id": 253750895, "price": "58512.8", "side": "buy", "order_placed": false},
    {"id": 253750896, "price": "58871.8", "side": "buy", "order_placed": false},
    {"id": 253750897, "price": "59230.8", "side": "buy", "order_placed": false},
    {"id": 253750898, "price": "59589.7", "side": "buy", "order_placed": false},
    {"id": 253750899, "price": "59948.7", "side": "buy", "order_placed": false},
    {"id": 253750900, "price": "60307.7", "side": "buy", "order_placed": false},
    {"id": 253750901, "price": "60666.7", "side": "buy", "order_placed": false},
    {"id": 253750902, "price": "61025.6", "side": "buy", "order_placed": false},
    {"id": 253750903, "price": "61384.6", "side": "buy", "order_placed": false},
    {"id": 253750904, "price": "61743.6", "side": "buy", "order_placed": false},
    {"id": 253750905, "price": "62102.6", "side": "buy", "order_placed": false},
    {"id": 253750906, "price": "62461.5", "side": "buy", "order_placed": false},
    {"id": 253750907, "price": "62820.5", "side": "buy", "order_placed": false},
    {"id": 253750908, "price": "63179.5", "side": "buy", "order_placed": false},
    {"id": 253750909, "price": "63538.5", "side": "buy", "order_placed": false},
    {"id": 253750910, "price": "63897.4", "side": "buy", "order_placed": false},
    {"id": 253750911, "price": "64256.4", "side": "buy", "order_placed": false},
    {"id": 253750912, "price": "64615.4", "side": "buy", "order_placed": false}
  ]
}