add docs

2026-09-11 09:18:08 +00:00 · 2026-02-27 10:52:43 +08:00
parent 422ee6f465
commit 227484152d
568 changed files with 94315 additions and 0 deletions
@@ -0,0 +1,166 @@
+---
+title: "New Um Order | Binance Open Platform"
+source: "https://developers.binance.com/docs/derivatives/portfolio-margin/trade"
+fetched_at: "2026-01-27T05:28:19.372Z"
+---
+# New UM Order (TRADE)
+
+## API Description[](https://developers.binance.com/docs/derivatives/portfolio-margin/trade)
+
+Place new UM order
+
+## HTTP Request[](https://developers.binance.com/docs/derivatives/portfolio-margin/trade)
+
+POST `/papi/v1/um/order`
+
+## Request Weight(Order)[](https://developers.binance.com/docs/derivatives/portfolio-margin/trade)
+
+**1**
+
+## Request Parameters[](https://developers.binance.com/docs/derivatives/portfolio-margin/trade)
+
+Name
+
+Type
+
+Mandatory
+
+Description
+
+symbol
+
+STRING
+
+YES
+
+side
+
+ENUM
+
+YES
+
+positionSide
+
+ENUM
+
+NO
+
+Default `BOTH` for One-way Mode ; `LONG` or `SHORT` for Hedge Mode. It must be sent in Hedge Mode.
+
+type
+
+ENUM
+
+YES
+
+`LIMIT`, `MARKET`
+
+timeInForce
+
+ENUM
+
+NO
+
+quantity
+
+DECIMAL
+
+NO
+
+reduceOnly
+
+STRING
+
+NO
+
+"true" or "false". default "false". Cannot be sent in Hedge Mode .
+
+price
+
+DECIMAL
+
+NO
+
+newClientOrderId
+
+STRING
+
+NO
+
+A unique id among open orders. Automatically generated if not sent. Can only be string following the rule: `^[\.A-Z\:/a-z0-9_-]{1,32}$`
+
+newOrderRespType
+
+ENUM
+
+NO
+
+`ACK`, `RESULT`, default `ACK`
+
+priceMatch
+
+ENUM
+
+NO
+
+only avaliable for `LIMIT`/`STOP`/`TAKE_PROFIT` order; can be set to `OPPONENT`/ `OPPONENT_5`/ `OPPONENT_10`/ `OPPONENT_20`: /`QUEUE`/ `QUEUE_5`/ `QUEUE_10`/ `QUEUE_20`; Can't be passed together with `price`
+
+selfTradePreventionMode
+
+ENUM
+
+NO
+
+`NONE`:No STP / `EXPIRE_TAKER`:expire taker order when STP triggers/ `EXPIRE_MAKER`:expire taker order when STP triggers/ `EXPIRE_BOTH`:expire both orders when STP triggers
+
+goodTillDate
+
+LONG
+
+NO
+
+order cancel time for timeInForce `GTD`, mandatory when `timeInforce` set to `GTD`; order the timestamp only retains second-level precision, ms part will be ignored; The goodTillDate timestamp must be greater than the current time plus 600 seconds and smaller than 253402300799000Mode. It must be sent in Hedge Mode.
+
+recvWindow
+
+LONG
+
+NO
+
+timestamp
+
+LONG
+
+YES
+
+Additional mandatory parameters based on type:
+
+Type
+
+Additional mandatory parameters
+
+`LIMIT`
+
+`timeInForce`, `quantity`, `price`
+
+`MARKET`
+
+`quantity`
+
+> -   If `newOrderRespType` is sent as `RESULT` :
+>     -   `MARKET` order: the final FILLED result of the order will be return directly.
+>     -   `LIMIT` order with special `timeInForce`: the final status result of the order(FILLED or EXPIRED) will be returned directly.
+> -   `selfTradePreventionMode` is only effective when `timeInForce` set to `IOC` or `GTC` or `GTD`.
+> -   In extreme market conditions, timeInForce `GTD` order auto cancel time might be delayed comparing to `goodTillDate`
+
+## Response Example[](https://developers.binance.com/docs/derivatives/portfolio-margin/trade)
+
+```
+{    "clientOrderId": "testOrder",    "cumQty": "0",    "cumQuote": "0",    "executedQty": "0",    "orderId": 22542179,    "avgPrice": "0.00000",    "origQty": "10",    "price": "0",    "reduceOnly": false,    "side": "BUY",    "positionSide": "SHORT",    "status": "NEW",    "symbol": "BTCUSDT",    "timeInForce": "GTD",    "type": "MARKET",    "selfTradePreventionMode": "NONE", //self trading preventation mode    "goodTillDate": 1693207680000,      //order pre-set auot cancel time for TIF GTD order     "updateTime": 1566818724722,    "priceMatch": "NONE"}
+```
+
+-   [API Description](https://developers.binance.com/docs/derivatives/portfolio-margin/trade)
+-   [HTTP Request](https://developers.binance.com/docs/derivatives/portfolio-margin/trade)
+-   [Request Weight(Order)](https://developers.binance.com/docs/derivatives/portfolio-margin/trade)
+-   [Request Parameters](https://developers.binance.com/docs/derivatives/portfolio-margin/trade)
+-   [Response Example](https://developers.binance.com/docs/derivatives/portfolio-margin/trade)