POST

/api/v1/smart_trades

Izin: SMART_TRADES_WRITEKeamanan: SIGNED

Membuat entitas SmartTrade baru. Pembuatan SmartTrade tersedia untuk akun bursa yang memiliki nilai parameter smart_trading_supported bernilai true.

Endpoint ini mewajibkan akun bursa dengan smart_trading_supported aktif. Gunakan endpoint Semua pasangan pasar untuk memverifikasi simbol perdagangan yang kompatibel.

SmartTrade Entity

Parameter Permintaan

account_idinteger required

ID dari entitas akun bursa tempat perdagangan ini akan dibuat.

pairstring required

Pasangan perdagangan dalam format Quentrade (misal: USDT_BTC). Gunakan endpoint Semua pasangan pasar untuk mendapatkan nilai yang valid.

instantboolean

Digunakan untuk membuat jenis SmartTrade Simple Buy atau Simple Sell. Atur ke true untuk mengeksekusi order pasar langsung tanpa aturan TP/SL. Default: false

skip_enter_stepboolean

Atur ke true untuk membuat Smart Sell atau Smart Buy — melewati langkah entri posisi dan hanya menempatkan take profit / stop loss untuk posisi aset yang sudah dimiliki. Default: false

leverageobject

Rincian pengaturan leverage yang diterapkan pada SmartTrade margin atau futures.

enabledboolean required

Mengaktifkan pengaturan leverage untuk SmartTrade ini. Atur ke true untuk mengaktifkan. Default: false

typestring

Jenis leverage untuk akun futures: cross atau isolated. Default: cross

valueinteger

Nilai leverage cross atau isolated berdasarkan aturan bursa dan batas mata uang.

positionobject required

Pengaturan Posisi yang diterapkan pada SmartTrade ini.

order_typestring required

Jenis pesanan posisi untuk SmartTrade ini: market, limit, atau conditional.

typestring required

Sisi pesanan untuk membuka posisi: buy atau sell.

unitsobject required

Rincian unit kuantitas yang diterapkan. Berisi [value: string] yang menentukan jumlah unit sesuai aturan bursa.

priceobject

Pengaturan harga. Wajib diisi untuk jenis pesanan limit atau conditional. Berisi [value: number].

conditionalobject

Pengaturan pesanan pemicu bersyarat: [order_type: string] (market, limit), [price: object] (type: bid/ask/last, value: number), dan [trailing: object] (enabled: boolean, percent: number).

take_profitobject

Rincian pengaturan Take Profit dan langkah-langkah target bertingkat yang diterapkan pada SmartTrade ini.

enabledboolean required

Mengaktifkan Take Profit untuk SmartTrade ini. Atur ke true untuk mengaktifkan. Default: false

stepsarray[object]

Informasi rinci mengenai setiap langkah Take Profit termasuk [order_type: market/limit], [volume: number] (persentase volume), [price: object] (type: bid/ask/last, value/percent: number), dan [trailing: object] (enabled: boolean, percent: number min: 0.01 max: 100 untuk langkah terakhir).

stop_lossobject

Rincian pengaturan proteksi Stop Loss yang diterapkan pada SmartTrade ini.

enabledboolean required

Mengaktifkan Stop Loss untuk SmartTrade ini. Atur ke true untuk mengaktifkan. Default: false

breakevenboolean

Mengaktifkan fitur Pindahkan ke Breakeven. Membutuhkan minimal dua langkah Take Profit. Default: false

order_typestring required

Jenis Stop Loss: market atau limit. Wajib diisi jika stop_loss[enabled] bernilai true.

priceobject

Konfigurasi nilai harga stop loss: [value: number] atau [percent: number].

conditionalobject

Harga pemicu stop loss bersyarat dan pengaturan trailing SL [price: object, trailing: object].

timeoutobject

Pengaturan waktu tunda aman (dalam detik) sebelum mengeksekusi SL [enabled: boolean, value: number].

notestring

Catatan khusus opsional yang ditentukan oleh pengguna untuk SmartTrade ini (minlength: 1, maxlength: 300).

Parameter Respons

Jika berhasil, respons menyertakan salinan terbaru dari entitas SmartTrade.

Contoh Permintaan

create_smart_trade_request.json

POST /api/v1/smart_trades

{
  "account_id": 32455218,
  "pair": "USDT_BTC",
  "instant": true,
  "position": {
    "type": "buy",
    "units": {
      "value": "0.01"
    },
    "order_type": "market"
  },
  "leverage": {
    "enabled": true,
    "type": "custom",
    "value": "12"
  }
}

Contoh Respons

Mengembalikan HTTP 201 Created saat pembuatan berhasil, atau 422/403 jika terjadi kegagalan validasi parameter.

create_smart_trade_201.json

201 Created

{
  "id": 30350494,
  "version": 2,
  "account": {
    "id": 32455218,
    "type": "binance",
    "name": "Spot - Binance",
    "market": "Binance Spot",
    "link": "/accounts/32455218"
  },
  "pair": "USDT_BTC",
  "instant": true,
  "status": {
    "type": "created",
    "basic_type": "created",
    "title": "Pending"
  },
  "leverage": {
    "enabled": false
  },
  "position": {
    "type": "buy",
    "editable": false,
    "units": {
      "value": "0.01",
      "editable": false
    },
    "price": {
      "value": "56283.73",
      "value_without_commission": "56283.73",
      "editable": true
    },
    "total": {
      "value": "562.8373"
    },
    "order_type": "market",
    "status": {
      "type": "to_process",
      "basic_type": "to_process",
      "title": "Pending"
    }
  },
  "take_profit": {
    "enabled": false,
    "price_type": "value",
    "steps": []
  },
  "stop_loss": {
    "enabled": false
  },
  "reduce_funds": {
    "steps": []
  },
  "market_close": {},
  "note": "",
  "note_raw": null,
  "skip_enter_step": false,
  "data": {
    "editable": false,
    "current_price": {
      "bid": "56283.72",
      "ask": "56283.73",
      "last": "56282.73",
      "quote_volume": "3870508107.5406402",
      "day_change_percent": "3.947"
    },
    "target_price_type": "price",
    "orderbook_price_currency": "USDT",
    "base_order_finished": true,
    "missing_funds_to_close": "0.0",
    "liquidation_price": null,
    "average_enter_price": null,
    "average_close_price": null,
    "average_enter_price_without_commission": null,
    "average_close_price_without_commission": null,
    "panic_sell_available": false,
    "add_funds_available": false,
    "reduce_funds_available": false,
    "force_start_available": true,
    "force_process_available": true,
    "cancel_available": false,
    "finished": false,
    "base_position_step_finished": false,
    "entered_amount": "0.0",
    "entered_total": "0.0",
    "closed_amount": "0.0",
    "closed_total": "0.0",
    "commission": "0.001",
    "created_at": "2024-08-06T14:42:25.528Z",
    "updated_at": "2024-08-06T14:42:25.528Z",
    "type": "simple_buy"
  },
  "profit": {
    "volume": null,
    "usd": null,
    "percent": "0.0",
    "roe": null
  },
  "margin": {
    "amount": null,
    "total": null
  },
  "is_position_not_filled": true
}

SEBELUMNYA Entitas SmartTrade SELANJUTNYAEdit SmartTrade