You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

调用币安期货/fapi/v1/order接口报错-1117 Invalid side如何解决

币安期货API -1117 Invalid side 错误解决方案

核心错误原因

你完全传错了参数名,币安/fapi/v1/order接口不存在position参数,方向类参数要求如下:

  • 单向持仓模式下,仅需传side参数,取值为BUY(开多/平空)或SELL(开空/平多)
  • 双向持仓模式下,需要同时传side和positionSide两个参数:
    • 开多:side=BUY + positionSide=LONG
    • 开空:side=SELL + positionSide=SHORT

你此前修改的都是不存在的position参数的值,接口无法识别到必填的side参数,所以始终返回方向无效的错误。

其他参数错误

你的代码还有两处参数不匹配问题:

  • 订单类型参数名不是market_type,官方要求的参数名为type
  • 缺少必填的开仓数量参数quantity,需要填写对应交易对的下单数量,且小数位要符合交易对精度要求

正确调用示例

双向持仓开多示例

futures.orders.create(
    symbol='ADAUSDT',
    type="TRAILING_STOP_MARKET",
    side="BUY",
    positionSide="LONG",
    activationPrice=1.80,
    callbackRate=2.0,
    quantity=10 # 替换为你的实际开仓数量
)

单向持仓开多示例

futures.orders.create(
    symbol='ADAUSDT',
    type="TRAILING_STOP_MARKET",
    side="BUY",
    activationPrice=1.80,
    callbackRate=2.0,
    quantity=10 # 替换为你的实际开仓数量
)

补充注意事项

  • 所有枚举参数值都要使用全大写格式,不要加多余字符
  • 追踪止损的callbackRate为百分比值,你传的2.0对应2%,符合参数要求

内容的提问来源于stack exchange,提问作者YetAnotherDuck

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.21 04:54:11