🇬🇧
EnglishEnglish (US)
🇮🇩
IndonesiaBahasa Indonesia
POST

/api/v1/bots/dca

Izin: BOTS_WRITEKeamanan: BEARER_JWT

Membuat bot Dollar Cost Averaging (DCA) baru. Konfigurasikan ukuran base order awal, laddering safety order, skala deviasi harga, target take profit, dan kontrol risiko stop loss yang dieksekusi oleh engine trading Tokio berkecepatan tinggi.

Lihat Entitas DCA Bot untuk definisi lengkap atribut dan struktur telemetri live
DCA Bot Entity

Parameter Body

21
namestring required

Nama bot DCA yang ditentukan pengguna (1 hingga 100 karakter).

exchangestring required
default: binance

Pengenal exchange tempat bot mengeksekusi order: binance, bybit, okx, kucoin, bitget, reku, indodax, tokocrypto, dll.

connection_iduuid required

UUID entitas koneksi exchange terdaftar dari GET /api/v1/exchanges.

pairstring required

Pasangan trading dalam format Quentrade (contoh: BTC/USDT, ETH/USDT, SOL/USDT).

market_typestring
default: spot

Tipe pasar trading: 'spot' atau 'futures'.

strategystring required
default: Long

Arah strategi trading: 'Long' (beli rendah, jual tinggi) atau 'Short' (khusus futures).

start_order_typestring
default: limit

Tipe eksekusi order awal: 'limit' atau 'market'.

base_order_sizenumber required

Ukuran base order awal dalam quote currency (contoh: 100 USDT).

safety_order_sizenumber required

Ukuran safety order awal dalam quote currency (contoh: 50 USDT).

safety_order_step_scalenumber
default: 1.0

Pengali skala jarak step yang diterapkan pada deviasi harga safety order berikutnya.

safety_order_volume_scalenumber
default: 1.0

Pengali volume yang diterapkan untuk memperbesar ukuran safety order berikutnya.

price_deviationnumber required
default: 1.0

Persentase penurunan harga dari harga rata-rata masuk untuk memicu setiap safety order.

max_safety_ordersinteger required
default: 5

Jumlah maksimum safety order yang dapat dieksekusi bot per siklus perdagangan.

take_profit_pctnumber required

Target persentase keuntungan di atas harga rata-rata beli untuk menutup posisi (contoh: 2.5).

tp_typestring
default: percentage

Tipe kalkulasi take profit: 'percentage'.

tp_trailingboolean
default: false

Mengaktifkan trailing take profit untuk memaksimalkan profit saat reli harga kuat.

tp_trailing_pctnumber
default: 0.0

Persentase deviasi trailing profit (contoh: 0.2).

stop_loss_enabledboolean
default: false

Mengaktifkan proteksi stop loss untuk membatasi risiko kerugian maksimum.

stop_loss_pctnumber
default: 0.0

Persentase stop loss di bawah harga rata-rata beli (contoh: 5.0).

cooldown_between_tradesinteger
default: 0

Periode cooldown dalam detik sebelum membuka posisi baru setelah posisi ditutup.

start_conditionstring
default: asap

Kondisi pemicu awal transaksi: 'asap', 'manual', atau 'signal'.

dev_create_dca_bot.additional_info.title

dev_create_dca_bot.additional_info.leverage_title

dev_create_dca_bot.additional_info.leverage_desc

Currency Rates & Leverage Limits

dev_create_dca_bot.additional_info.tp_steps_title

dev_create_dca_bot.additional_info.tp_steps_desc

take_profit_steps.json
{
  "take_profit_steps": [
    {
      "amount_percentage": 50,
      "profit_percentage": 10
    },
    {
      "amount_percentage": 50,
      "profit_percentage": 20
    }
  ]
}

dev_create_dca_bot.additional_info.strategy_title

dev_create_dca_bot.additional_info.strategy_desc

Available Strategy List

Contoh Request

create_dca_bot_request.json
POST /api/v1/bots/dca 
{
  "name": "BTC/USDT Classic Long DCA",
  "exchange": "binance",
  "connection_id": "b3e0c4a1-8d2a-4a5f-b567-9c123456789a",
  "pair": "BTC/USDT",
  "market_type": "spot",
  "strategy": "Long",
  "start_order_type": "limit",
  "base_order_size": 100,
  "safety_order_size": 50,
  "safety_order_step_scale": 1.5,
  "safety_order_volume_scale": 1.5,
  "price_deviation": 1,
  "max_safety_orders": 5,
  "take_profit_pct": 2.5,
  "tp_type": "percentage",
  "tp_trailing": true,
  "tp_trailing_pct": 0.2,
  "stop_loss_enabled": true,
  "stop_loss_pct": 5,
  "sl_type": "stop_loss",
  "cooldown_between_trades": 60,
  "start_condition": "asap"
}

Contoh Respons

Mengembalikan entitas DCA Bot yang baru dibuat dengan status default 'stopped'. Panggil POST /api/v1/bots/dca//start untuk meluncurkan eksekusi trading.

create_dca_bot_201.json
201 Created
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "user_id": "9a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
  "connection_id": "b3e0c4a1-8d2a-4a5f-b567-9c123456789a",
  "name": "BTC/USDT Classic Long DCA",
  "exchange": "binance",
  "pair": "BTC/USDT",
  "market_type": "spot",
  "strategy": "Long",
  "start_order_type": "limit",
  "base_order_size": 100,
  "safety_order_size": 50,
  "safety_order_step_scale": 1.5,
  "safety_order_volume_scale": 1.5,
  "quote_currency": "USDT",
  "price_deviation": 1,
  "max_safety_orders": 5,
  "max_active_trades": 1,
  "cooldown_between_trades": 60,
  "take_profit_pct": 2.5,
  "tp_type": "percentage",
  "tp_trailing": true,
  "tp_trailing_pct": 0.2,
  "stop_loss_enabled": true,
  "stop_loss_pct": 5,
  "sl_type": "stop_loss",
  "start_condition": "asap",
  "status": "stopped",
  "active_trades": 0,
  "total_profit": 0,
  "total_trades": 0,
  "created_at": "2026-08-20T10:15:30.000Z",
  "updated_at": "2026-08-20T10:15:30.000Z"
}
SEBELUMNYA Ringkasan DCA BotSELANJUTNYAEdit DCA Bot