下单

只有当您的账户有足够的资金才能下单。

请求示例

POST /api/v3/order?symbol=MXUSDT&side=BUY&type=LIMIT&quantity=50&price=0.1&timestamp={{timestamp}}&signature={{signature}}

返回示例

{
    "symbol": "MXUSDT",
    "orderId": "06a480e69e604477bfb48dddd5f0b750",
    "orderListId": -1,
    "price": "0.1",
    "origQty": "50",
    "type": "LIMIT",
    "side": "BUY",
    "stpMode": "",
    "transactTime": 1666676533741
}

HTTP请求

POST /api/v3/order

接口权限要求: 现货交易信息写 / SPOT_DEAL_W

限速规则: 与撤单接口共享，12次/秒

请求参数

名称	类型	是否必需	说明
symbol	string	是	交易对
side	ENUM	是	详见枚举定义：订单方向
type	ENUM	是	详见枚举定义：订单类型
quantity	decimal	否	委托数量
quoteOrderQty	decimal	否	委托总额
price	decimal	否	委托价格
newClientOrderId	string	否	客户自定义的唯一订单ID
stpMode	string	否	""-默认值，不限制自成交。“cancel_maker”-取消maker单。“cancel_taker”-取消taker单。“cancel_both”-双方都取消。
recvWindow	long	否	赋值不能大于 60000
timestamp	long	是

基于订单 type不同，强制要求某些参数:

类型	强制要求的参数
`LIMIT`	`quantity`, `price`
`MARKET`	`quantity` or `quoteOrderQty`

其他说明：

stpMode默认为""，为无防止自成交判断；
防止自成交生效条件：

最少创建一组策略组；
stpMode参数不为空；

其他自成交问题，可参考：自成交介绍；
stpMode=""时，不限制自成交.

MARKET：当type是market时，不论是买单或者卖单，quoteOrderQty和quantity参数任选其一。

比如在BTCUSDT上下一个市价买单, 明确的是买入时想要花费的计价资产数量。此时的报单数量将会以市场流动性和quoteOrderQty被计算出来（实际成交数量以最终订单详情为准）。以BTCUSDT为例，quoteOrderQty=100:下买单的时候, 订单会尽可能的买进价值100USDT的BTC.
比如在BTCUSDT上下一个市价卖单, quantity为用户指明能够卖出多少BTC。

返回参数

参数名	数据类型	说明
symbol	string	交易对
orderId	string	订单id
orderListId	string	客户端订单列表
price	string	订单id
origQty	string	委托数量
type	string	订单类型
side	string	订单方向
stpMode	string	否
transactTime	long	下单时间