Bot Place Order

Bot-specific place order interface, does not freeze assets or write to DB, only sends to matching engine.

🔒 Requires IP whitelist authorization.

API Information

• Method: POST
• Path: /api/v1/bot/orders

Request Parameters (Body)

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair
side	string	Yes	Direction: buy / sell
type	string	Yes	Type: limit / market_buy / market_sell
price	string	Conditional	Price (required for limit orders)
qty	string	Conditional	Quantity
quote_qty	string	Conditional	Amount (required for market buy)
client_order_id	string	No	Client order ID
resp_type	string	No	Response type: ACK (default) / RESULT / FULL
need_cache	boolean	No	Whether to cache bot order (default false)

Request Example

{
  "symbol": "BTC_USDT",
  "side": "buy",
  "type": "limit",
  "price": "30000",
  "qty": "0.1",
  "client_order_id": "bot-order-001",
  "need_cache": true
}

Response Fields

Response fields same as "Place Order" interface.

Field	Type	Description
code	integer	Status code
message	string	Response message
data.order_id	string	Order ID
data.client_order_id	string	Client order ID
data.status	integer	Status
data.filled_qty	string	Filled quantity
data.filled_quote	string	Filled amount
data.trades	array	Trade details

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "order_id": "1234567890123456789",
    "client_order_id": "bot-order-001",
    "status": 1,
    "filled_qty": "0.05",
    "filled_quote": "1500",
    "trades": [
      {
        "maker_order_id": "1234567890123",
        "match_id": "9876543210",
        "price": "30000",
        "qty": "0.05",
        "quote_qty": "1500",
        "trade_index": 0
      }
    ]
  }
}