Skip to main content
The speed of the public interface is limited according to the IP, and the speed of the private interface is limited according to the API KEY. When the requests exceed the rate limit, the 429 status will be returned: the request is too frequent.

​
Endpoints Limit Rules

Futures Market EndpointsEndpoint NameLimit TargetRate
/contract/public/detailsGet Contract DetailsIP12 times/2 sec
/contract/public/depthGet Market DepthIP12 times/2 sec
/contract/public/open-interestGet Futures OpeninterestIP2 times/2 sec
/contract/public/funding-rateGet Current Funding RateIP12 times/2 sec
/contract/public/funding-rate-historyGet Funding Rate HistoryIP12 times/2 sec
/contract/public/klineGet K-lineIP12 times/2 sec
/contract/public/markprice-klineGet MarkPrice K-lineIP12 times/2 sec
/contract/public/leverage-bracketGet Current Leverage Risk LimitIP12 times/2 sec
/contract/public/market-tradeGet Market TradeIP12 times/2 sec
Futures Trade EndpointsEndpoint NameLimit TargetRate
/contract/private/submit-orderSubmit OrderX-API-KEY24 times/2 sec
/contract/private/cancel-orderCancel OrderX-API-KEY40 times/2 sec
/contract/private/cancel-ordersCancel All OrdersX-API-KEY2 times/2 sec
/contract/private/cancel-all-afterTimed Cancel All OrdersX-API-KEY4 times/2 sec
/contract/private/get-open-ordersGet All Open OrdersX-API-KEY50 times/2 sec
/contract/private/orderGet Order DetailX-API-KEY50 times/2 sec
/contract/private/order-historyGet Order HistoryX-API-KEY6 times/2 sec
/contract/private/submit-plan-orderSubmit Plan OrderX-API-KEY24 times/2 sec
/contract/private/cancel-plan-orderCancel Plan OrderX-API-KEY40 times/2 sec
/contract/private/modify-plan-orderModify Plan OrderX-API-KEY24 times/2 sec
/contract/private/current-plan-orderGet All Current Plan OrdersX-API-KEY50 times/2 sec
/contract/private/submit-tp-sl-orderSubmit TP/SL OrderX-API-KEY24 times/2 sec
/contract/private/modify-tp-sl-orderModify TP/SL OrderX-API-KEY24 times/2 sec
/contract/private/submit-trail-orderSubmit Trail OrderX-API-KEY24 times/2 sec
/contract/private/cancel-trail-orderCancel Trail OrderX-API-KEY24 times/2 sec
/contract/private/modify-limit-orderModify Limit OrderX-API-KEY24 times/2 sec
/contract/private/tradesGet Order TradeX-API-KEY6 times/2 sec
/contract/private/transaction-historyGet Transaction HistoryX-API-KEY6 times/2 sec
/contract/private/trade-fee-rateGet Trade Fee RateX-API-KEY2 times/2 sec
/contract/private/positionGet Current PositionX-API-KEY6 times/2 sec
/contract/private/position-v2Get Current Position V2X-API-KEY6 times/2 sec
/contract/private/position-riskGet Current Position Risk DetailsX-API-KEY24 times/2 sec
/contract/private/get-position-modeGet Position ModeX-API-KEY2 times/2 sec
/contract/private/set-position-modeSet Position ModeX-API-KEY2 times/2 sec
/contract/private/submit-leverageSubmit LeverageX-API-KEY24 times/2 sec
/contract/private/assets-detailGet Contract AssetsX-API-KEY12 times/2 sec
/account/v1/transfer-contractTransferX-API-KEY1 times/2 sec
/account/v1/transfer-contract-listGet Transfer ListX-API-KEY1 times/2 sec

​
REST API

Speed limit judgment: Each call to the interface will return 3 Response Headers with limit tags, as shown below:
Example: 
X-API-RateLimit-Remaining: 10
X-API-RateLimit-Limit: 600
X-API-RateLimit-Reset: 60
The above setting means that it can be called 600 times within 60 seconds, and currently has been called 10 times
Response HeaderDescription
X-API-RateLimit-RemainingThe number of requests that have been used in the current time window
X-API-RateLimit-LimitThe max number of requests in the current time window
X-API-RateLimit-ResetCurrent time window, in seconds
Note that when X-API-RateLimit-Remaining > X-API-RateLimit-Limit, please do not continue to call, otherwise it will be banned.