POST

/api/v1/bots/grid

Izin: BOTS_WRITEKeamanan: SIGNED

Membuat Bot Grid manual baru dengan batas rentang harga kustom, jumlah tingkat grid, alokasi volume order, aturan stop-loss, dan opsi trailing.

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

Grid Bot Entity

Parameter Body

namestring required

Nama Bot Grid yang ditentukan pengguna (1 hingga 40 karakter). Jika tidak diisi, sistem akan membuat nama default secara otomatis.

account_idinteger required

ID entitas akun bursa tempat Bot Grid dibuat.

pairstring required

Pasangan perdagangan dalam format Quentrade (misal: USDT_ETH). Gunakan endpoint Semua pasangan pasar untuk melihat daftar pasangan yang didukung.

upper_pricenumber required

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

lower_pricenumber / string required

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

grids_quantitynumber required

Jumlah tingkat grid yang didistribusikan di antara batas harga atas dan bawah.

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 selisih harga tetap).

order_currency_typestring

default: quote

Tipe mata uang yang digunakan untuk menempatkan order: base atau quote.

profit_currency_typestring

default: quote

Mata uang hasil profit yang dihasilkan oleh bot: base atau quote.

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

default: not_specified

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

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 pembuatan Bot Grid (true / false).

notestring

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

Panduan Konfigurasi Strategi & Risiko

Tipe Grid (Arithmetic vs Geometric)

Grid Arithmetic memberikan selisih jarak harga tetap antar tingkat. Grid Geometric memberikan persentase kenaikan tetap, menghasilkan margin laba yang identik di setiap langkah grid.

Tindakan Stop Loss

Konfigurasikan penghentian bot otomatis, likuidasi ke quote currency (stop_bot_and_sell), akumulasi koin dasar (stop_bot_and_buy), atau penutupan posisi futures (stop_bot_and_close_position).

Trailing & Ekspansi Grid

Fitur Trailing menggeser seluruh koridor grid ke atas/bawah secara dinamis mengikuti tren pasar. Ekspansi menambahkan garis grid baru hingga mencapai stop price yang ditentukan.

Contoh Permintaan

create_grid_bot_manual_request.json

POST /api/v1/bots/grid

{
  "account_id": 12345678,
  "pair": "USDT_ETH",
  "name": "Test GRID",
  "upper_price": 1.1,
  "lower_price": 0.56,
  "quantity_per_grid": 40,
  "grids_quantity": 28,
  "max_active_buy_lines": 28,
  "max_active_sell_lines": 28,
  "order_currency_type": "base",
  "profit_currency_type": "base",
  "ignore_warnings": false,
  "trailing_up_enabled": false,
  "trailing_down_enabled": true,
  "grid_type": "arithmetic",
  "expansion_down_enabled": false,
  "expansion_up_enabled": true,
  "expansion_up_stop_price": 1.57
}

Contoh Respons

Jika berhasil, API mengembalikan kode HTTP 201 dengan representasi entitas Bot Grid yang telah dibuat.

create_grid_bot_manual_201.json

201 Created

{
  "id": 2291723,
  "account_id": 73223,
  "account_name": "binance",
  "is_enabled": false,
  "grids_quantity": "50",
  "created_at": "2024-07-17T14:46:46.414Z",
  "updated_at": "2024-07-17T14:46:46.505Z",
  "strategy_type": "manual",
  "upper_stop_loss_enabled": true,
  "lower_stop_loss_enabled": true,
  "note": "Example bot",
  "editable": true,
  "lower_price": "56000.0",
  "lower_stop_loss_price": "50000.0",
  "lower_stop_loss_action": "stop_bot_and_sell",
  "upper_price": "72000.0",
  "upper_stop_loss_price": "75000.0",
  "upper_stop_loss_action": "stop_bot",
  "quantity_per_grid": "15.0",
  "leverage_type": "not_specified",
  "leverage_custom_value": null,
  "name": "USDT_BTC EXAMPLE",
  "pair": "USDT_BTC",
  "start_price": null,
  "grid_price_step": "326.530612244897959183673469387755102041",
  "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": "65229.37",
  "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",
  "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": 253750214,
      "price": "65142.86",
      "side": null,
      "order_placed": false
    },
    {
      "id": 253750235,
      "price": "72000.0",
      "side": "sell",
      "order_placed": false
    },
    {
      "id": 253750213,
      "price": "64816.33",
      "side": "buy",
      "order_placed": false
    }
  ],
  "mode": null
}

SEBELUMNYA Entitas Bot Grid SELANJUTNYAEdit Bot Grid