Bybit API教程：如何连接并开始自动交易？

了解Bybit API认证

1. Bybit 需要从用户帐户仪表板的 API 管理部分下生成 API 密钥。这些密钥由 API 密钥和秘密密钥组成，两者对于签署请求都至关重要。

2. 密钥绝不能暴露在客户端代码或公共存储库中。用于为每个请求生成HMAC-SHA256签名，以验证身份并防止篡改。

3. 用户必须在密钥创建过程中分配精确的权限，例如“订单”、“钱包”或“合同”访问权限，并在生产环境中操作时限制 IP 地址。

4. 时间同步是强制性的。请求被拒绝并出现错误代码 10004 表示时间戳不匹配；系统必须将相对于 Bybit 服务器时间的时钟漂移保持在 30 秒以内。

5. 所有端点都需要包含公钥的 X-BAPI-API-KEY 标头和包含从串联参数和秘密派生的 Base64 编码签名的 X-BAPI-SIGN 标头。

设置 REST API 集成

1. 开发人员通常使用 Python 和requests库来构建经过身份验证的 GET/POST 调用。一个典型的示例包括通过 /v5/account/wallet-balance 端点获取钱包余额。

2. 构建签名字符串时，查询参数必须先按字母顺序排序，然后再进行哈希处理。 Nonce 值必须在连续请求中单调增加，以避免重放攻击。

3. 每个端点的速率限制各不相同：公共端点每分钟最多允许 60 个请求，而私有端点的上限为每分钟 120 个请求，除非通过 Bybit 的机构层进行升级。

4. 错误处理必须解析 JSON 响应以获取状态代码，例如 10001（无效 API 密钥）、10002（无效签名）或 110001（余量不足），以触发适当的回退逻辑。

5. 会话重用提高了性能——通过urllib3的PoolManager的持久连接减少了高频订单提交期间的TCP握手开销。

WebSocket 实时数据流

1. Bybit支持WebSocket v5来获取实时市场数据、交易执行更新和仓位变化。使用与 REST 相同的 API 密钥和签名方法通过单个身份验证帧启动连接。

2. 订阅orderbook.1.BTCUSDT或trade.BTCUSDT等主题需要发送带有 op: 'subscribe' 和 args: ['topic.name'] 的 JSON 负载。

3. 必须每 20 秒发送一次心跳 ping，以保持连接稳定性。如果在超时窗口内未能响应，则会触发强制断开连接和重新连接序列。

4. 消息压缩默认处于禁用状态，但可以在 WebSocket 握手期间通过 permessage-deflate 扩展协商来启用，以实现带宽敏感的部署。

5. 订单簿快照首先作为全深度快照到达，然后是增量更新。客户端必须正确应用这些增量，以避免状态不同步和错误定价。

构建基本的自动交易机器人

1. 一个最小的工作机器人首先初始化凭据，建立用于价格反馈的 WebSocket 连接，并设置用于下单的 REST 会话。

2. 策略逻辑（例如检测移动平均线交叉）在从 WebSocket 交易流重建或通过 REST /v5/market/kline 获取的逐笔报价级别 OHLCV 数据上运行。

3. 订单执行使用 POST /v5/order/create，并严格验证边线（买入/卖出）、订单类型（市价/限价）和数量字段。数量格式无效返回错误 30089。

4. 风险控制包括在提交前检查可用保证金、验证未结订单数量限制以及根据权益百分比强制执行最大头寸规模。

5. 日志记录必须捕获原始请求/响应有效负载、时间戳和执行延迟指标，以帮助调试延迟峰值或意外填充。

常见问题解答

问：测试网和主网可以使用相同的 API 密钥吗？答：不需要。测试网和主网需要单独生成 API 密钥。在一种环境中创建的密钥在另一种环境中不起作用。

问：如果我的机器人发送重复的订单 ID 会怎样？答：Bybit 在 24 小时窗口内拒绝重复的 clOrdID 值，错误代码为 110012，防止意外重复提交。

问：有没有办法检索超过 7 天的历史交易记录？答：REST /v5/execution/list 仅返回过去一周的记录。对于扩展档案，用户必须在实时操作期间在自己的基础设施上启用交易日志记录。

问：现货和衍生品 API 是否共享相同的身份验证流程？答：是的。两者都使用相同的 HMAC-SHA256 签名逻辑和标头结构，尽管端点路径和所需参数在产品类型之间存在显着差异。