Rate Limit

This chapter mainly divides the details of rate limit into the following two aspects:

  • REST API
  • WebSocket

When the requests exceed the rate limit, the 429 status will be returned: the request is too frequent.

REST API

If a valid API key is passed in, the user id will be used to limit the rate; if not, the public IP will be used to limit the rate.

Rate limit rules: There is a separate description on each interface. If there is not, the rate limit is 10 times per second in general.

Each call to the interface will return 3 Response Headers with limit tags, as shown below:

Response Header Description
X-BM-RateLimit-Remaining The number of requests left in the current time window
X-BM-RateLimit-Limit The max number of requests in the current time window
X-BM-RateLimit-Reset Current time window, in seconds
  • Example: Note that when X-BM-RateLimit-Remaining> X-BM-RateLimit-Limit, please do not continue to call, otherwise it will be banned
X-BM-RateLimit-Remaining: 10
X-BM-RateLimit-Limit: 600
X-BM-RateLimit-Reset: 60
The above setting means that it can be called 600 times within 60 seconds, and currently has been called 10 times

The specific interface limits are as follows:

System Interface Interface Name Limit Target Rate
/system/time Get system time IP 10 times/sec
/system/service Get system service status IP 10 times/sec
Funding Account Interface Interface Name Limit Target Rate Special Remarks
/account/v1/currencies Get currencies IP 5 times/sec
/account/v1/wallet Get account balance X-BM-KEY 5 times/sec
/account/v1/deposit/address Deposit address X-BM-KEY+currency 5 times/sec Rate ​​limit is not accumulated between different currency
/account/v1/withdraw/charge Withdraw quota X-BM-KEY+currency 5 times/sec Rate ​​limit is not accumulated between different currency
/account/v1/withdraw/apply Withdraw X-BM-KEY+currency 5 times/sec Rate ​​limit is not accumulated between different currency
/account/v1/recharge-withdraw/history Get deposit and withdraw history X-BM-KEY+currency 5 times/sec Rate ​​limit is not accumulated between different currency
/account/v1/recharge-withdraw/detail Get a deposit Or withdraw detail X-BM-KEY 50 times/sec
Contract Interface Interface Name Limit Target Rate Special Remarks
/contract/v1/tickers Get the latest market quotations of the contract IP 10 times/sec
Spot Interface Interface Name Limit Target Rate Special Remarks
/spot/v1/currencies Get a list of all cryptocurrencies IP 5 times/sec
/spot/v1/symbols Get a list of all trading pairs IP 5 times/sec
/spot/v1/symbols/details Get a detailed list of all trading pairs IP 5 times/sec
/spot/v1/ticker Get ticker IP+symbol 5 times/sec Rate ​​limit is not accumulated between different trading pairs
/spot/v1/steps Get K-Line steps IP 5 times/sec
/spot/v1/symbols/kline Get k-Line IP+symbol 5 times/sec Rate ​​limit is not accumulated between different trading pairs
/spot/v1/symbols/book Get orderbook IP+symbol 5 times/sec Rate ​​limit is not accumulated between different trading pairs
/spot/v1/symbols/trades Get the latest trades IP+symbol 5 times/second Rate ​​limit is not accumulated between different trading pairs
/spot/v1/wallet Get the user's wallet balance X-BM-KEY 10 times/sec
/spot/v1/submit_order Place order X-BM-KEY+symbol 50 times/sec Rate ​​limit is not accumulated between different trading pairs
/spot/v2/cancel_order Cancel order X-BM-KEY+symbol 50 times/sec Rate ​​limit is not accumulated between different trading pairs
/spot/v1/cancel_orders Cancel all orders in the specified direction of the specified trading pair X-BM-KEY+symbol 50 times/sec Rate ​​limit is not accumulated between different trading pairs
/spot/v1/order_detail Get order details X-BM-KEY+symbol 50 times/sec Rate ​​limit is not accumulated between different trading pairs
/spot/v1/orders Get user's recent orders X-BM-KEY+symbol 10 times/sec Rate ​​limit is not accumulated between different trading pairs
/spot/v1/trades User trade records X-BM-KEY+symbol 10 times/sec Rate ​​limit is not accumulated between different trading pairs

WebSocket

None.

results matching ""

    No results matching ""