PATCH

/api/v1/smart_trades/:id

Izin: SMART_TRADES_WRITEKeamanan: SIGNED

Memperbarui SmartTrade yang sudah ada menggunakan ID-nya. Pembaruan parameter SmartTrade tersedia untuk entitas dengan status waiting_position dan waiting_targets.

Pengeditan hanya didukung saat SmartTrade berstatus waiting_position (menunggu entri posisi) atau waiting_targets (posisi terisi, menunggu TP/SL).

SmartTrade Entity

Parameter Jalur

idinteger required

ID unik Quentrade untuk entitas SmartTrade ini.

Parameter Bodi Permintaan

leverageobject

Rincian pengaturan leverage yang diterapkan pada SmartTrade ini.

enabledboolean required

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

typestring

Jenis leverage untuk akun futures: cross atau isolated.

valueinteger

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

positionobject

Pengaturan posisi yang diterapkan pada SmartTrade ini (tersedia jika status waiting_position).

unitsobject

Rincian unit kuantitas yang diterapkan [value: number].

priceobject

Rincian harga yang diterapkan [value: number].

conditionalobject

Pengaturan pesanan 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 target bertingkat yang diterapkan pada SmartTrade ini.

enabledboolean required

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

stepsarray[object]

Kondisi rinci untuk setiap langkah Take Profit: [id: integer], [order_type: market/limit], [volume: number], [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 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 langsung [value: number].

conditionalobject

Pengaturan Stop Loss bersyarat [price: object (type, value, percent), trailing: object (enabled: boolean)].

timeoutobject

Pengaturan waktu tunda aman [enabled: boolean, value: integer (dalam detik)].

Parameter Respons

Jika berhasil, respons menyertakan salinan terbaru dari entitas SmartTrade yang telah diperbarui.

Contoh Permintaan

edit_smart_trade_request.json

PATCH /api/v1/smart_trades/:id

{
  "position": {
    "type": "buy",
    "units": {
      "value": "34.0"
    },
    "price": {
      "value": "0.00000442"
    }
  },
  "take_profit": {
    "enabled": true,
    "steps": [
      {
        "id": 1225026814,
        "order_type": "limit",
        "units": {
          "value": "34.0"
        },
        "price": {
          "type": "last",
          "value": "0.00000508"
        },
        "volume": "100.0",
        "total": "0.00017272",
        "trailing": {
          "enabled": false
        }
      }
    ]
  },
  "stop_loss": {
    "enabled": true,
    "order_type": "market",
    "conditional": {
      "price": {
        "type": "last",
        "value": "0.00000280"
      },
      "trailing": {
        "enabled": false
      }
    }
  }
}

Contoh Respons

Mengembalikan HTTP 200 OK saat pembaruan berhasil, atau 400 Bad Request jika ada konflik validasi atau status.

edit_smart_trade_200.json

200 OK

{
  "id": 32037964,
  "version": 2,
  "account": {
    "id": 32199203,
    "type": "paper_trading",
    "name": "Paper Account 1251857",
    "market": "Binance Spot account simulator",
    "link": "/accounts/32199203"
  },
  "pair": "BTC_1INCH",
  "instant": false,
  "status": {
    "type": "waiting_targets",
    "basic_type": "waiting_targets",
    "title": "Waiting Targets"
  },
  "leverage": {
    "enabled": false
  },
  "position": {
    "type": "buy",
    "editable": false,
    "units": {
      "value": "34.0",
      "editable": false
    },
    "price": {
      "value": "0.00000442",
      "value_without_commission": "0.00000442",
      "editable": false
    },
    "total": {
      "value": "0.00015043"
    },
    "order_type": "limit",
    "status": {
      "type": "finished",
      "basic_type": "finished",
      "title": "Finished"
    }
  },
  "take_profit": {
    "enabled": true,
    "price_type": "value",
    "steps": [
      {
        "id": 1317007688,
        "order_type": "limit",
        "editable": true,
        "units": {
          "value": null
        },
        "price": {
          "type": "last",
          "value": "0.00000508",
          "percent": null
        },
        "volume": "100.0",
        "total": null,
        "trailing": {
          "enabled": false,
          "percent": null
        },
        "status": {
          "type": "idle",
          "basic_type": "idle",
          "title": "Pending"
        },
        "closed_at": null,
        "data": {
          "cancelable": true,
          "panic_sell_available": false
        },
        "position": 1
      }
    ]
  },
  "stop_loss": {
    "enabled": true,
    "price_type": "value",
    "breakeven": false,
    "order_type": "market",
    "editable": true,
    "status": {
      "type": "idle",
      "basic_type": "idle",
      "title": "Pending"
    },
    "units": {
      "value": null
    },
    "total": {
      "value": null
    },
    "price": {
      "value": null,
      "percent": null
    },
    "closed_at": null,
    "conditional": {
      "price": {
        "value": "0.0000028",
        "type": "last",
        "percent": null
      },
      "trailing": {
        "enabled": false,
        "percent": null
      }
    },
    "timeout": {
      "enabled": false,
      "value": null
    }
  },
  "reduce_funds": {
    "steps": []
  },
  "market_close": {},
  "note": "",
  "note_raw": null,
  "skip_enter_step": false,
  "data": {
    "editable": true,
    "current_price": {
      "day_change_percent": "1.799",
      "bid": "0.00000283",
      "ask": "0.00000284",
      "last": "0.00000283",
      "quote_volume": "0.19732848"
    },
    "target_price_type": "price",
    "orderbook_price_currency": "BTC",
    "base_order_finished": true,
    "missing_funds_to_close": "0.0",
    "liquidation_price": null,
    "average_enter_price": "0.00000442",
    "average_close_price": null,
    "average_enter_price_without_commission": "0.00000442",
    "average_close_price_without_commission": null,
    "panic_sell_available": true,
    "add_funds_available": true,
    "reduce_funds_available": true,
    "force_start_available": false,
    "force_process_available": true,
    "cancel_available": true,
    "finished": false,
    "base_position_step_finished": true,
    "entered_amount": "34.0",
    "entered_total": "0.00015043028",
    "closed_amount": "0.0",
    "closed_total": "0.0",
    "commission": 0.001,
    "created_at": "2024-12-17T16:08:51.237Z",
    "updated_at": "2025-02-13T18:12:44.122Z",
    "type": "smart_trade"
  },
  "profit": {
    "volume": "-0.0000543065",
    "usd": "-5.188117714065",
    "percent": "-36.1",
    "roe": null
  },
  "margin": {
    "amount": null,
    "total": null
  },
  "is_position_not_filled": false
}

SEBELUMNYA Buat SmartTrade SELANJUTNYADapatkan SmartTrade