Place Order

Create new order, supports limit and market orders.

API Information

• Method: POST
• Path: /api/v1/orders
• Authentication: Requires signature authentication (see Common Module · Signature Specification)

Request Parameters (Body)

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair, e.g. BTC_USDT
side	string	Yes	Side: buy / sell
type	string	Yes	Type: limit / market_buy / market_sell
price	string	Conditional	Price (required for limit orders)
qty	string	Conditional	Quantity (required for limit orders and market sell)
quote_qty	string	Conditional	Amount (required for market buy)
client_order_id	string	No	Client order ID (idempotent)
resp_type	string	No	Response type: ACK (default) / RESULT / FULL
need_cache	boolean	No	Whether bot order is cached (bot use only)

Request Example

{
  "symbol": "BTC_USDT",
  "side": "buy",
  "type": "limit",
  "price": "30000",
  "qty": "0.1",
  "client_order_id": "my-order-001",
  "resp_type": "ACK"
}

Response Fields

Field	Type	Description
code	integer	Status code, 0 indicates success
message	string	Response message
data.order_id	string	Order ID
data.client_order_id	string	Client order ID
data.status	integer	Status: 1=NEW, 2=PARTIAL_FILLED, 3=FILLED, 4=CANCELED (returned by RESULT/FULL)
data.filled_qty	string	Filled quantity (returned by RESULT/FULL)
data.filled_quote	string	Filled amount (returned by RESULT/FULL)
data.trades	array	Trade details (returned by FULL)
data.trades[].maker_order_id	string	Maker order ID
data.trades[].match_id	string	Match ID
data.trades[].price	string	Trade price
data.trades[].qty	string	Trade quantity
data.trades[].quote_qty	string	Trade amount
data.trades[].trade_index	integer	Trade index

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "order_id": "1234567890123456789",
    "client_order_id": "my-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
      }
    ]
  }
}