访问限制

本章节主要为访问限制的细节分以下两个方面:

  • REST API
  • WebSocket

当访问超过频率限制时,将返回429状态:请求太频繁。

REST API

如果传入有效的API key 用user id限速;如果没有则拿公网IP限速。

限速规则:各个接口上有单独的说明,如果没有一般接口限速为 10次/秒。

每次调用接口都会返回带有限制标记的 3 个 Response Header,如下所示:

Response Header 说明
X-BM-RateLimit-Remaining 当前时间窗口内使用的次数
X-BM-RateLimit-Limit 当前时间窗口内最大可调用次数
X-BM-RateLimit-Reset 当前时间窗口,秒为单位
  • 例子: 注意当X-BM-RateLimit-Remaining > X-BM-RateLimit-Limit时请不要继续调用,否则会有误封的
X-BM-RateLimit-Remaining: 10
X-BM-RateLimit-Limit: 600
X-BM-RateLimit-Reset: 60
上面的设置,意思是 60 秒内可调用 600 次,当前已调用 10

具体接口限制详细如下:

系统接口 接口名称 限制目标 速率
/system/time 获取系统时间 IP 10次/秒
/system/service 获取系统服务状态 IP 10次/秒
资金账户接口 接口名称 限制目标 速率 特别备注
/account/v1/currencies 获取资产币种 IP 5次/秒
/account/v1/wallet 查询账户资产 X-BM-KEY 5次/秒
/account/v1/deposit/address 查询充币地址 X-BM-KEY+currency 5次/秒 不同币种请求限速不累计
/account/v1/withdraw/charge 查询提币额度 X-BM-KEY+currency 5次/秒 不同币种请求限速不累计
/account/v1/withdraw/apply 提币 X-BM-KEY+currency 5次/秒 不同币种请求提现限速不累计
/account/v1/recharge-withdraw/history 查询充提历史记录 X-BM-KEY+currency 5次/秒 不同币种请求提现限速不累计
/account/v1/recharge-withdraw/detail 查询单个充提记录 X-BM-KEY 50次/秒
合约接口 接口名称 限制目标 速率 特别备注
/contract/v1/ifcontract/contracts 获取合约列表 IP 5次/秒
/contract/v1/ifcontract/indexes 查询所有合约的指数价格 IP 5次/秒
/contract/v1/ifcontract/pnls 查询自动减仓排序表 IP 5次/秒
/contract/v1/ifcontract/depth 获取合约深度 IP 5次/秒
/contract/v1/ifcontract/fundingrate 获取资金费率 IP 5次/秒
/contract/v1/ifcontract/indexquote 获取指数价格 K 线 IP 10次/秒
/contract/v1/ifcontract/quote 获取K线数据 IP 10次/秒
/contract/v1/ifcontract/tickers 获取合约最新行情 IP 10次/秒
/contract/v1/ifcontract/trades 获取历史合约成交记录 IP 10次/秒
/contract/v1/ifcontract/accounts 查询用户账户信息 X-BM-KEY 5次/秒
/contract/v1/ifcontract/batchOrders 批量下单 X-BM-KEY 5次/秒
/contract/v1/ifcontract/cancelOrders 取消订单 X-BM-KEY 5次/秒
/contract/v1/ifcontract/marginOper 调整保证金 X-BM-KEY 5次/秒
/contract/v1/ifcontract/orderTrades 订单的交易记录 X-BM-KEY 5次/秒
/contract/v1/ifcontract/positionFee 查询仓位费用 X-BM-KEY 5次/秒
/contract/v1/ifcontract/submitOrder 提交订单 X-BM-KEY 5次/秒
/contract/v1/ifcontract/userLiqRecords 查询爆仓记录 X-BM-KEY 5次/秒
/contract/v1/ifcontract/userOrderInfo 查询订单详情 X-BM-KEY 5次/秒
/contract/v1/ifcontract/userOrders 查询订单记录 X-BM-KEY 5次/秒
/contract/v1/ifcontract/userPositions 查询用户仓位 X-BM-KEY 5次/秒
/contract/v1/ifcontract/userTrades 查询交易记录 X-BM-KEY 5次/秒
现货接口 接口名称 限制目标 速率 特别备注
/spot/v1/currencies 获取平台所有的加密货币列表 IP 5次/秒
/spot/v1/symbols 获取平台所有的交易对列表 IP 5次/秒
/spot/v1/symbols/details 获取平台所有交易对的详情列表 IP 5次/秒
/spot/v1/ticker Ticker 是交易对市场状态的概览,包含最新成交价、买一价、卖一价和 24 小时交易量的快照信息 IP+symbol 5次/秒 不同交易对之间限速不累计
/spot/v1/steps 获取平台支持的全部 k 线周期,用分钟表示,最小 1 分钟。 IP 5次/秒
/spot/v1/symbols/kline 获取指定交易对的指定时间范围内的 k 线数据。 IP+symbol 5次/秒 不同交易对之间限速不累计
/spot/v1/symbols/book 获取交易对完整的深度。 IP+symbol 5次/秒 不同交易对之间限速不累计
/spot/v1/symbols/trades 获取指定交易对的最近成交记录 IP+symbol 5次/秒 不同交易对之间限速不累计
/spot/v1/wallet 获取用户所有币种钱包余额 X-BM-KEY 10次/秒
/spot/v1/submit_order 委托下单 X-BM-KEY+symbol 50次/秒 不同交易对之间限速不累计
/spot/v2/cancel_order 取消一个未完成的订单 X-BM-KEY+symbol 50次/秒 不同交易对之间限速不累计
/spot/v1/cancel_orders 取消指定交易对指定方向的所有未完成的订单 X-BM-KEY+symbol 50次/秒 不同交易对之间限速不累计
/spot/v1/order_detail 获取订单详情 X-BM-KEY+symbol 50次/秒 不同交易对之间限速不累计
/spot/v1/orders 查询用户最近订单 X-BM-KEY+symbol 10次/秒 不同交易对之间限速不累计
/spot/v1/trades 用户成交记录 X-BM-KEY+symbol 10次/秒 不同交易对之间限速不累计

WebSocket

暂无。

results matching ""

    No results matching ""