币安市价单想按金额买,API 该填 quantity 还是 quoteOrderQty?

 / 
3

币安现货普通 MARKET BUY 按金额买,应填 quoteOrderQty;按要买多少个币,则填 quantity。例如 BTCUSDT 中,用 100 USDT 买 BTC,传的是 quoteOrderQty=100;quantity=100 的含义却是买 100 BTC。先核对单位,比事后从成交回报猜字段安全得多。

Binance币安
全球交易量最大的加密货币交易所,安全性与流动性行业领先
新手福利:注册立享20%手续费折扣优惠!

别把报价货币、成交数量和手续费混成一个值

订单目标(以 BTCUSDT 为例)填写字段单位
按 100 USDT 金额买 BTCquoteOrderQtyUSDT
买或卖 0.001 BTCquantityBTC
市价卖出,按希望收到的报价金额表达quoteOrderQtyUSDT,成交结果以回报为准

假设卖盘依次来自不同价位,同样 100 USDT 买到的 BTC 不会按你打开页面时看到的单一价格计算。报价数量也不是在任何情况下都等于钱包的最终变化:成交、计费币种、佣金与到账数量应分别对账。它不是限价参数,也不保证某个均价。

从预检到对账,读这几个字段

发单前读交易对信息,核对 baseAsset、quoteAsset、市价按报价金额能力和现行过滤器;客户端同一笔订单只传一个数量字段,不把两套模板拼在一起。集成验证可先用测试单检查参数,但测试单不会给出真实成交或成本。

实际成交后,用 executedQty 看成交了多少 BTC,用 cummulativeQuoteQty 看累计报价金额,再看成交明细中的手续费资产及金额。请求超时且无法判断是否已下单时,先用原客户端订单号查状态,不要换一个订单号直接重发。

如果字段填对了但订单仍被拒绝,再核对币安现货最低下单金额。

常见问题

Q:限价单也能用 quoteOrderQty 吗?

A:这里说的是普通市价单。现货限价单按其接口传价格和基础资产数量,不照搬市价参数。

Q:能用当前价格把金额换成币数再传 quantity 吗?

A:这样限制的是币数,不是预算。行情在发单到撮合之间变化时,实际支付金额可能与估算不同。

Binance币安
全球交易量最大的加密货币交易所,安全性与流动性行业领先
新手福利:注册立享20%手续费折扣优惠!

参考资料

  1. Binance·Spot API 术语与参数,日期:2026-11-20
  2. Binance·Spot API 交易接口,日期:2026-11-20