账户佣金费率 (USER_DATA)
获取当前账户的佣金费率。
账户佣金费率 (USER_DATA) › 授权
账户佣金费率 (USER_DATA) › 请求参数
id客户端生成的请求标识符。
methodWebSocket API 方法名称。
symboltimestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
apiKey访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
账户佣金费率 (USER_DATA) › 响应
账户佣金费率
idstatussymbol订单成交的标准佣金率。
makertakerbuyerseller订单成交的特殊佣金率。
makertakerbuyerseller订单成交的税费率。
makertakerbuyerseller使用 BNB 支付时的标准佣金折扣信息。
enabledForAccountenabledForSymboldiscountAssetdiscount当用BNB支付佣金时，在标准佣金上按此比率打折。
rateLimitTypeintervalintervalNumlimitcount查询未成交的订单计数 (USER_DATA)
显示用户在所有时间间隔内的未成交订单计数。
查询未成交的订单计数 (USER_DATA) › 授权
查询未成交的订单计数 (USER_DATA) › 请求参数 可选
id客户端生成的请求标识符。
methodWebSocket API 方法名称。
timestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
apiKey访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查询未成交的订单计数 (USER_DATA) › 响应
查询未成交的订单计数
idstatusrateLimitTypeintervalintervalNumlimitcountrateLimitTypeintervalintervalNumlimitcount账户信息 (USER_DATA)
获取当前账户信息。
账户信息 (USER_DATA) › 授权
账户信息 (USER_DATA) › 请求参数 可选
id客户端生成的请求标识符。
methodWebSocket API 方法名称。
timestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
apiKey访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
omitZeroBalances如果true，将隐藏所有零余额。默认值：false。
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
账户信息 (USER_DATA) › 响应
账户信息
idstatusmakerCommissiontakerCommissionbuyerCommissionsellerCommissioncanTradecanWithdrawcanDepositmakertakerbuyersellerbrokeredrequireSelfTradePreventionpreventSorupdateTimeaccountTypeassetfreelockedpermissionsuidrateLimitTypeintervalintervalNumlimitcount账户订单列表历史 (USER_DATA)
查询所有订单列表的信息，按时间范围过滤。
账户订单列表历史 (USER_DATA) › 授权
账户订单列表历史 (USER_DATA) › 请求参数 可选
id客户端生成的请求标识符。
methodWebSocket API 方法名称。
timestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
apiKey访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
fromId起始的 Order list ID
startTime毫秒时间戳
endTime毫秒时间戳
limit默认值: 500; 最大值: 1000
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
账户订单列表历史 (USER_DATA) › 响应
账户订单列表历史
idstatusorderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolsymbolorderIdclientOrderIdrateLimitTypeintervalintervalNumlimitcount账户订单历史 (USER_DATA)
查询所有订单（活动、已撤销、已成交）信息，并按时间范围过滤。
账户订单历史 (USER_DATA) › 授权
账户订单历史 (USER_DATA) › 请求参数
id客户端生成的请求标识符。
methodWebSocket API 方法名称。
symboltimestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
apiKey访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
orderId起始订单ID
startTime毫秒时间戳
endTime毫秒时间戳
limit默认值: 500; 最大值: 1000
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
账户订单历史 (USER_DATA) › 响应
账户订单历史
idstatussymbolorderIdorderListId仅当订单属于订单列表时返回。
clientOrderIdpriceorigQtyexecutedQtycummulativeQuoteQtystatustimeInForcetypesidetime下单时间。
updateTime订单最后更新时间。
isWorkingworkingTimeorigQuoteOrderQty始终返回；若订单类型不使用 quoteOrderQty 则为 0。
selfTradePreventionModepreventedMatchId仅当订单因 STP 过期时返回。
preventedQuantity仅当订单因 STP 过期时返回。
icebergQty仅在请求中发送了 icebergQty 参数时出现。
stopPrice出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
strategyId仅在下单时提供了 strategyId 参数时出现。
strategyType仅在下单时提供了 strategyType 参数时出现。
trailingDelta订单激活前所需的价格变动。
trailingTime追踪单被激活和跟踪价格变化的时间。
usedSor用于确定订单是否使用SOR的字段。
workingFloor用以定义订单是通过 SOR 还是由订单簿成交的。
pegPriceType挂钩价格类型。仅用于挂钩订单。
pegOffsetType挂钩价格偏移类型。如若需要，仅用于挂钩订单。
pegOffsetValue挂钩价格偏移值。如若需要，仅用于挂钩订单。
peggedPrice订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
expiryReason订单过期的原因。当订单过期时出现。
rateLimitTypeintervalintervalNumlimitcount查询分配结果 (USER_DATA)
检索由 SOR 订单生成引起的分配结果。
查询分配结果 (USER_DATA) › 授权
查询分配结果 (USER_DATA) › 请求参数
id客户端生成的请求标识符。
methodWebSocket API 方法名称。
symboltimestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
apiKey访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
startTime毫秒时间戳
endTime毫秒时间戳
fromAllocationId起始分配 ID
limit默认值: 500; 最大值: 1000
orderId订单 ID
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查询分配结果 (USER_DATA) › 响应
查询分配结果
idstatussymbolallocationIdallocationTypeorderIdorderListIdpriceqtyquoteQtycommissioncommissionAssettimeisBuyerisMakerisAllocatorrateLimitTypeintervalintervalNumlimitcount查询相关过滤器 (USER_DATA)
查询相关过滤器 (USER_DATA) › 授权
查询相关过滤器 (USER_DATA) › 请求参数
id客户端生成的请求标识符。
methodWebSocket API 方法名称。
symboltimestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
apiKey访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查询相关过滤器 (USER_DATA) › 响应
查询相关过滤器
idstatusDecision 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 |
账户的 Prevented Matches (USER_DATA) › 请求参数
id客户端生成的请求标识符。
methodWebSocket API 方法名称。
symboltimestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
apiKey访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
preventedMatchIdPrevented match ID
orderId订单 ID
fromPreventedMatchId起始 prevented match ID
limit默认值: 500; 最大值: 1000
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
账户的 Prevented Matches (USER_DATA) › 响应
账户的 Prevented Matches
idstatussymbolpreventedMatchIdtakerOrderIdmakerSymbolmakerOrderIdtradeGroupIdselfTradePreventionModepricemakerPreventedQuantitytransactTimerateLimitTypeintervalintervalNumlimitcount账户成交历史 (USER_DATA)
获取账户指定交易对的成交历史，按时间范围过滤。
账户成交历史 (USER_DATA) › 授权
账户成交历史 (USER_DATA) › 请求权重
此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。
请在限速说明章节中了解更多信息。
| Condition | Weight |
|---|---|
| Without orderId | 20 |
| With orderId | 5 |
账户成交历史 (USER_DATA) › 请求参数
id客户端生成的请求标识符。
methodWebSocket API 方法名称。
symboltimestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
apiKey访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
orderId必须要和参数symbol一起使用。
startTime毫秒时间戳
endTime毫秒时间戳
fromId起始交易 ID
limit默认值: 500; 最大值: 1000
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
账户成交历史 (USER_DATA) › 响应
账户成交历史
idstatussymbolidorderIdorderListIdpriceqtyquoteQtycommissioncommissionAssettimeisBuyerisMakerisBestMatchrateLimitTypeintervalintervalNumlimitcount查询订单列表挂单 (USER_DATA)
查询所有订单列表挂单的执行状态。
如果您需要持续监控订单状态更新，请考虑使用 WebSocket Streams：
- 如果会话已通过验证，请使用
userDataStream.subscribe - 如果通过签名订阅的方式订阅，请使用
userDataStream.subscribe.signature
查询订单列表挂单 (USER_DATA) › 授权
查询订单列表挂单 (USER_DATA) › 请求参数 可选
id客户端生成的请求标识符。
methodWebSocket API 方法名称。
timestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
apiKey访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查询订单列表挂单 (USER_DATA) › 响应
查询订单列表挂单
idstatusorderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolsymbolorderIdclientOrderIdrateLimitTypeintervalintervalNumlimitcount当前挂单 (USER_DATA)
查询所有挂订单的执行状态。
如果您需要持续监控订单状态更新，请考虑使用 WebSocket Streams：
- 如果会话已通过验证，请使用
userDataStream.subscribe - 如果通过签名订阅的方式订阅，请使用
userDataStream.subscribe.signature
当前挂单 (USER_DATA) › 授权
当前挂单 (USER_DATA) › 请求参数 可选
id客户端生成的请求标识符。
methodWebSocket API 方法名称。
timestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
apiKey访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
symbol如果省略，则返回所有交易对的挂单
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
当前挂单 (USER_DATA) › 响应
当前挂单
idstatussymbolorderIdorderListId仅当订单属于订单列表时返回。
clientOrderIdpriceorigQtyexecutedQtyorigQuoteOrderQty始终返回；若订单类型不使用 quoteOrderQty 则为 0。
cummulativeQuoteQtystatustimeInForcetypesidetime下单时间。
updateTime订单最后更新时间。
isWorkingworkingTimeselfTradePreventionModeicebergQty仅在请求中发送了 icebergQty 参数时出现。
preventedMatchId仅在因 STP 导致订单失效时出现。
preventedQuantity因 STP 导致订单失效的数量。
stopPrice出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
strategyId仅在下单时提供了 strategyId 参数时出现。
strategyType仅在下单时提供了 strategyType 参数时出现。
trailingDelta订单激活前所需的价格变动。
trailingTime追踪单被激活和跟踪价格变化的时间。
usedSor用于确定订单是否使用SOR的字段。
workingFloor用以定义订单是通过 SOR 还是由订单簿成交的。
pegPriceType挂钩价格类型。仅用于挂钩订单。
pegOffsetType挂钩价格偏移类型。如若需要，仅用于挂钩订单。
pegOffsetValue挂钩价格偏移值。如若需要，仅用于挂钩订单。
peggedPrice订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
expiryReason订单过期的原因。当订单过期时出现。
rateLimitTypeintervalintervalNumlimitcount查询改单 (USER_DATA)
查询对一个订单的所有改单操作。
查询改单 (USER_DATA) › 授权
查询改单 (USER_DATA) › 请求参数
id客户端生成的请求标识符。
methodWebSocket API 方法名称。
symbolorderId订单 ID
timestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
apiKey访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
fromExecutionId起始执行 ID
limit默认值: 500; 最大值: 1000
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查询改单 (USER_DATA) › 响应
查询改单
idstatussymbolorderIdexecutionIdorigClientOrderIdnewClientOrderIdorigQtynewQtytimerateLimitTypeintervalintervalNumlimitcount查询订单列表 (USER_DATA)
检查订单列表的执行状态。
对于单个订单的执行状态，使用 order.status。
查询订单列表 (USER_DATA) › 授权
查询订单列表 (USER_DATA) › 请求参数 可选
id客户端生成的请求标识符。
methodWebSocket API 方法名称。
timestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
apiKey访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
origClientOrderId通过 listClientOrderId 获取订单列表。必须提供 orderListId 或 origClientOrderId。
orderListId通过 orderListId 获取订单列表。必须提供 orderListId 或 origClientOrderId。
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查询订单列表 (USER_DATA) › 响应
查询订单列表
idstatusorderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolsymbolorderIdclientOrderIdrateLimitTypeintervalintervalNumlimitcount查询订单 (USER_DATA)
查询订单状态。
查询订单 (USER_DATA) › 授权
查询订单 (USER_DATA) › 请求参数
id客户端生成的请求标识符。
methodWebSocket API 方法名称。
symboltimestamp用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
apiKey访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
orderId按 orderId 查找订单
origClientOrderId按 clientOrderId 查找订单
recvWindow支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
查询订单 (USER_DATA) › 响应
查询订单
idstatussymbolorderIdorderListId仅当订单属于订单列表时返回。
clientOrderIdpriceorigQtyexecutedQtyorigQuoteOrderQty始终返回；若订单类型不使用 quoteOrderQty 则为 0。
cummulativeQuoteQtystatustimeInForcetypesidestopPrice始终返回；若订单类型不使用 stopPrice 则为 0。
trailingDelta仅当订单设置了 trailingDelta 时返回。
trailingTime仅当订单设置了 trailingDelta 时返回。
icebergQty始终返回；非冰山订单为 0。
time下单时间。
updateTime订单最后更新时间。
isWorkingworkingTimestrategyId仅当订单设置了 strategyId 时返回。
strategyType仅当订单设置了 strategyType 时返回。
selfTradePreventionModepreventedMatchId仅当订单因 STP 过期时返回。
preventedQuantity仅当订单因 STP 过期时返回。
usedSor用于确定订单是否使用SOR的字段。
workingFloor用以定义订单是通过 SOR 还是由订单簿成交的。
pegPriceType挂钩价格类型。仅用于挂钩订单。
pegOffsetType挂钩价格偏移类型。如若需要，仅用于挂钩订单。
pegOffsetValue挂钩价格偏移值。如若需要，仅用于挂钩订单。
peggedPrice订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
expiryReason订单过期的原因。当订单过期时出现。
rateLimitTypeintervalintervalNumlimitcount