跳到主要内容

时间加权平均价格策略(Twap)下单(TRADE)

接口描述​

发送Twap下单 仅支持U本位合约

HTTP请求​

POST /sapi/v1/algo/futures/newOrderTwap

请求权重(UID)​

3000

请求参数​

名称类型是否必需描述
symbolSTRINGYES交易对 eg. BTCUSDT
sideENUMYES买卖方向 ( BUY or SELL )
positionSideENUMNO持仓方向，单向持仓模式下非必填，默认且仅可填BOTH;在双向持仓模式下必填,且仅可选择 LONG 或 SHORT
quantityDECIMALYES下单数量， 以合约币种（base asset）个数下单; 名义价值 (quantity * 标记价格(base asset)) 需要大于 1,000 USDT，且不超过 1,000,000 USDT
durationLONGYES请请以秒为单位发送[300,86400]
clientAlgoIdSTRINGNO必须传入32位，如果未发送，则自动生成
reduceOnlyBOOLEANNOtrue, false; 非双开模式下默认false；双开模式下不接受此参数； 开仓不接受此参数
limitPriceDECIMALNO限价单价格; 若未发送，则以市场价下单
recvWindowLONGNO
timestampLONGYES
  • 最大所有策略订单挂单数量： 30。
  • 杠杆倍数和持仓模式与您的合约账户设置相同，您可以通过合约交易页面设置或者通过fapi设置。
  • 收到 "success": true 不代表您的订单一定会被执行。请通过查询订单接口（GET sapi/v1/algo/futures/openOrders 或者 GET sapi/v1/algo/futures/historicalOrders）以获取订单状态。 例如: 如果您的合约账户余额不足，或者开仓使用了reduce only参数，或者您下单选择的持仓模式与您设置的不符，这些情况您都会收到响应 "success": true，但订单状态会显示为 expired，代表订单过期。
  • quantity * 60 / duration 必须大于minQty。
  • duration 不能小于5分钟，且不能大于24小时。
  • 对于U本位交割合约, TWAP 的结束时间必须早于交割时间1小时。
  • 您的 API Key 需要开通 允许合约交易 权限
  • 请使用Base URL: https://api.binance.com

响应示例​

{
    "clientAlgoId": "65ce1630101a480b85915d7e11fd5078", //用户自定义策略订单ID
    "success": true, 
    "code": 0,
    "msg": "OK"
}