# Place Order Channel
### Description
:::tip
The ACK response only indicates that the request has been successfully accepted. Please use the [WebSocket order](/docs/uta/websocket/private/Order-Channel) push channel to confirm the actual order status.
:::
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:price 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:price 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.
```json title="Error Code Examples"
{ "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" }
```
```json title="Request Example"
{
"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",
}
]
}
```
### Request Parameters
| Parameter | Type | Required | Description |
|:------------------|:-------------------|----------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| op | String | Yes | Operation:
`trade` |
| id | String | Yes | Request identifier |
| topic | String | Yes | Topic:
`place-order` |
| category | String | Yes | Category (must be lowercase)
`spot`Spot
`margin` Margin
`usdt-futures` USDT futures
`coin-futures` Coin futures
`usdc-futures` USDC futures |
| apiCode | String | No | API rebate identifier |
| requestTime | String | No | Request time (client-side timestamp)
Used to calculate the time difference with `receiveWindow`
If not provided, `receiveWindow` will have no effect |
| args | List<Object> | Yes | Channel list |
| > symbol | String | Yes | Symbol name |
| > [orderType](/docs/uta/enum#ordertype) | String | Yes | Order type
`limit` : Limit order
`market` : Market order |
| > qty | String | Yes | Order quantity
`Spot/Margin`
For market buy orders,the unit is **quote coin**
For limit and market sell orders, the unit is **base coin**
`USDT/USDC-Futures`
The unit is **base coin**
`COIN-Futures`
The unit is **quote coin** |
| > price | String | No | Order price
This field is required when the order type is a `limit` order .
This field is not applicable when the order type is a `market` order. |
| > side | String | Yes | Order side
`buy`
`sell` |
| > posSide | String | No | Position side
`long`
`short`
This field is required in hedge-mode positions.
Available only for futures |
| > timeInForce | String | No | [Time in force](https://www.bitget.com/support/articles/12560603818004)
`gtc`: Good 'til canceled. It remains active until it is either filled or manually canceled.
`ioc`: Immediate or cancel. It must be executed immediately, with any unfilled portion canceled.
`fok`: Fill or kill. It must be fully executed immediately, or it is canceled entirely.
`post_only`: Post only. It will only be added to the order book as a maker.
[`rpi`](https://www.bitget.com/support/articles/12560603867770) Retail Price Improvement order. A non-displayed limit order that provides price improvement for retail order flow. Only available for accounts with RPI market maker permissions.
This field is required when orderType is `limit`. If omitted, it defaults to `gtc` |
| > reduceOnly | String | No | Reduce-only identifier
`YES`/`NO`
default`NO`; `YES` indicates that your position may only be reduced in size upon the activation of this order |
| > clientOid | String | No | Client order ID
Must match the regular expression `^[0-9A-Za-z_:#\-+\s]{1,32}$`, i.e. 1 to 32 characters, consisting of uppercase and lowercase letters, digits, underscores (_), hyphens (-), plus signs (+), colons (:), number signs (#), and spaces |
| > stpMode | String | No | [STP Mode(Self Trade Prevention)](https://www.bitget.com/support/articles/12560603812732)
`none`: STP is not applied; orders are matched normally without comparing user IDs (Default)
`cancel_taker`: when a self-trade is detected, the taker order is canceled and the maker order remains in the order book
`cancel_maker`: when a self-trade is detected, the maker order is canceled and the taker order continues to execute
`cancel_both`: when a self-trade is detected, both the taker and maker orders are canceled
The STP action is determined by the taker order's `stpMode`; the maker order's existing `stpMode` setting is not considered. |
| > tpTriggerBy | String | No | Preset Take-Profit Trigger Type
`market`Market Price
`mark` Mark Price
If not specified, the default value is market price
Note: This field is only valid for the contract business lines: USDT-Futures, COIN-Futures, and USDC-Futures. |
| > slTriggerBy | String | No | Preset Stop-Loss Trigger Type
`market`Market Price
`mark` Mark Price
If not specified, the default value is market price
Note: This field is only valid for the contract business lines: USDT-Futures, COIN-Futures, and USDC-Futures. |
| > takeprofit | String | No | Preset Take-Profit Trigger Price |
| > stoploss | String | No | Preset Stop-Loss Trigger Price |
| > tpOrderType | String | No | Take-Profit Trigger Strategy Order Type
`limit` Limit Order
`market` Market Order |
| > slOrderType | String | No | Stop-Loss Trigger Strategy Order Type
`limit` Limit Order
`market` Market Order |
| > tpLimitPrice | String | No | Take-Profit Strategy Order Execution Price
This field is only valid for limit orders (when `tpOrderType=limit`); it is ignored for market orders. |
| > slLimitPrice | String | No | Stop-Loss Strategy Order Execution Price
This field is only valid for limit orders (when `slOrderType=limit`); it is ignored for market orders. |
| > marginMode | String | No | Margin mode
`crossed` Cross margin
`isolated` Isolated margin
If not provided, defaults to cross margin
Available only for futures |
| > autoBorrow | String | No | Auto borrow switch
`yes` Enable
`no` Disable (default)
Only applicable to spot orders. When enabled, if the obtained coin does not support borrowing while the consumed coin does, and the available balance of the consumed coin is insufficient, the system automatically borrows the consumed coin to make up the shortfall. |
| > receiveWindow | String | No | Valid window period (order TTL mechanism)
Unit: milliseconds. Valid range: [10, 60000]
If not specified, the order remains valid until canceled or filled
Note: `receiveWindow` is only effective when `requestTime` is also provided |
```json title="Response Example"
{
"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"
}
```
### Response Parameters
| Parameters | Type | Description |
|:------------------|:-------------------|:----------------------------------------------------------------------------------------------------------------------------------------------|
| event | String | Event
`trade`/`error` |
| id | String | Request identifier |
| topic | String | Topic
`place-order` |
| category | String | Category
`spot`Spot
`margin` Margin
`usdt-futures` USDT futures
`coin-futures` Coin futures
`usdc-futures` USDC futures |
| args | List<Object> | Channel list |
| > symbol | String | Symbol name |
| > orderId | String | Order ID |
| > clientOid | String | Client order ID |
| > cTime | String | Order creation time
Unix millisecond timestamp |
| > receiveTime | String | Gateway receive time
Unix microsecond timestamp |
| > pushTime | String | Gateway push time
Unix microsecond timestamp |
| code | String | Code |
| msg | String | Message |
| connId | String | Connection ID |
| rateLimit | Array | Rate limit balance array |
| > limit | String | Rate limit quota for this dimension |
| > remaining | String | Remaining available quota |
| ts | String | Timestamp |