bybit API智能炒币编程机器人开发入门配置教程 一

注：统一账户支持反向交易。但是，使用的保证金来自反向衍生品钱包，而不是统一钱包。

主要提升能力：

业务线整合

之前存在Spot V1/V3 ，Futures V2 正向永续/反向永续/反向交割产品各自一套API，USDC 期权API V1，每套API 仅覆盖部分业务场景。 V5 版本将交易产品的API 合并成一套API，实现一套API 可以交易现货/期货/期权的业务能力，通过不同的下单参数进行交易区分，无论订单管理，查询钱包数据等， 采用同一个API都是相同格式的请求和返回结果。不需要切换多套接口来构建不同业务模型。

并且在V5 中对全局字典做了唯一的定义，避免不同业务线对统一业务场景采用不同命名，或者同一命名有不同含义的问题。减少客户对接时的困扰。

举例说明：下单时统一使用POST V5/order/create，在body 中输入具体的请求业务类型（通过category=spot/linear/option来区分），即可进行多个业务线的下单操作。

升级成本低

API V5 在之前V3 的标准基础上升级，如果您已经接入Contract V3 或者Unified V3，升级到V5 之后，仅需要调整至V5 的URL，并且少量接口字段做调整即可。 具体接口的对比，可以参照下方的接口映射列表。

提升资金利用率

原有的API 不同版本对应不同的账号，每个业务线都有一个账号，不同账号直接要通过划转调拨资金来管理。 V5 中，提供了账户升级成统一账户能力，使得账户内的资金可以共享，交易者可以获得更高的资金利用率。对应现货/ USDT 永续/ USDC永续/期权共用一个账户资金，同时不同业务线的盈亏可以互相抵消，进一步提高资金的利用效率。

支持统一账户借贷：

API V5 对统一账户模式的支持，新增借贷能力。客户可以使用多个资产作为抵押品作为保证金来交易全业务线。 举例：只存入BTC 资产，进行以USDT 结算的BTCUSDT 合约交易，如果产生浮动盈亏会通过借贷方式记录负债，产生的负债会每个小时收取利息。

Paradigm大宗交易

统一账户现在支持通过Paradigm 进行大宗交易。用户可以跨不同产品使用资金

支持组合保证金

统一账户下支持USDT永续, USDC永续, USDC交割和期权的组合保证金模式。

接口命名规范

V5 版本的API 接口路径定义更明确，从实际场景出发，分为市场数据，订单管理，持仓管理，账户管理，资产管理等模块，通过更清晰的路径定义来减少业务歧义。

{host}/{version}/{product}/{module}
举例：api.bybit.com/v5/market/recent-trade

API Rate Limit 规则调整

API V5 的限频规则调整为按照业务线分配User ID 每秒限频额度，限频规则调整:

• V2 限频规则：“User ID + Symbol + API End Point” 通过固定的每分钟计数限制API 请求频率

• V3 限频规则：“User ID + API End Point” 通过固定的每秒钟计数限制 API 请求频率

• V5 限频规则：“User ID + API End Point” 通过固定的每秒钟计数限制 API 请求频率
  

举例说明:

• V2 期货限频模式,

• 用户设置的下单频率为BTCUSDT 400/m，ETHUSDT 200/m，其他symbol 100/m

• 下单BTCUSDT 200个订单请求，则在该1 分钟内剩余额度为200次BTCUSDT 的订单请求。 ETHUSDT 在该1 分钟内剩余额度为200/m， 其他symbol 为100/m

• 同时又发送100 个ETHUSDT 订单请求，则在该1 分钟内剩余额度为200次BTCUSDT 的订单请求。 ETHUSDT 在该1 分钟内剩余额度为100次， 其他symbol 为100/m

• V3/V5 限频模式,

• 默认所有客户的基础限频规则是10/s

• 举例：下单频率提高到100/s （代表对于单个UID 来说所有的下单类型的接口峰值就是100 次请求）

• 下单BTCUSDT 在该1s 内使用了50 次，则其他所有的symbol 所有的订单类型的接口在该1s 内还可以操作订单50次

• 下一秒的限频会重置到100/s