币安现货普通 MARKET BUY 按金额买,应填 quoteOrderQty;按要买多少个币,则填 quantity。例如 BTCUSDT 中,用 100 USDT 买 BTC,传的是 quoteOrderQty=100;quantity=100 的含义却是买 100 BTC。先核对单位,比事后从成交回报猜字段安全得多。
别把报价货币、成交数量和手续费混成一个值
| 订单目标(以 BTCUSDT 为例) | 填写字段 | 单位 |
|---|---|---|
| 按 100 USDT 金额买 BTC | quoteOrderQty | USDT |
| 买或卖 0.001 BTC | quantity | BTC |
| 市价卖出,按希望收到的报价金额表达 | quoteOrderQty | USDT,成交结果以回报为准 |
假设卖盘依次来自不同价位,同样 100 USDT 买到的 BTC 不会按你打开页面时看到的单一价格计算。报价数量也不是在任何情况下都等于钱包的最终变化:成交、计费币种、佣金与到账数量应分别对账。它不是限价参数,也不保证某个均价。
从预检到对账,读这几个字段
发单前读交易对信息,核对 baseAsset、quoteAsset、市价按报价金额能力和现行过滤器;客户端同一笔订单只传一个数量字段,不把两套模板拼在一起。集成验证可先用测试单检查参数,但测试单不会给出真实成交或成本。
实际成交后,用 executedQty 看成交了多少 BTC,用 cummulativeQuoteQty 看累计报价金额,再看成交明细中的手续费资产及金额。请求超时且无法判断是否已下单时,先用原客户端订单号查状态,不要换一个订单号直接重发。
如果字段填对了但订单仍被拒绝,再核对币安现货最低下单金额。
常见问题
Q:限价单也能用 quoteOrderQty 吗?
A:这里说的是普通市价单。现货限价单按其接口传价格和基础资产数量,不照搬市价参数。
Q:能用当前价格把金额换成币数再传 quantity 吗?
A:这样限制的是币数,不是预算。行情在发单到撮合之间变化时,实际支付金额可能与估算不同。
参考资料
- Binance·Spot API 术语与参数,日期:2026-11-20
- Binance·Spot API 交易接口,日期:2026-11-20



