mirror of
https://github.com/discountry/ritmex-bot.git
synced 2026-09-11 17:28:08 +00:00
add docs
This commit is contained in:
discountry
+263
@@ -0,0 +1,263 @@
|
||||
---
|
||||
title: "New Order | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api"
|
||||
fetched_at: "2026-01-27T05:28:31.928Z"
|
||||
---
|
||||
# New Order(TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api)
|
||||
|
||||
Send in a new order.
|
||||
|
||||
## Method[](https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api)
|
||||
|
||||
`order.place`
|
||||
|
||||
## Request[](https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api)
|
||||
|
||||
```
|
||||
{ "id": "3f7df6e3-2df4-44b9-9919-d2f38f90a99a", "method": "order.place", "params": { "apiKey": "HMOchcfii9ZRZnhjp2XjGXhsOBd6msAhKz9joQaWwZ7arcJTlD2hGPHQj1lGdTjR", "positionSide": "BOTH", "price": 43187.00, "quantity": 0.1, "side": "BUY", "symbol": "BTCUSDT", "timeInForce": "GTC", "timestamp": 1702555533821, "type": "LIMIT", "signature": "0f04368b2d22aafd0ggc8809ea34297eff602272917b5f01267db4efbc1c9422" }}
|
||||
```
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api)
|
||||
|
||||
**0**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api)
|
||||
|
||||
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
|
||||
|
||||
timeInForce
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
quantity
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Cannot be sent with `closePosition`\=`true`(Close-All)
|
||||
|
||||
reduceOnly
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
"true" or "false". default "false". Cannot be sent in Hedge Mode; cannot be sent with `closePosition`\=`true`
|
||||
|
||||
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,36}$`
|
||||
|
||||
stopPrice
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Used with `STOP/STOP_MARKET` or `TAKE_PROFIT/TAKE_PROFIT_MARKET` orders.
|
||||
|
||||
closePosition
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
`true`, `false`；Close-All，used with `STOP_MARKET` or `TAKE_PROFIT_MARKET`.
|
||||
|
||||
activationPrice
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Used with `TRAILING_STOP_MARKET` orders, default as the latest price(supporting different `workingType`)
|
||||
|
||||
callbackRate
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Used with `TRAILING_STOP_MARKET` orders, min 0.1, max 10 where 1 for 1%
|
||||
|
||||
workingType
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
stopPrice triggered by: "MARK\_PRICE", "CONTRACT\_PRICE". Default "CONTRACT\_PRICE"
|
||||
|
||||
priceProtect
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
"TRUE" or "FALSE", default "FALSE". Used with `STOP/STOP_MARKET` or `TAKE_PROFIT/TAKE_PROFIT_MARKET` orders.
|
||||
|
||||
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; default `NONE`
|
||||
|
||||
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 253402300799000
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
Additional mandatory parameters based on `type`:
|
||||
|
||||
Type
|
||||
|
||||
Additional mandatory parameters
|
||||
|
||||
`LIMIT`
|
||||
|
||||
`timeInForce`, `quantity`, `price` or `priceMatch`
|
||||
|
||||
`MARKET`
|
||||
|
||||
`quantity`
|
||||
|
||||
`STOP/TAKE_PROFIT`
|
||||
|
||||
`quantity`, `stopPrice`, `price` or `priceMatch`
|
||||
|
||||
`STOP_MARKET/TAKE_PROFIT_MARKET`
|
||||
|
||||
`stopPrice`
|
||||
|
||||
`TRAILING_STOP_MARKET`
|
||||
|
||||
`callbackRate`
|
||||
|
||||
> - Order with type `STOP`, parameter `timeInForce` can be sent ( default `GTC`).
|
||||
>
|
||||
> - Order with type `TAKE_PROFIT`, parameter `timeInForce` can be sent ( default `GTC`).
|
||||
>
|
||||
> - Condition orders will be triggered when:
|
||||
>
|
||||
> - If parameter`priceProtect`is sent as true:
|
||||
> - when price reaches the `stopPrice` ，the difference rate between "MARK\_PRICE" and "CONTRACT\_PRICE" cannot be larger than the "triggerProtect" of the symbol
|
||||
> - "triggerProtect" of a symbol can be got from `GET /fapi/v1/exchangeInfo`
|
||||
> - `STOP`, `STOP_MARKET`:
|
||||
> - BUY: latest price ("MARK\_PRICE" or "CONTRACT\_PRICE") >= `stopPrice`
|
||||
> - SELL: latest price ("MARK\_PRICE" or "CONTRACT\_PRICE") <= `stopPrice`
|
||||
> - `TAKE_PROFIT`, `TAKE_PROFIT_MARKET`:
|
||||
> - BUY: latest price ("MARK\_PRICE" or "CONTRACT\_PRICE") <= `stopPrice`
|
||||
> - SELL: latest price ("MARK\_PRICE" or "CONTRACT\_PRICE") >= `stopPrice`
|
||||
> - `TRAILING_STOP_MARKET`:
|
||||
> - BUY: the lowest price after order placed `<=` activationPrice`, and the latest price >`\= the lowest price \* (1 + `callbackRate`)
|
||||
> - SELL: the highest price after order placed >= `activationPrice`, and the latest price <= the highest price \* (1 - `callbackRate`)
|
||||
> - For `TRAILING_STOP_MARKET`, if you got such error code.
|
||||
> `{"code": -2021, "msg": "Order would immediately trigger."}`
|
||||
> means that the parameters you send do not meet the following requirements:
|
||||
>
|
||||
> - BUY: `activationPrice` should be smaller than latest price.
|
||||
> - SELL: `activationPrice` should be larger than latest price.
|
||||
> - 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.
|
||||
> - `STOP_MARKET`, `TAKE_PROFIT_MARKET` with `closePosition`\=`true`:
|
||||
>
|
||||
> - Follow the same rules for condition orders.
|
||||
> - If triggered，**close all** current long position( if `SELL`) or current short position( if `BUY`).
|
||||
> - Cannot be used with `quantity` paremeter
|
||||
> - Cannot be used with `reduceOnly` parameter
|
||||
> - In Hedge Mode,cannot be used with `BUY` orders in `LONG` position side. and cannot be used with `SELL` orders in `SHORT` position side
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api)
|
||||
|
||||
```
|
||||
{ "id": "3f7df6e3-2df4-44b9-9919-d2f38f90a99a", "status": 200, "result": { "orderId": 325078477, "symbol": "BTCUSDT", "status": "NEW", "clientOrderId": "iCXL1BywlBaf2sesNUrVl3", "price": "43187.00", "avgPrice": "0.00", "origQty": "0.100", "executedQty": "0.000", "cumQty": "0.000", "cumQuote": "0.00000", "timeInForce": "GTC", "type": "LIMIT", "reduceOnly": false, "closePosition": false, "side": "BUY", "positionSide": "BOTH", "stopPrice": "0.00", "workingType": "CONTRACT_PRICE", "priceProtect": false, "origType": "LIMIT", "priceMatch": "NONE", "selfTradePreventionMode": "NONE", "goodTillDate": 0, "updateTime": 1702555534435 }, "rateLimits": [ { "rateLimitType": "ORDERS", "interval": "SECOND", "intervalNum": 10, "limit": 300, "count": 1 }, { "rateLimitType": "ORDERS", "interval": "MINUTE", "intervalNum": 1, "limit": 1200, "count": 1 }, { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 1 } ]}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api)
|
||||
- [Method](https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api)
|
||||
- [Request](https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api)
|
||||
Reference in New Issue
Block a user