Skip to Content
📈 Futures API交易接口批量下单

批量下单

POST /ftapi/v1/batchOrders

访问频率限制

  • 每分钟 120 个请求。
  • 每秒 2 个请求。

请求参数

名称类型描述
symbolIdSTRING交易对，如 BTC-USDT-M
sideENUM买卖方向：详见 OrderSide
typeENUM订单类型，详见 OrderType
timeInForceENUM有效方式，详见 TimeInForce
quantityDECIMAL下单数量 减仓单不传数量为全部平仓
priceDECIMAL委托价格
reduceOnlyBOOLEAN只减仓 false=否 true=是
postOnlyBOOLEAN是否仅挂单（Post Only）
reverseOrderBOOLEAN反向订单 false=否 true=是
tpSl止盈止损
tpTriggerTypeENUM止盈触发类型，详见 TriggerTypeEnum
tpPriceDECIMAL止盈价格
tpExecutePriceDECIMAL止盈执行价格
slTriggerTypeENUM止损触发类型，详见 TriggerTypeEnum
slPriceDECIMAL止损价格
slExecutePriceDECIMAL止损执行价格

根据 type 的不同，某些参数有强制要求：

Type强制要求的参数其他信息
LIMITquantity, price

请求示例

[
    {
        "symbolId": "BTC-USDT-M",
        "side": "BUY",
        "price": 106000,
        "quantity": 10,
        "type": "LIMIT",
        "timeInForce": "GTC",
        "postOnly": false,
        "tpSl": {
            "tpTriggerType": "NONE",
            "tpPrice": 0,
            "tpExecutePrice": 0,
            "slTriggerType": "NONE",
            "slPrice": 0,
            "slExecutePrice": 0
        }
    },
    {
        "symbolId": "BTC-USDT-M",
        "side": "BUY",
        "price": 106000,
        "quantity": 10,
        "type": "LIMIT",
        "timeInForce": "GTC",
        "postOnly": false,
        "tpSl": {
            "tpTriggerType": "NONE",
            "tpPrice": 0,
            "tpExecutePrice": 0,
            "slTriggerType": "NONE",
            "slPrice": 0,
            "slExecutePrice": 0
        }
    }
]

响应示例

{
    "code": "0",
    "data": true,
    "msg": "Request successful",
    "success": true
}

错误码解释

代码描述
700000系统错误
700001仓位不存在
700004请求参数不合法
700008请求超时
700009非法参数
700011非法的价格
700012非法的下单数量
700013调整保证金超出最大值
700016当前方向持仓数量已经超过最大可开上限，请调整风险限制
700017余额不足
700018挂单不足
700019非法的杠杆倍数
700022可平数量不足
700040触发价格与当前价格较近，有可能被立即触发
700041此合约不允许交易
700042请选择止盈或止损
700043止盈触发价大于开仓均价
700044止盈触发价小于开仓均价
700045止损触发价小于开仓均价
700046止损触发价大于开仓均价
700047触发价格与开仓价格较近，有可能被立即触发
700048订单状态异常
700052超过最大委托单数
700057止损触发价不能低于预估强平价
700058止损触发价不能高于预估强平价
700060下单数量不得小于最小下单量
700061用户被禁止交易
700062用户被禁止开仓
700068止盈价格需大于委托价格
700069止盈价格需大于当前价格
700070止损价格需小于委托价格
700071止损价格需小于当前价格
700072止盈价格需小于委托价格
700073止盈价格需小于当前价格
700074止损价格需大于委托价格
700075止损价格需大于当前价格
700076止盈价格需大于标记价格
700077止盈价格需小于标记价格
700078止损价格需大于标记价格
700079止损价格需小于标记价格
700080止损价格需小于强平价格
700081止损价格需大于强平价格
700082下单数量不得大于最大下单量
700089止盈委托价需大于开仓价格
700091止盈委托价需小于开仓价格
700093止损委托价需小于开仓价格
700095止损委托价需大于开仓价格
700096止盈委托价需大于当前最新价格
700097止盈委托价需小于当前最新价格
700098止损委托价需小于当前最新价
700099止损委托价需大于当前最新价
700106下单失败，请稍后再试或联系客服

代码示例

最后更新于:
下单修改订单