POST

/api/v1/smart_trades/:id/add_funds

Izin: SMART_TRADES_WRITEKeamanan: SIGNED

Menambahkan dana ke SmartTrade yang aktif, meningkatkan volume perdagangan keseluruhan dan merata-ratakan harga entri (Dollar Cost Averaging) kapan saja.

Endpoint ini tersedia untuk SmartTrade dengan status waiting_position dan waiting_targets, tetapi tidak dapat digunakan untuk SmartTrade yang mengaktifkan trailing atau jenis simple_buy dan simple_sell.
SmartTrade Entity

Parameter Jalur

idinteger required

ID unik Quentrade untuk entitas SmartTrade ini.

Parameter Bodi Permintaan

3
order_typestring required

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

unitsobject required

Menentukan jumlah unit yang akan ditambahkan ke dalam SmartTrade ini.

valuenumber required

Menentukan jumlah unit aset yang akan dibeli.

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 volume posisi, total aset masuk, dan harga rata-rata yang telah dihitung ulang.

Contoh Permintaan

add_funds_request.json
POST /api/v1/smart_trades/:id/add_funds
{
  "order_type": "limit",
  "units": {
    "value": "14.60138226"
  },
  "price": {
    "value": "0.10457"
  }
}

Contoh Respons

Mengembalikan HTTP 201 Created saat berhasil, 400 Bad Request jika status/tipe tidak didukung, atau 422 Unprocessable Entity jika parameter tidak valid.

add_funds_201.json
201 Created
{
  "id": 30415988,
  "version": 2,
  "account": {
    "id": 32402783,
    "type": "binance_us",
    "name": "My Binance US",
    "market": "Binance US Spot",
    "link": "/accounts/32402783"
  },
  "pair": "USDT_DOGE",
  "instant": false,
  "status": {
    "type": "waiting_targets",
    "basic_type": "waiting_targets",
    "title": "Waiting Targets"
  },
  "leverage": {
    "enabled": false
  },
  "position": {
    "type": "buy",
    "order_type": "market",
    "editable": false,
    "units": {
      "value": "43.736",
      "editable": false
    },
    "price": {
      "value": "0.10457",
      "value_without_commission": "0.10394",
      "editable": false
    },
    "total": {
      "value": "4.57371",
      "value_without_commission": "4.54626774"
    },
    "status": {
      "type": "finished",
      "basic_type": "finished",
      "title": "Finished"
    }
  },
  "take_profit": {
    "enabled": true,
    "price_type": "value",
    "steps": [
      {
        "id": 1007239535,
        "order_type": "limit",
        "editable": true,
        "units": {
          "value": "43.0"
        },
        "price": {
          "type": "last",
          "value": "0.1098",
          "percent": "5.0"
        },
        "volume": "100.0",
        "total": "4.7214",
        "trailing": {
          "enabled": false,
          "percent": null
        },
        "status": {
          "type": "order_placed",
          "basic_type": "order_placed",
          "title": "Placed"
        },
        "data": {
          "cancelable": true,
          "panic_sell_available": true
        },
        "position": 1
      }
    ]
  },
  "stop_loss": {
    "enabled": true,
    "price_type": "value",
    "breakeven": false,
    "order_type": "market",
    "editable": true,
    "price": {
      "value": null,
      "percent": null
    },
    "conditional": {
      "price": {
        "value": "0.10056",
        "type": "last",
        "percent": null
      },
      "trailing": {
        "enabled": false,
        "percent": null
      }
    },
    "timeout": {
      "enabled": false,
      "value": null
    },
    "status": {
      "type": "to_process",
      "basic_type": "to_process",
      "title": "Pending"
    }
  },
  "reduce_funds": {
    "steps": []
  },
  "market_close": {},
  "note": "",
  "note_raw": null,
  "skip_enter_step": false,
  "data": {
    "editable": true,
    "current_price": {
      "bid": "0.10244",
      "ask": "0.10265",
      "last": "0.1025",
      "quote_volume": "255295.82542",
      "day_change_percent": "-2.539"
    },
    "target_price_type": "price",
    "orderbook_price_currency": "USDT",
    "base_order_finished": true,
    "missing_funds_to_close": "0.0",
    "liquidation_price": null,
    "average_enter_price": "0.10457",
    "average_close_price": null,
    "average_enter_price_without_commission": "0.10394",
    "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": "43.736",
    "entered_total": "4.57371",
    "closed_amount": "0.0",
    "closed_total": "0.0",
    "commission": 0.001,
    "created_at": "2024-08-13T16:19:42.870Z",
    "updated_at": "2024-08-14T15:06:56.792Z",
    "type": "smart_trade"
  },
  "profit": {
    "volume": "-0.09787447584",
    "usd": "-0.09787447584",
    "percent": "-2.14",
    "roe": null
  },
  "margin": {
    "amount": null,
    "total": null
  },
  "is_position_not_filled": false
}