Rate Limit

IP Rate Limit

caution

If you receive an HTTP 403 (Access Denied) response, your IP has been either temporarily or permanently banned. You should immediately review the below guidelines to ensure your application does not continue to violate the limit. If you are still banned after 30 minutes, you likely have a permanent ban.

We do not recommend running your application at the very edge of these limits in case abnormal network activity results in an unexpected violation.

GET/POST method (shared):
- 120 requests per second for 5 consecutive seconds

note

All traffic to openapi.zoomex.com share this limit.

After violating the limit your IP will be banned for a set period of time (usually 30 minutes). Continually violating the limit will result in a permanent ban. We cannot undo permanent bans or shorten temporary bans.

API Rate Limit

caution

If you receive "ret_msg": "Too many visits!" in the JSON response, you have hit the API rate limit.

The API rate limit is based on the rolling time window per second and UID. In other words, it is per second per UID. Every request to the API returns response header shown in the code panel:

X-Bapi-Limit-Status - your remaining requests for current endpoint
X-Bapi-Limit - your current limit for current endpoint
X-Bapi-Limit-Reset-Timestamp - the timestamp indicating when your request limit resets if you have exceeded your rate_limit. Otherwise, this is just the current timestamp (it may not exactly match timeNow).

Http Response Header Example

▶Response Headers
Content-Type: application/json; charset=utf-8
Content-Length: 141
X-Bapi-Limit: 100
X-Bapi-Limit-Status: 99
X-Bapi-Limit-Reset-Timestamp: 1672738134824

API Rate Limit Table

Trade

Method	Path	linear	inverse	upgradable
POST	/cloud/trade/v3/order/create	10 req/s	10 req/s	Y
	/cloud/trade/v3/order/amend	10 req/s	10 req/s	Y
	/cloud/trade/v3/order/cancel	10 req/s	10 req/s	Y
	/cloud/trade/v3/order/cancel-all	10 req/s	10 req/s	N
	/cloud/trade/v3/order/create-batch	-	-	Y
	/cloud/trade/v3/order/amend-batch	-	-	Y
	/cloud/trade/v3/order/cancel-batch	-	-	Y
GET	/cloud/trade/v3/order/realtime	10 req/s	10 req/s	N
GET	/cloud/trade/v3/order/history	10 req/s	10 req/s	N

Position

Method	Path	linear/inverse	upgradable
GET	/cloud/trade/v3/position/list	10 req/s	N
	/cloud/trade/v3/execution/list	10 req/s	N
	/cloud/trade/v3/position/closed-pnl	10 req/s	N
POST	/cloud/trade/v3/position/set-leverage	10 req/s	N
	/cloud/trade/v3/position/set-tpsl-mode	10 req/s	N
	/cloud/trade/v3/position/set-risk-limit	10 req/s	N
	/cloud/trade/v3/position/trading-stop	10 req/s	N

Account

Method	Path	Limit	upgradable
GET	/cloud/trade/v3/account/wallet-balance	10 req/s	N
GET	/cloud/trade/v3/account/fee-rate	10 req/s	N

API Rate Limit Rules For VIPs/PROs

info

The values in the table represent the application upper limit of the corresponding level, and do not mean that users at this level will automatically enjoy the corresponding API Rate Limit by default.

instructions for batch endpoints

API for batch create/amend/cancel order, the frequency of the API will be consistent with the current configuration, but the counting consumption will be consumed according to the actual number of orders. (Number of consumption = number of requests * number of orders included in a single request), and the configuration of business lines is independent of each other.
The batch APIs allows 1-20 orders/request. For example, if a batch order request is made once and contains 10 orders, then the request limit will consume 10.
If part of the last batch of orders requested within 1s exceeds the limit, the part that exceeds the limit will fail, and the part that does not exceed the limit will succeed. For example, in the 1 second, the limit is 10, but a batch request containing 15 orders is placed at this time, then the first 10 orders will be successfully placed, and the 11-15th orders will report an error exceeding the limit, and these orders will fail.

	Normal account & UTA	UTA Pro
Level\Product	Futures	Futures
Default	10/s	10/s
VIP 1	20/s	20/s
VIP 2	40/s	40/s
VIP 3 - Supreme VIP	60/s	60/s
PRO1	100/s	150/s
PRO2	150/s	200/s
PRO3	200/s	250/s

How to increase API Limit

Please contact your client manager or email to support@zoomex.com with the following information. We will reply within 1-4 working days:

Your name and your company details
Your Zoomex UID or registered email, and the assets you are trading
General description of your trading strategy and reasons for higher rate limits
Screenshot of previous monthly trading volume (maker/taker) on other platforms
Optional: your order history in CSV format

IP Rate Limit​

API Rate Limit​

API Rate Limit Table​

Trade​

Position​

Account​

API Rate Limit Rules For VIPs/PROs​

How to increase API Limit​