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

调用Binance.Net下单报Filter failure: MIN_NOTIONAL错误求助

错误根因

-1013 Filter failure: MIN_NOTIONAL和API密钥配置、参数格式正确性无关,是触发了币安交易对的强制交易规则:你提交的订单总名义价值(即按计价币折算的订单总金额,例如BTCUSDT交易对的名义价值为订单折合的USDT总额)未达到该交易对设置的最低下单金额要求。

注意该规则对市价单、限价单同时生效:

  • 限价单按下单数量 * 挂单价格计算名义价值
  • 市价单按下单时刻盘口最优可成交价格预估名义价值,折算后总金额不达阈值同样会报错,不存在市价单跳过该校验的情况
排查&解决方法
  1. 先获取目标交易对的规则阈值,Binance.Net已经封装了对应查询接口,无需手动硬编码各交易对参数:
    // 获取指定交易对的交易规则
    var exchangeInfoRes = await client.SpotApi.ExchangeData.GetExchangeInfoAsync(order.symbol);
    var targetSymbolRule = exchangeInfoRes.Data.Symbols.First(s => s.Name.Equals(order.symbol, StringComparison.OrdinalIgnoreCase));
    // 提取最小名义价值阈值
    var minNotionalConfig = targetSymbolRule.Filters.OfType<MinNotionalFilter>().First();
    decimal minRequiredTotal = minNotionalConfig.MinNotional;
    
  2. 下单前做前置校验,避免触发拦截:
    • 限价单:计算order.orderqty * order.price的结果,确保数值≥minRequiredTotal,建议预留0.01%左右的余量,避免精度截断导致计算值刚好等于阈值时被拦截
    • 市价单:如果按基础币数量下单,先拉取当前最新成交价,计算下单数量 * 最新成交价的折算总额,确认达标后再提交;更稳妥的方式是直接按计价币金额传参下市价单(例如BTCUSDT市价买100USDT的BTC,直接传quoteQuantity参数,不传基础币数量),只要传入的计价币金额达标就不会触发该报错,也能避免盘口短时波动导致预估值不足的问题
常见踩坑提醒
  • 不同交易对的MIN_NOTIONAL阈值不统一,主流币交易对阈值通常为10USDT左右,小市值币种阈值可能更高,不能用固定下单量适配所有交易对
  • 校验时要同步注意交易对的数量精度、价格精度限制,传入超过精度的小数位可能触发其他过滤器报错
  • 该规则是币安交易引擎层面的强制校验,无法通过客户端参数调整绕过,必须满足阈值要求才能成功下单

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.27 16:48:44