Query Commission Rates
Get current account commission rates.
Query Commission Rates › Authorization
Query Commission Rates › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
symboltimestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
Query Commission Rates › Responses
Query Commission Rates
symbolCommission rates on trades from the order.
Special commission rates from the order.
Tax commission rates for trades from the order.
Discount commission when paying in BNB
Query all Order lists
Retrieves all order lists based on provided optional parameters.
Note that the time between startTime and endTime can't be longer
than 24 hours.
Query all Order lists › Authorization
Query all Order lists › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
fromIdIf supplied, neither startTime or endTime can be provided
startTimeendTimelimitrecvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Query all Order lists › Responses
Query all Order lists
orderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolAll orders
Get all account orders; active, canceled, or filled.
All orders › Authorization
All orders › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
symboltimestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
orderIdstartTimeendTimelimitrecvWindowThe value cannot be greater than 60000.
Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
All orders › Responses
All orders
symbolorderIdorderListIdUnless it's part of an order list, value will be -1
clientOrderIdpriceorigQtyexecutedQtycummulativeQuoteQtystatustimeInForcetypesidestopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
icebergQtyAppears only if the parameter icebergQty was sent in the request.
timeupdateTimeisWorkingorigQuoteOrderQtyworkingTimeselfTradePreventionModepreventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
Account information
Get current account information.
Account information › Authorization
Account information › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
omitZeroBalancesWhen set to true, emits only the non-zero balances of an account.
recvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Account information › Responses
Account information
makerCommissiontakerCommissionbuyerCommissionsellerCommissioncanTradecanWithdrawcanDepositbrokeredrequireSelfTradePreventionpreventSorupdateTimeaccountTypepermissionsuidCurrent open orders
Get all open orders on a symbol. Careful when accessing this with no symbol.
Current open orders › Authorization
Current open orders › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
6 for a single symbol; 80 when the symbol parameter is omitted
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
symbolrecvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Current open orders › Responses
Current open orders
symbolorderIdorderListIdUnless it's part of an order list, value will be -1
clientOrderIdpriceorigQtyexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesidestopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
icebergQtyAppears only if the parameter icebergQty was sent in the request.
timeupdateTimeisWorkingworkingTimeselfTradePreventionModepreventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
Query order
Check an order's status.
Query order › Authorization
Query order › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
symboltimestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
orderIdorigClientOrderIdrecvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Query order › Responses
Query order
symbolsymbol.
orderIdorder Id.
orderListIdThis field will always have a value of -1 if not an order list.
clientOrderIdclient Order Id.
priceprice.
origQtyorig Qty.
executedQtyexecuted Qty.
origQuoteOrderQtyorig Quote Order Qty.
cummulativeQuoteQtycummulative Quote Qty.
statusstatus.
timeInForcetime In Force.
typetype.
sideside.
stopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
icebergQtyAppears only if the parameter icebergQty was sent in the request.
timetime.
updateTimeupdate Time.
isWorkingis Working.
workingTimeworking Time.
selfTradePreventionModeself Trade Prevention Mode.
preventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
Query Order list
Retrieves a specific order list based on provided optional parameters.
Query Order list › Authorization
Query Order list › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
orderListIdQuery order list by orderListId. orderListId or origClientOrderId must be provided.
origClientOrderIdQuery order list by listClientOrderId. orderListId or origClientOrderId must be provided.
recvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Query Order list › Responses
Query Order list
orderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolQuery Allocations
Retrieves allocations resulting from SOR order placement.
Query Allocations › Authorization
Query Allocations › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
symboltimestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
startTimeendTimefromAllocationIdlimitorderIdrecvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Query Allocations › Responses
Query Allocations
symbolallocationIdallocationTypeorderIdorderListIdpriceqtyquoteQtycommissioncommissionAssettimeisBuyerisMakerisAllocatorQuery relevant filters
Retrieves the list of filters relevant to an account on a given symbol. This is the only endpoint that shows if an account has MAX_ASSET filters applied to it.
Query relevant filters › Authorization
Query relevant filters › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
symboltimestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
recvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Query relevant filters › Responses
Query relevant filters
Query Prevented Matches
Displays the list of orders that were expired due to STP.
These are the combinations supported:
symbol+preventedMatchIdsymbol+orderIdsymbol+orderId+fromPreventedMatchId(limitwill default to 500)symbol+orderId+fromPreventedMatchId+limit
Query Prevented Matches › Authorization
Query Prevented Matches › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
| Case | Weight |
|---|---|
If symbol is invalid | 2 |
Querying by preventedMatchId | 2 |
Querying by orderId | 20 |
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
symboltimestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
preventedMatchIdorderIdfromPreventedMatchIdlimitrecvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Query Prevented Matches › Responses
Query Prevented Matches
symbolpreventedMatchIdtakerOrderIdmakerSymbolmakerOrderIdtradeGroupIdselfTradePreventionModepricemakerPreventedQuantitytransactTimeAccount trade list
Get trades for a specific account and symbol.
Account trade list › Authorization
Account trade list › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
| Condition | Weight |
|---|---|
| Without orderId | 20 |
| With orderId | 5 |
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
symboltimestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
orderIdThis can only be used in combination with symbol.
startTimeendTimefromIdTradeId to fetch from. Default gets most recent trades.
limitrecvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Account trade list › Responses
Account trade list
symbolidorderIdorderListIdpriceqtyquoteQtycommissioncommissionAssettimeisBuyerisMakerisBestMatchQuery Open Order lists
Query Open Order lists
Query Open Order lists › Authorization
Query Open Order lists › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
recvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Query Open Order lists › Responses
Query Open Order lists
orderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolQuery Order Amendments
Queries all amendments of a single order.
Query Order Amendments › Authorization
Query Order Amendments › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
symbolorderIdtimestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
fromExecutionIdlimitrecvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Query Order Amendments › Responses
Query Order Amendments
symbolorderIdexecutionIdorigClientOrderIdnewClientOrderIdorigQtynewQtytimeQuery Unfilled Order Count
Displays the user's unfilled order count for all intervals.
Query Unfilled Order Count › Authorization
Query Unfilled Order Count › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
recvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Query Unfilled Order Count › Responses
Query Unfilled Order Count
rateLimitTypeintervalintervalNumlimitcount