POST

/api/v1/smart_trades/:id/reduce_funds

Izin: SMART_TRADES_WRITEKeamanan: SIGNED

Memulai proses pengurangan dana dari entitas SmartTrade yang sedang aktif. Pesanan jual baru akan ditempatkan di bursa untuk menutup sebagian posisi dan mengamankan dana.

Pastikan Anda memeriksa jumlah kuota pengurangan maksimum yang diizinkan melalui endpoint Informasi pengurangan dana sebelum memanggil endpoint ini.

Available Reduce Funds

Parameter Jalur

idinteger required

ID unik Quentrade untuk entitas SmartTrade ini.

Parameter Bodi Permintaan

order_typestring required

Jenis pesanan untuk mengurangi dana pada SmartTrade ini: market atau limit.

unitsobject required

Menentukan jumlah unit yang akan dikurangi dalam SmartTrade ini.

valuenumber required

Menentukan kuantitas unit aset yang akan dijual.

priceobject required

Menyediakan rincian harga untuk pesanan limit. Parameter ini wajib diisi jika order_type bernilai limit.

valuenumber required

Harga eksekusi untuk pesanan limit.

Parameter Respons

Jika berhasil, respons menyertakan salinan entitas SmartTrade terbaru dengan langkah reduce_funds yang ditambahkan dan status pending yang diperbarui.

Contoh Permintaan

reduce_funds_request.json

POST /api/v1/smart_trades/:id/reduce_funds

{
  "order_type": "limit",
  "units": {
    "value": "0.04"
  },
  "price": {
    "value": "0.03711"
  }
}

Contoh Respons

Mengembalikan HTTP 201 Created saat berhasil, 400 Bad Request jika status tidak valid atau jumlah melebihi kuota, atau 422 Unprocessable Entity jika parameter tidak valid.

reduce_funds_201.json

201 Created

{
  "id": 12345678,
  "version": 2,
  "account": {
    "id": 32199203,
    "type": "paper_trading",
    "name": "Paper Account 1251857",
    "market": "Binance Spot account simulator",
    "link": "/accounts/32199203"
  },
  "pair": "BTC_ETH",
  "instant": false,
  "status": {
    "type": "pending_reduce_funds",
    "basic_type": "pending_reduce_funds",
    "title": "Pending reduce funds"
  },
  "leverage": {
    "enabled": false
  },
  "position": {
    "type": "buy",
    "editable": false,
    "units": {
      "value": "4.0",
      "editable": false
    },
    "price": {
      "value": "0.03719",
      "value_without_commission": "0.03716",
      "editable": false
    },
    "total": {
      "value": "0.14878864"
    },
    "order_type": "market",
    "status": {
      "type": "finished",
      "basic_type": "finished",
      "title": "Finished"
    }
  },
  "take_profit": {
    "enabled": true,
    "price_type": "value",
    "steps": [
      {
        "id": 1224972676,
        "order_type": "limit",
        "editable": true,
        "units": {
          "value": "4.0"
        },
        "price": {
          "type": "last",
          "value": "0.04088",
          "percent": null
        },
        "volume": "100.0",
        "total": "0.16352",
        "trailing": {
          "enabled": false,
          "percent": null
        },
        "status": {
          "type": "order_placed",
          "basic_type": "order_placed",
          "title": "Placed"
        },
        "closed_at": null,
        "data": {
          "cancelable": true,
          "panic_sell_available": true
        },
        "position": 1
      }
    ]
  },
  "stop_loss": {
    "enabled": false
  },
  "reduce_funds": {
    "steps": [
      {
        "id": 1224983548,
        "type": "market",
        "status": {
          "type": "idle",
          "basic_type": "idle",
          "title": "Pending"
        },
        "units": {
          "value": "0.3995"
        },
        "price": {
          "value": "0.03702",
          "value_without_commission": "0.03702"
        },
        "total": {
          "value": "0.01478949"
        },
        "closed_at": null,
        "data": {
          "cancelable": false,
          "panic_sell_available": false
        }
      }
    ]
  },
  "market_close": {},
  "note": "",
  "note_raw": null,
  "skip_enter_step": false,
  "data": {
    "editable": false,
    "current_price": {
      "day_change_percent": "-0.162",
      "bid": "0.03702",
      "ask": "0.03703",
      "last": "0.03703",
      "quote_volume": "1626.01355238"
    },
    "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.03719",
    "average_close_price": null,
    "average_enter_price_without_commission": "0.03716",
    "average_close_price_without_commission": null,
    "panic_sell_available": true,
    "add_funds_available": false,
    "reduce_funds_available": false,
    "force_start_available": false,
    "force_process_available": true,
    "cancel_available": true,
    "finished": false,
    "base_position_step_finished": true,
    "entered_amount": "4.0",
    "entered_total": "0.14878864",
    "closed_amount": "0.0",
    "closed_total": "0.0",
    "commission": 0.001,
    "created_at": "2024-12-17T15:44:49.405Z",
    "updated_at": "2024-12-17T15:52:33.169Z",
    "type": "smart_trade"
  },
  "profit": {
    "volume": "-0.00085672",
    "usd": "-91.0173245288",
    "percent": "-0.58",
    "roe": null
  },
  "margin": {
    "amount": null,
    "total": null
  },
  "is_position_not_filled": false
}

SEBELUMNYA Informasi pengurangan dana SELANJUTNYATutup SmartTrade menurut harga pasar