访问限制
本章节主要为访问限制的细节分以下两个方面：
- 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
暂无。