批量下单

描述

批量下单

HTTP请求

POST /api/v2/spot/trade/batch-orders

请求参数

参数名	参数类型	是否必须	描述
symbol	String	否	交易对名称，如BTCUSDT
userId	String	否	用户
channelApiCode	String	否	head中的X-CHANNEL-API-CODE, 默认 nul
orderList		是	下单订单集合，最大长度：50
side	String	是	交易方向 `buy：买入` `sell：卖出`
orderType	String	是	订单类型 limit限价 market市价
force	String	是	执行策略（orderType为market时无效） gtc普通限价单，一直有效直至取消 post_only 只做 maker 订单 fok全部成交或立即取消 ioc立即成交并取消剩余
price	String	否	限价价格价格小数位、价格步长可以通过获取交易对信息接口获取
size	String	是	委托数量对于Limit和Market-Sell订单，此参数表示base coin数量; 对于Market-Buy订单，此参数表示quote coin数量；数量小数位可以通过获取交易对信息接口获取
clientOid	String	否	自定义订单ID
stpMode	String	否	自成交限制，CO、CN、CB

返回参数

返回字段	参数类型	描述
successList	Array	成功订单数组
> orderId	String	订单ID
> clientOid	String	客户端订单ID
failureList	Array	失败订单数组
> orderId	String	订单ID
> clientOid	String	客户端订单ID
> errorMsg	String	错误信息
> errorCode	String	错误码

请求示例

{
    "orderList": [
        {
            "clientOid": "osl-global-eth-usdtXMRX3ea35dac900007",
            "force": "post_only",
            "orderType": "limit",
            "price": "100000.29",
            "side": "sell",
            "size": "0.1"
        }
    ],
    "symbol": "BTCUSD",
    "userId": "1009178902657"
}

返回示例

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1766047171207,
    "data": {
        "successList": [
            {
                "orderId": "1385467742622101504",
                "clientOid": "osl-global-eth-usdtXMRX3ea35dac900007"
            }
        ],
        "failureList": []
    }
}