Institutional Rate Limit
Unified Account — Institutional Rate Limit Quota
Get RateLimit Quota
Query the rate limit quota configuration for accounts. Supports querying the quota allocation for a single account or listing all sub-account quotas under a master account.
This endpoint also supports being called directly by a sub-account using its own API Key, to query its own rate limit quota.
Note: This endpoint is only available to MM (Market Maker) and PRO institutional users.
-
Rate limit: 10/sec/UID
-
Permission: UTA mgt. (read)
Request Parameters
categoryProduct type
spot Spot
futures Futures
uidAccount UID
Used to query a single account's rate limit quota; omit to list all sub-accounts
When called by a sub-account itself, this field is not required and is ignored — the sub-account's own quota is returned
cursorCursor
Used for pagination in subsequent queries
limitLimit per page
Default: 100. Maximum: 100
Get RateLimit Quota › Response Parameters
Successful response
codemsgrequestTimecategoryProduct type
spot Spot
futures Futures
Sub-account rate limit quota list
uidAccount UID
quotaThe actual configured single account rate limit value
masterSubQuotaThe actual configured master-sub account rate limit value
masterSubCapMaster-sub account rate limit Cap
cursorCursor
Used for pagination in subsequent queries
Set RateLimit Quota
-
Set rate limit quotas for sub-accounts. This endpoint allows master accounts to allocate rate limit quotas for spot and futures trading at the sub-account level.
-
Supports single or batch quota allocation for multiple sub-accounts by business line.
-
The single account rate limit Quota must not exceed the single account rate limit Cap.
-
The sum of all sub-account rate limit Quotas (i.e., the Master-Sub Quota) must not exceed the Master-Sub total rate limit Cap.
-
If adjusting a sub-account's Quota causes the total Master-Sub Quota to exceed the Master-Sub Cap, the API call will be rejected.
-
This endpoint also supports being called directly by a sub-account using its own API Key, to set its own rate limit quota. The rules are the same as when called by the master account.
Note: This endpoint is only available to MM (Market Maker) and PRO institutional users.
-
Rate limit: 5/sec/UID
-
Permission: UTA mgt. (read & write)
Set RateLimit Quota › Request Parameters
categoryProduct type
spot Spot
futures Futures
uidsSub-account UIDs
Up to 50 UIDs per request
Required when called by the master account; when called by a sub-account itself, this field is not required and is ignored
quotaRate limit quota
Must not exceed the single account rate limit Cap
Set RateLimit Quota › Response Parameters
Successful response
codemsgrequestTimedataResponse data