查询佣金费率 (USER_DATA)
获取当前账户的佣金费率。
查询佣金费率 (USER_DATA) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
symboltimestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
查询佣金费率 (USER_DATA) › 响应
查询佣金费率
symbol订单交易的标准佣金率。
makertakerbuyerseller订单交易的特殊佣金率。
makertakerbuyerseller订单交易的税率。
makertakerbuyerseller使用BNB支付时的佣金折扣。
enabledForAccountenabledForSymboldiscountAssetdiscount当用BNB支付佣金时，在标准佣金上按此比率打折
查询所有订单列表 (USER_DATA)
根据提供的可选参数检索所有的订单列表。
请注意，startTime和endTime之间的时间不能超过 24 小时。
查询所有订单列表 (USER_DATA) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
timestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
fromId提供该项后, startTime 和 endTime 都不可提供
startTimeendTimelimitrecvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查询所有订单列表 (USER_DATA) › 响应
查询所有订单列表
orderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolsymbolorderIdclientOrderIdAll 订单 (USER_DATA)
获取all 账户 订单; active, canceled, 或 filled.
All 订单 (USER_DATA) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
symboltimestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
orderIdstartTimeendTimelimitrecvWindow最大值为 60000 毫秒。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
All 订单 (USER_DATA) › 响应
All 订单
symbolorderIdorderListId除非此单是订单列表的一部分, 否则此值为 -1
clientOrderIdpriceorigQtyexecutedQtycummulativeQuoteQtystatustimeInForcetypesidestopPrice出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
icebergQty仅在请求中发送了 icebergQty 参数时出现。
timeupdateTimeisWorkingorigQuoteOrderQtyworkingTimeselfTradePreventionModepreventedMatchId仅在因 STP 导致订单失效时出现。
preventedQuantity因 STP 导致订单失效的数量。
strategyId仅在下单时提供了 strategyId 参数时出现。
strategyType仅在下单时提供了 strategyType 参数时出现。
trailingDelta订单激活前所需的价格变动。
trailingTime追踪单被激活和跟踪价格变化的时间。
usedSor用于确定订单是否使用SOR的字段。
workingFloor用以定义订单是通过 SOR 还是由订单簿成交的。
pegPriceType挂钩价格类型。仅用于挂钩订单。
pegOffsetType挂钩价格偏移类型。如若需要，仅用于挂钩订单。
pegOffsetValue挂钩价格偏移值。如若需要，仅用于挂钩订单。
peggedPrice订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
expiryReason订单过期的原因。当订单过期时出现。
账户信息 (USER_DATA)
获取当前账户信息。
账户信息 (USER_DATA) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
timestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
omitZeroBalances如果true，将隐藏所有零余额。
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
账户信息 (USER_DATA) › 响应
账户信息
makerCommissiontakerCommissionbuyerCommissionsellerCommissionmakertakerbuyersellercanTradecanWithdrawcanDepositbrokeredrequireSelfTradePreventionpreventSorupdateTimeaccountTypeassetfreelockedpermissionsuid查看账户当前挂单 (USER_DATA)
请小心使用不带symbol参数的调用
查看账户当前挂单 (USER_DATA) › 授权
查看账户当前挂单 (USER_DATA) › 请求权重
此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。
请在限速说明章节中了解更多信息。
6 for a single symbol; 80 when the symbol parameter is omitted
请求头
X-MBX-APIKEY访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
timestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
symbolrecvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查看账户当前挂单 (USER_DATA) › 响应
查看账户当前挂单
symbolorderIdorderListId除非此单是订单列表的一部分, 否则此值为 -1
clientOrderIdpriceorigQtyexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesidestopPrice出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
icebergQty仅在请求中发送了 icebergQty 参数时出现。
timeupdateTimeisWorkingworkingTimeselfTradePreventionModepreventedMatchId仅在因 STP 导致订单失效时出现。
preventedQuantity因 STP 导致订单失效的数量。
strategyId仅在下单时提供了 strategyId 参数时出现。
strategyType仅在下单时提供了 strategyType 参数时出现。
trailingDelta订单激活前所需的价格变动。
trailingTime追踪单被激活和跟踪价格变化的时间。
usedSor用于确定订单是否使用SOR的字段。
workingFloor用以定义订单是通过 SOR 还是由订单簿成交的。
pegPriceType挂钩价格类型。仅用于挂钩订单。
pegOffsetType挂钩价格偏移类型。如若需要，仅用于挂钩订单。
pegOffsetValue挂钩价格偏移值。如若需要，仅用于挂钩订单。
peggedPrice订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
expiryReason订单过期的原因。当订单过期时出现。
查询订单 (USER_DATA)
查询订单状态
查询订单 (USER_DATA) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
symboltimestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
orderIdorigClientOrderIdrecvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查询订单 (USER_DATA) › 响应
查询订单
symbolsymbol.
orderIdorder Id.
orderListId除非此单是订单列表的一部分, 否则此值为 -1
clientOrderIdclient Order Id.
priceprice.
origQtyorig Qty.
executedQtyexecuted Qty.
origQuoteOrderQtyorig Quote Order Qty.
cummulativeQuoteQtycummulative Quote Qty.
statusstatus.
timeInForcetime In Force.
typetype.
sideside.
stopPrice出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
icebergQty仅在请求中发送了 icebergQty 参数时出现。
timetime.
updateTimeupdate Time.
isWorkingis Working.
workingTimeworking Time.
selfTradePreventionModeself Trade Prevention Mode.
preventedMatchId仅在因 STP 导致订单失效时出现。
preventedQuantity因 STP 导致订单失效的数量。
strategyId仅在下单时提供了 strategyId 参数时出现。
strategyType仅在下单时提供了 strategyType 参数时出现。
trailingDelta订单激活前所需的价格变动。
trailingTime追踪单被激活和跟踪价格变化的时间。
usedSor用于确定订单是否使用SOR的字段。
workingFloor用以定义订单是通过 SOR 还是由订单簿成交的。
pegPriceType挂钩价格类型。仅用于挂钩订单。
pegOffsetType挂钩价格偏移类型。如若需要，仅用于挂钩订单。
pegOffsetValue挂钩价格偏移值。如若需要，仅用于挂钩订单。
peggedPrice订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
expiryReason订单过期的原因。当订单过期时出现。
查询订单列表 (USER_DATA)
根据提供的可选参数检索特定的订单列表。
查询订单列表 (USER_DATA) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
timestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
orderListId通过 orderListId 获取订单列表。必须提供 orderListId 或 origClientOrderId。
origClientOrderId通过 listClientOrderId 查询订单列表。orderListId 或 origClientOrderId 必须被提供。
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查询订单列表 (USER_DATA) › 响应
查询订单列表
orderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolsymbolorderIdclientOrderId查询分配结果 (USER_DATA)
检索由 SOR 订单生成引起的分配结果。
查询分配结果 (USER_DATA) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
symboltimestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
startTimeendTimefromAllocationIdlimitorderIdrecvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查询分配结果 (USER_DATA) › 响应
查询分配结果
symbolallocationIdallocationTypeorderIdorderListIdpriceqtyquoteQtycommissioncommissionAssettimeisBuyerisMakerisAllocator查询相关过滤器 (USER_DATA)
用于检索一个账户上指定交易对的 列表。这是唯一一个目前会显示账户是否应用了 MAX_ASSET 过滤器的端点。
查询相关过滤器 (USER_DATA) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
symboltimestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查询相关过滤器 (USER_DATA) › 响应
查询相关过滤器
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · filterType="EXCHANGE_MAX_NUM_ORDERS" | |
| type = object · filterType="EXCHANGE_MAX_NUM_ALGO_ORDERS" | |
| type = object · filterType="EXCHANGE_MAX_NUM_ICEBERG_ORDERS" | |
| type = object · filterType="EXCHANGE_MAX_NUM_ORDER_LISTS" |
filterTypemaxNumOrdersDecision Table
| Variant | Matching Criteria |
|---|---|
| type = object · filterType="PRICE_FILTER" | |
| type = object · filterType="PERCENT_PRICE" | |
| type = object · filterType="PERCENT_PRICE_BY_SIDE" | |
| type = object · filterType="LOT_SIZE" | |
| type = object · filterType="MIN_NOTIONAL" | |
| type = object · filterType="NOTIONAL" | |
| type = object · filterType="ICEBERG_PARTS" | |
| type = object · filterType="MARKET_LOT_SIZE" | |
| type = object · filterType="MAX_NUM_ORDERS" | |
| type = object · filterType="MAX_NUM_ALGO_ORDERS" | |
| type = object · filterType="MAX_NUM_ICEBERG_ORDERS" | |
| type = object · filterType="MAX_POSITION" | |
| type = object · filterType="TRAILING_DELTA" | |
| type = object · filterType="T_PLUS_SELL" | |
| type = object · filterType="MAX_NUM_ORDER_LISTS" | |
| type = object · filterType="MAX_NUM_ORDER_AMENDS" |
filterTypepriceExponentminPricemaxPricetickSizeDecision Table
| Variant | Matching Criteria |
|---|---|
| type = object · filterType="MAX_ASSET" |
filterTypeqtyExponentlimitassetrateLimitTypeintervalintervalNumlimitcount获取 Prevented Matches (USER_DATA)
获取因 STP 而过期的订单列表。
这些是支持的组合：
symbol+preventedMatchIdsymbol+orderIdsymbol+orderId+fromPreventedMatchId(limit默认为 500)symbol+orderId+fromPreventedMatchId+limit
获取 Prevented Matches (USER_DATA) › 授权
获取 Prevented Matches (USER_DATA) › 请求权重
此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。
请在限速说明章节中了解更多信息。
| Case | Weight |
|---|---|
If symbol is invalid | 2 |
Querying by preventedMatchId | 2 |
Querying by orderId | 20 |
请求头
X-MBX-APIKEY访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
symboltimestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
preventedMatchIdorderIdfromPreventedMatchIdlimitrecvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
获取 Prevented Matches (USER_DATA) › 响应
获取 Prevented Matches
symbolpreventedMatchIdtakerOrderIdmakerSymbolmakerOrderIdtradeGroupIdselfTradePreventionModepricemakerPreventedQuantitytransactTime账户成交历史 (USER_DATA)
获取某交易对的成交历史
账户成交历史 (USER_DATA) › 授权
账户成交历史 (USER_DATA) › 请求权重
此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。
请在限速说明章节中了解更多信息。
| Condition | Weight |
|---|---|
| Without orderId | 20 |
| With orderId | 5 |
请求头
X-MBX-APIKEY访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
symboltimestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
orderId必须要和参数symbol一起使用。
startTimeendTimefromId返回该fromId之后的成交，缺省返回最近的成交
limitrecvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
账户成交历史 (USER_DATA) › 响应
账户成交历史
symbolidorderIdorderListIdpriceqtyquoteQtycommissioncommissionAssettimeisBuyerisMakerisBestMatch查询订单列表挂单 (USER_DATA)
查询订单列表挂单
查询订单列表挂单 (USER_DATA) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
timestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查询订单列表挂单 (USER_DATA) › 响应
查询订单列表挂单
orderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolsymbolorderIdclientOrderId查询改单 (USER_DATA)
查询对一个订单的所有改单操作。
查询改单 (USER_DATA) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
symbolorderIdtimestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
fromExecutionIdlimitrecvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查询改单 (USER_DATA) › 响应
查询改单
symbolorderIdexecutionIdorigClientOrderIdnewClientOrderIdorigQtynewQtytime查询未成交的订单计数 (USER_DATA)
显示用户在所有时间间隔内的未成交订单计数。
查询未成交的订单计数 (USER_DATA) › 授权
请求头
X-MBX-APIKEY访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
查询参数
timestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查询未成交的订单计数 (USER_DATA) › 响应
查询未成交的订单计数
rateLimitTypeintervalintervalNumlimitcount