GET

/api/v1/bots/dca

Permission: BOTS_READSecurity: BEARER_JWT

Returns an array of all Dollar Cost Averaging (DCA) bots configured by the authenticated user, including their real-time execution status ('running', 'stopped', 'completed'), safety order ladders, active trades count, and total realized profit.

See DCA Bot Entity for full attribute definitions
DCA Bot Entity

Query Parameters

3
exchangestring

Filters bots by exchange platform (e.g. binance, bybit, okx).

statusstring

Filters bots by execution status: 'running', 'stopped', 'completed', or 'all'.

pairstring

Filters bots trading on a specific pair (e.g. BTC/USDT).

Example Request

GETGET /api/v1/bots/dca

Example Responses

Returns an array of DCA Bot entities ordered by creation date descending.

get_dca_bots_list_200.json
200 OK
[
  {
    "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": "running",
    "active_trades": 1,
    "total_profit": 142.5,
    "total_trades": 12,
    "created_at": "2026-08-20T10:15:30.000Z",
    "updated_at": "2026-08-20T10:15:30.000Z"
  },
  {
    "id": "2a4f6d8e-1b3c-5e7a-9f0b-8d1e3c5a7b9d",
    "user_id": "9a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    "connection_id": "b3e0c4a1-8d2a-4a5f-b567-9c123456789a",
    "name": "ETH/USDT Safe Accumulator",
    "exchange": "bybit",
    "pair": "ETH/USDT",
    "market_type": "spot",
    "strategy": "Long",
    "start_order_type": "limit",
    "base_order_size": 50,
    "safety_order_size": 25,
    "safety_order_step_scale": 1.2,
    "safety_order_volume_scale": 1.3,
    "quote_currency": "USDT",
    "price_deviation": 1.5,
    "max_safety_orders": 4,
    "max_active_trades": 1,
    "cooldown_between_trades": 0,
    "take_profit_pct": 2,
    "tp_type": "percentage",
    "tp_trailing": false,
    "tp_trailing_pct": 0,
    "stop_loss_enabled": false,
    "stop_loss_pct": 0,
    "sl_type": "stop_loss",
    "start_condition": "asap",
    "status": "stopped",
    "active_trades": 0,
    "total_profit": 68.2,
    "total_trades": 7,
    "created_at": "2026-08-19T08:30:00.000Z",
    "updated_at": "2026-08-19T14:45:00.000Z"
  }
]