币安Python SDK下达OCO全额卖单触发MIN_NOTATIONAL报错
问题根因定位
- 触发
MIN_NOTATIONAL报错的核心逻辑是:币安对每个交易对设置强制的最小订单名义价值(下单数量*挂单价格)阈值,只要订单总价值低于该阈值就会拦截下单。当前BTC计价类交易对的常规最低名义价值为0.0001BTC,即10000聪。 - OCO订单的特殊规则:OCO订单会被交易所拆分为两个独立订单(限价卖出腿、止损限价卖出腿),两个腿的名义价值都需要单独满足最低名义价值要求,只要任意一个不达标就会触发拦截。
- 按给出的参数核算实际名义价值:5个VIA * 挂单价格0.00001770 BTC/VIA = 0.0000885 BTC,低于0.0001BTC的最低阈值,本身就不满足下单条件。
- 附带存在代码逻辑疏漏:封装的
sellAmount函数中,虽然计算了按99.5%折算的卖出量maxSell,但最终返回的是未折算的原始全量余额,预留手续费的逻辑完全没有生效。 - 隐性精度问题:直接用Python float类型传参,容易出现浮点精度丢失,导致实际传递给接口的下单数量比预期值略低,进一步拉低订单名义价值触发报错。
解决方案
- 先通过官方接口拉取目标交易对的精确交易规则,不要凭经验判断阈值:调用
client.get_symbol_info('VIABTC')获取规则,重点提取三类限制:LOT_SIZE过滤器:对应下单数量的步进精度、最小/最大允许下单数量PRICE_FILTER过滤器:对应挂单价格的精度要求MIN_NOTIONAL过滤器:对应交易对要求的最低订单名义价值
- 修复卖出量计算逻辑,按交易对规则对齐精度:
修正后的函数示例:def get_valid_sell_qty(coin, symbol, order_price): # 获取交易对交易规则 symbol_rules = client.get_symbol_info(symbol) # 提取下单数量步进、最小下单量 lot_rule = next(f for f in symbol_rules['filters'] if f['filterType'] == 'LOT_SIZE') step_size = float(lot_rule['stepSize']) min_qty = float(lot_rule['minQty']) # 提取最低名义价值要求 min_notional = float(next(f for f in symbol_rules['filters'] if f['filterType'] == 'MIN_NOTIONAL')['minNotional']) # 获取对应币种的自由余额 free_balance = float(client.get_asset_balance(asset=coin, recvWindow=10000)['free']) # 预留0.5%余额覆盖手续费,避免100%持仓下单因手续费不足报错 target_qty = free_balance * 0.995 # 按数量步进对齐取整,避免精度不符合要求 valid_qty = int(target_qty / step_size) * step_size # 校验下单条件 if valid_qty < min_qty: raise ValueError(f"下单数量{valid_qty}低于该交易对最小下单量{min_qty}") if valid_qty * order_price < min_notional: raise ValueError(f"订单名义价值{valid_qty * order_price}BTC低于该交易对最低要求{min_notional}BTC") # 转为字符串传参,避免float精度丢失 return f"{valid_qty:.8f}".rstrip('0').rstrip('.') - 调用接口时,所有数值类参数(挂单价格、止损价格、下单数量)都统一用字符串格式传入,规避Python float浮点精度偏移问题。
- 如果当前持仓计算的名义价值确实低于阈值,可通过两种方式满足要求:
- 适当提高挂单价格,直到订单总价值达到最低名义阈值要求。例:将挂单价格调整为0.00002000BTC时,5个VIA的总名义价值为0.0001BTC,刚好满足最低要求。
- 补充对应币种持仓,让计算出的订单名义价值高于阈值。
内容的提问来源于stack exchange,提问作者RubenTGT
相关产品推荐
相关产品推荐

