Place Order (TRADE)

POST /api/v3/order

Request Weight

1 on 10s order rate limit(X-ORDER-COUNT-10S); 1 on 1min order rate limit(X-ORDER-COUNT-1M); 0 on IP rate limit(X-USED-WEIGHT-1M);

Request parameters

Parameter	Type	Required?	Description
symbol	String	Yes	Trading pair, e.g. `BTCUSDT`.
side	String	Yes	Order side. Supported values: `BUY`, `SELL`.
type	String	Yes	Order type. Supported values: `LIMIT`, `MARKET`.
timeInForce	String	Conditional	Time-in-force policy. Required when `type = LIMIT`. Supported values: `GTC`, `IOC`, `FOK`.
quantity	String	Yes	Order quantity.
price	String	Conditional	Limit price. Required when `type = LIMIT`.
newClientOrderId	String	No	Client-defined order ID (if omitted, the system assigns one). If an active order already uses the same `newClientOrderId`, the API returns success but does not create a duplicate order.

Request example

Code
curl -X POST "https://api-spot.weex.com/api/v3/order" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*******" \
   -H "ACCESS-PASSPHRASE:*****" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "Content-Type: application/json" \
   -d '{
     "symbol": "BTCUSDT",
     "side": "BUY",
     "type": "LIMIT",
     "timeInForce": "GTC",
     "quantity": "0.01",
     "price": "68900",
     "newClientOrderId": "my-spot-order-001"
   }'

Response parameters

Field	Type	Description
symbol	String	Trading pair.
orderId	Long	Order ID generated by the system.
clientOrderId	String	Client-defined order ID.
transactTime	Long	Order acceptance timestamp (ms).

Response example

Code
{
  "symbol": "BTCUSDT",
  "orderId": 702345678901234567,
  "clientOrderId": "my-spot-order-001",
  "transactTime": 1764506000456
}