Place Order Channel

Description

This endpoint allows order placement across spot, margin, or futures markets, as well as Reality (rToken) stocks, with customizable parameters, including price, quantity, and order type, etc.

• Reality (rToken) rate limit
  User level: 5/sec/UID by default, 30/sec/UID for whitelisted users (contact your BD/RM to apply).

• Futures
  For one-way mode, reduce-only orders are allowed to place. If a reduce only order already exists and the order quantity equals the position size, or if a new reduce only order exceeds the remaining position size, the previous reduction order will be automatically canceled and replaced. In this case, the returned orderId will be null. It is recommended to always provide a clientOid.

• Margin
  Margin orders will automatically trigger fund borrowing.

• Order Check

  • Futures must meet the price multiplier and be a multiple of priceMultiplier, and conform to the pricePrecision decimal places. qty must be greater than or equal to minOrderAmount and be a multiple of sizeMultiplier.
  • Spot must meet the decimal place requirement. qty must be greater than or equal to minOrderAmount.

• Open Position Logic

  • Hedge-mode
    Open long: side=buy & posSide=long
    Open Short: side=sell & posSide=short
    Close long: side=sell & posSide=long
    Close short: side=buy & posSide=short
    
  • One-way-mode
    Open long: side=buy
    Open short: side=sell
    Close long: side=sell & reduceOnly=yes
    Close short: side=buy & reduceOnly=yes
    

• Order Limit

  • Futures: 400 orders across all USDT, Coin-M, and USDC futures trading pairs.
  • Spot: 400 orders across all spot and margin trading pairs.

• ClientOid Constraints Please ensure your clientOid matches the regular expression ^[0-9A-Za-z_:#\\-+\\s]{1,32}$, consisting of 1 to 32 characters, including periods (.), uppercase letters, colons (:), lowercase letters, numbers, underscores (_), and hyphens (-).

• Request Monitor
  The API requests will be monitored. If the total number of orders for a single account (including master and sub-accounts) exceeds a set daily limit (UTC 00:00 - UTC 24:00), the platform reserves the right to issue reminders, warnings, and enforce necessary restrictions. By using the API, clients acknowledge and agree to comply with these terms.

• Error Sample { "code":"40762", "msg":"The order size is greater than the max open size", "requestTime":1627293504612 } This error code may occur in the following scenarios.

  • Insufficient account balance.
  • The position tier for this symbol has reached its limit. Position tiers

• Note: If the following errors occur when placing an order, please use clientOid to query the order details to confirm the final result of the operation.
  

• COIN-M Futures Symbol Format Description:
  

  • The symbol format for the new COIN-M business line is "XXXUSD_CM". For example, the BTCUSD trading pair in COIN-M futures is formatted as BTCUSD_CM.
  • The new COIN-M business line does not support modifying orders, ADL, strategy orders，or preset take-profit/stop-loss orders.

Code
{ "code": "40010", "msg": "Request timed out", "id": 1666268894074, "event":"error" }
{ "code": "40725", "msg": "service return an error", "id": 1666268894071, "event":"error" }
{ "code": "45001", "msg": "Unknown error", "id": 1666268894071, "event":"error" }

Code
{
  "op": "trade",
  "id": "1750034396082",
  "category": "spot",
  "topic": "place-order",
  "requestTime": "1750034396082",
  "args": [
    {
      "orderType": "limit",
      "price": "100",
      "qty": "0.1",
      "side": "buy",
      "symbol": "BTCUSDT",
      "timeInForce": "gtc",
    }
  ]
}

Code
{
  "event": "trade",
  "id": "1750034396082",
  "category": "spot",
  "topic": "place-order",
  "args": [
    {
      "symbol": "BTCUSDT",
      "orderId": "xxxxxxxx",
      "clientOid": "xxxxxxxx",
      "cTime": "1750034397008",
      "receiveTime": "1750034396998123",
      "pushTime": "1750034397076456"
    }
  ],
  "code": "0",
  "msg": "success",
  "connId": "xxxxxxxxxx",
  "rateLimit": [
    {
      "limit": "10",
      "remaining": "9"
    }
  ],
  "ts": "1750034397076"
}