Add funds for SmartTrades

POST

/v2/smart_trades/:id/add_funds

Permission: SMART_TRADES_WRITE

Security: SIGNED

Adds funds in SmartTrade, increasing the volume of the trade and averaging the price at any moment.

The endpoint is available for SmartTrades with statuses waiting_position and waiting_targets, but not for SmartTrades with trailing enabled, or for the types simple_buy and simple_sell.

---

Path Parameter

idintegerrequired

Unique 3Commas ID for this SmartTrade entity.

Body Parameters

order_typeintegerrequired

Order type for add funds in this SmartTrade: market, limit.

unitsobjectrequired

Defines the amount of units to add in this SmartTrade

Hide child parametersShow child parameters

valuenumberrequired

Specifies the number of units to buy

priceobjectrequired

Provides pricing details for the limit order. This parameter is required if order_type is set to limit.

Hide child parametersShow child parameters

valuenumberrequired

Price for limit order

Example Request

POST

/v2/smart_trades/30415988/add_funds

{
  "order_type": "limit",
  "units": [
    {
      "value": "14.60138226"
    },
    {
      "value": "14.60138226"
    }
  ]
}

Response Parameters

If successful, the response includes an updated copy of the SmartTrade entity.

Example Responses

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
}

400 Bad Request

{
  "error": "record_invalid",
  "error_description": "Invalid parameters",
  "error_attributes": {
    "order_type": [
      "is missing",
      "does not have a valid value"
    ],
    "units": [
      "is missing"
    ],
    "units[value]": [
      "is missing"
    ]
  }
}

422 Unprocessable Entity

{
  "error": "record_invalid",
  "error_description": "Invalid parameters",
  "error_attributes": {
    "total": [
      "must be greater than or equal to 1.125"
    ]
  }
}