Use this endpoint to get all open trade orders for a token symbol. Do not access this without a token symbol as this would return all pair data. Use this endpoint to get the total value of assets in the master account in USD. Use this endpoint to execute an asset transfer between the master account and a sub-account. If fromId, startTime, and endTime are not sent, the most recent aggregate trades will be returned.
Timestamp for this request was 1000ms ahead of the server’s time. An unexpected response was received from the message bus. An unknown error occurred while processing the request. HTTP 403 return code is used when the WAF Limit has been violated.
Withdrawal Rate Limits
The stream will close after 60 minutes unless a keepalive is sent. If the account has an active listenKey, that listenKey will be returned and its validity will be extended for 60 minutes. Use this endpoint to fetch the details of all crypto assets including fees, withdrawal limits, and network status. Rolling window ticker statistics for all market symbols, computed over multiple windows.
The /wapi/v3 rateLimits array contains objects related to the exchange’s REQUESTS and ORDER rate limits. Heavier endpoints and endpoints that do operations on multiple symbols will have a heavier weight. For POST, PUT, and DELETE endpoints, the parameters may be sent as aquery string or in the request body with content typeapplication/x–urlencoded.
Use this endpoint to get trade data for a specific account and token symbol. MARKET orders using quoteOrderQty will not break LOT_SIZE filter rules; the order will execute a quantity with a notional value as close as possible to quoteOrderQty. Use this endpoint to fetch account API trading status details. Use this endpoint to get the current average price for a symbol. Updated five wallet endpoints related to crypto withdrawals and deposits.
- A 429 will be returned when either rate limit is violated.
- Trades that fill at the same time, from the same order, with the same price, will have the quantity aggregated.
- HTTP 429 return code is used when breaking a request rate limit.
- Use this endpoint to request a quote for a from-to coin pair.
Base asset refers to the asset that is the quantity of a symbol; for the symbol BTCUSDT, BTC would be the base asset. Doing a DELETE on a listenKey will close the stream and invalidate the listenKey. Order book price and quantity depth updates are used to manage an order book locally. Use this endpoint to get the staking balance for an asset.
Quote asset refers to the asset that is the price of a symbol; for the symbol BTCUSDT, USDT would be the quote asset. Each endpoint has a data source indicating where the data is being retrieved, and thus which endpoints have the most up-to-date response. A single connection can listen to a maximum of 1024 streams.
- An order will be on the book unless the order is canceledIOC”Immediate or Cancel.”
- Quote asset refers to the asset that is the price of a symbol; for the symbol BTCUSDT, USDT would be the quote asset.
- It is important to NOT treat this as a failure operation; the execution status isUNKNOWN and could have been a success.
- Not all sent parameters were read; read ‘%s’ parameter but was sent ‘%s’.
Every successful order response will contain an X-MBX-ORDER-COUNT- header which has the current order count for the account for all order rate limiters defined. 24hr rolling window ticker statistics for all symbols that changed in an array. These are NOT the statistics of the UTC day, but a 24hr rolling window for the previous 24hrs. The MAX_ALGO_ORDERS filter defines the maximum number of “algo” orders an account is allowed to have open on the exchange. “Algo” orders are STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, and TAKE_PROFIT_LIMIT orders. The MAX_NUM_ORDERS filter defines the maximum number of orders an account is allowed to have open on the exchange.
BUY orders will be rejected if the account’s position is greater than the maximum position allowed. For MARKET orders, the average price https://cryptolisting.org/ used over the last avgPriceMins minutes will be used for calculation. If the avgPriceMins is 0, then the last price will be used.
Get Supported Coin Pairs
The ICEBERG_PARTS filter defines the maximum parts an iceberg order can have. The number of ICEBERG_PARTS is defined as CEIL(qty / icebergQty). ApplyToMarket determines whether or not the MIN_NOTIONAL filter will also be applied to MARKET orders. Since MARKET orders have no price, the average price is used over the last avgPriceMins minutes.avgPriceMins is the number of minutes the average price is calculated over. Use this endpoint to fetch sub-account deposit history. Use this endpoint to fetch your fiat withdrawal history.
- Balance Update occurs during deposits or withdrawals from the account.
- Order Rate LimitOCO counts as 2 orders against the order rate limit.
- Use this endpoint to get price change data for the past 24hrs.
- Use this endpoint to get compressed, aggregate trades.
- Too many requests; please use the WebSocket for live updates.
Note that only tickers that have changed will be present in the array. The EXCHANGE_MAX_NUM_ICEBERG_ORDERS filter defines the maximum number of iceberg orders an account is allowed to have open on the exchange. Use this endpoint to get compressed, aggregate trades. Trades that fill at the same time, from the same order, with the same price, will have the quantity aggregated.
User Data Endpoints
Order Rate LimitOCO counts as 2 orders against the order rate limit. Use this endpoint to cancels all active trade orders on a token symbol . Use this endpoint to get a status list of sub-accounts. Use this endpoint to get your current maker & taker fee rates for spot trading based on your VIP level or manual fee adjustment. Discount for using BNB to pay fees (25% off) is not factored in. Use this endpoint to get a snapshot of user’s assets in spot orders.
With recvWindow, you can specify that the request must be processed within a certain number of milliseconds or be rejected by the server. For GET endpoints, parameters must be sent as a query string. Balance Update occurs during deposits or withdrawals from the account. In the response, if the result received is null which means the request sent was a success for non-query requests (e.g., subscribing/unsubscribing). The NOTIONAL filter defines the acceptable notional range allowed for an order on a symbol. The PERCENT_PRICE_BY_SIDE filter defines the valid range for the price based on the last price of the symbol.
Use this endpoint to get Kline/candlestick bars for a token symbol. Pushes any update to the best bid or ask price or quantity in real-time for all symbols. 24hr rolling window ticker statistics for a single symbol. Currently, the only property that can be set is whether combined stream payloads are enabled or not. The combined property is set to false when connecting using /ws/ (“raw streams”) and true when connecting using /stream/.
The range is different depending on whether the order is placed on the BUY side or the SELL side. Filters define trading rules for a symbol or an exchange. How is materiality determined Use this endpoint to get the staking rewards history for an asset within a given time range. Use this endpoint to fetch a sub-account’s deposit address.
Use this endpoint to get your dust assets that can be converted to BNB. Use this endpoint to query OTC trade orders by condition. Use this endpoint to request a quote for a from-to coin pair. Use this endpoint to retrieve a specific OCO order based on provided optional parameters. Any order with an icebergQty MUST have timeInForce set to GTC.
Get the current trade order count rate limits for all time intervals. Each route has a weight that determines the number of requests each endpoint counts for. Heavier endpoints and endpoints that operate on multiple symbols will have a heavier weight. Every request will contain an X-MBX-USED-WEIGHT- header which has the currently used weight for the IP of all request rate limiters defined.
//These are the defined filters in the `Filters` section. Use this endpoint to fetch whether the system status is normal or under maintenance. The limits on the API are based on the IPs, not the API keys. Not all sent parameters were read; read ‘%s’ parameter but was sent ‘%s’.
Use this endpoint to get the current exchange trading rules and trading pair information. Added new OTC trade endpoints which support larger buy and sell order quotes, placements, and queries, as well as crypto-to-crypto conversion (e.g. KSHIB/SHIB). HTTP 5XX return codes are used for internal errors; the issue is on Binance’s side.
Use this endpoint to query asset distribution records, including staking, referrals, and airdrops, etc. The weight for this request will cap at 100 once the number of symbols in the request is more than 50. Use this endpoint to get price change data for the past 24hrs.
Too many requests; please use the WebSocket for live updates. A SIGNED endpoint also requires a parameter and timestamp to be sent, which should be the millisecond timestamp of when the request was created and sent. API-keys can be configured to only access certain types of secure endpoints. For example, one API-key could be used for TRADE only, while another API-key can access everything except for TRADE routes. The Kline/Candlestick Stream pushes updates to the current klines/candlestick every second. The WebSocket server will send a ping frame every 3 minutes.
The /api/v3/exchangeInfo rateLimits array contains objects related to the exchange’s RAW_REQUEST, REQUEST_WEIGHT, and ORDER rate limits. These are further defined in the ENUM definitions section under Rate limiters . It’s recommended to send a ping about every 30 minutes. Use this endpoint to fetch sub-account asset transfer history.