跳转到主要内容
公有接口按照IP来限速,私有接口按照API KEY来限速。当访问超过频率限制时,将返回429状态:请求太频繁。

具体接口限制详细如下

公开行情接口接口名称限制目标速率
/contract/public/details获取所有合约详情IP12次/2s
/contract/public/depth获取深度IP12次/2s
/contract/public/open-interest查询合约持仓量IP2次/2s
/contract/public/funding-rate查询当前资金费率IP12次/2s
/contract/public/funding-rate-history查询资金费率历史IP12次/2s
/contract/public/kline查询K线数据IP12次/2s
/contract/public/markprice-kline查询标记价格K线数据IP12次/2s
/contract/public/leverage-bracket查询当前风险梯度IP12次/2s
/contract/public/market-trade查询成交数据IP12次/2s
交易接口接口名称限制目标速率
/contract/private/submit-order合约下单X-API-KEY24次/2s
/contract/private/cancel-order取消单个合约订单X-API-KEY40次/2s
/contract/private/cancel-orders批量撤销合约订单X-API-KEY2次/2s
/contract/private/cancel-all-after限时撤销所有合约普通订单设置X-API-KEY4次/2s
/contract/private/get-open-orders查询合约委托订单记录X-API-KEY50次/2s
/contract/private/order查询合约订单详情X-API-KEY50次/2s
/contract/private/order-history查询合约历史订单X-API-KEY6次/2s
/contract/private/submit-plan-order合约计划委托下单X-API-KEY24次/2s
/contract/private/cancel-plan-order取消计划委托合约订单X-API-KEY40次/2s
/contract/private/modify-plan-order合约修改计划委托单X-API-KEY24次/2s
/contract/private/current-plan-order查询合约计划委托订单记录X-API-KEY50次/2s
/contract/private/submit-tp-sl-order合约止盈止损下单X-API-KEY24次/2s
/contract/private/modify-tp-sl-order合约修改止盈止损订单X-API-KEY24次/2s
/contract/private/submit-trail-order合约跟踪委托下单X-API-KEY24次/2s
/contract/private/cancel-trail-order取消跟踪委托合约订单X-API-KEY24次/2s
/contract/private/modify-limit-order合约修改限价委托单X-API-KEY24次/2s
/contract/private/trades查询合约成交明细X-API-KEY6次/2s
/contract/private/transaction-history查询合约资金流水X-API-KEY6次/2s
/contract/private/trade-fee-rate查询用户交易费率X-API-KEY2次/2s
/contract/private/position查询仓位详情X-API-KEY6次/2s
/contract/private/position-v2查询仓位详情V2X-API-KEY6次/2s
/contract/private/position-risk查询仓位风险信息X-API-KEY24次/2s
/contract/private/get-position-mode查询仓位模式X-API-KEY2次/2s
/contract/private/set-position-mode设置仓位模式X-API-KEY2次/2s
/contract/private/submit-leverage合约杠杆调整X-API-KEY24次/2s
/contract/private/assets-detail查询合约资产明细X-API-KEY12次/2s
/account/v1/transfer-contract划转X-API-KEY1次/2s
/account/v1/transfer-contract-list查询划转列表X-API-KEY1次/2s

REST API

限速判断: 每次调用接口都会返回带有限制标记的 3 个 Response Header,如下所示:
Example:
X-API-RateLimit-Remaining: 10
X-API-RateLimit-Limit: 600
X-API-RateLimit-Reset: 60
上面的设置,意思是 60 秒内可调用 600 次,当前已调用 10 次
Response Header说明
X-API-RateLimit-Remaining当前时间窗口内已使用的次数
X-API-RateLimit-Limit当前时间窗口内最大可调用次数
X-API-RateLimit-Reset当前时间窗口,秒为单位
注意当 X-API-RateLimit-Remaining > X-API-RateLimit-Limit 时请不要继续调用,否则会有误封。