PATCH

/api/v1/bots/grid/:id/manual

Izin: BOTS_WRITEKeamanan: SIGNED

Memperbarui konfigurasi, batas harga, kerapatan grid, volume order, kontrol risiko, dan pengaturan trailing untuk entitas Bot Grid yang sudah ada menggunakan ID-nya.

Jika berhasil, respons akan mengembalikan entitas Bot Grid yang telah diperbarui.

Grid Bot Entity

Parameter Path

idinteger required

ID unik Quentrade untuk entitas Bot Grid ini. Contoh: 2291725

Parameter Body

namestring required

Nama Bot Grid yang ditentukan oleh pengguna (1 hingga 40 karakter).

upper_pricenumber required

Harga maksimum rentang perdagangan, di atas batas ini bot tidak akan menempatkan order jual.

lower_pricenumber required

Harga minimum rentang perdagangan, di bawah batas ini bot tidak akan menempatkan order beli.

grids_quantitynumber required

Jumlah tingkat grid antara batas harga atas dan bawah. Dibatasi oleh aturan bursa untuk rate dan leverage.

quantity_per_gridnumber required

Kuantitas aset yang dialokasikan per order level Bot Grid.

grid_typestring

default: arithmetic

Tipe konfigurasi Bot Grid: geometric (langkah persentase) atau arithmetic (langkah nilai tetap).

upper_stop_loss_enabledboolean

default: false

Menunjukkan apakah pengaturan stop-loss atas diaktifkan (true) atau tidak (false).

upper_stop_loss_actionstring

default: stop_bot

Tindakan saat harga aset mencapai atau melebihi stop-loss atas: stop_bot, stop_bot_and_buy, atau stop_bot_and_close_position.

upper_stop_loss_pricenumber

Tingkat harga yang memicu tindakan stop-loss atas.

lower_stop_loss_enabledboolean

default: false

Menunjukkan apakah pengaturan stop-loss bawah diaktifkan (true) atau tidak (false).

lower_stop_loss_actionstring

default: stop_bot

Tindakan saat harga aset mencapai atau turun di bawah stop-loss bawah: stop_bot, stop_bot_and_sell, atau stop_bot_and_close_position.

lower_stop_loss_pricenumber

Tingkat harga yang memicu tindakan stop-loss bawah.

leverage_typestring

Tipe leverage yang diterapkan: cross (menggunakan jaminan akun) atau isolated (membatasi margin pada posisi).

leverage_custom_valuenumber

Nilai pengali leverage kustom yang ditentukan untuk Bot Grid.

modestring

Tipe strategi grid: long (kenaikan harga), short (penurunan harga), atau reversal (trading pembalikan tren).

max_active_sell_linesinteger

Jumlah maksimum order jual aktif yang dapat ditempatkan secara bersamaan.

trailing_up_enabledboolean

default: false

Menunjukkan apakah fitur trailing-up diaktifkan (true) atau tidak (false).

trailing_down_enabledboolean

default: false

Menunjukkan apakah fitur trailing-down diaktifkan (true) atau tidak (false).

expansion_down_enabledboolean

default: false

Menunjukkan apakah ekspansi grid ke bawah diaktifkan (true) atau tidak (false).

expansion_down_stop_pricenumber

Harga henti ekspansi grid ke bawah. Wajib diisi jika expansion_down_enabled bernilai true.

expansion_up_enabledboolean

default: false

Menunjukkan apakah ekspansi grid ke atas diaktifkan (true) atau tidak (false).

expansion_up_stop_pricenumber

Harga henti ekspansi grid ke atas. Wajib diisi jika expansion_up_enabled bernilai true.

ignore_warningsboolean

default: false

Mengabaikan peringatan konfigurasi dan memaksakan pembaruan Bot Grid (true / false).

notestring

Catatan opsional yang ditentukan pengguna untuk Bot Grid (1 hingga 300 karakter).

Contoh Permintaan

edit_grid_bot_manual_request.json

PATCH /api/v1/bots/grid/:id/manual

{
  "name": "CHANGED USDT_BTCUSDT EXAMPLE",
  "upper_price": 70000,
  "lower_price": 56000,
  "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,
  "expansion_up_enabled": false,
  "lower_stop_loss_enabled": true,
  "lower_stop_loss_price": 50000,
  "lower_stop_loss_action": "stop_bot_and_close_position",
  "upper_stop_loss_enabled": true,
  "upper_stop_loss_price": 75000,
  "upper_stop_loss_action": "stop_bot",
  "note": "Example bot",
  "leverage_type": "cross",
  "leverage_custom_value": 10,
  "mode": "long"
}

Contoh Respons

Jika berhasil, API mengembalikan kode HTTP 200 dengan representasi entitas Bot Grid yang telah diperbarui.

edit_grid_bot_manual_200.json

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": 253750888,
      "price": "56000.0",
      "side": "buy",
      "order_placed": false
    }
  ],
  "mode": "long"
}

SEBELUMNYA Buat Bot Grid SELANJUTNYADapatkan Bot Grid