如何使用Bybit API交易？开发者入门指南

API访问和密钥管理

1.通过官方网站或桌面应用程序登录您的Bybit账户。

2. 导航至账户设置 → API 管理 → 创建 API 密钥。

3. 指定一个描述性名称，选择IP白名单限制，并仅启用必要的权限，例如“只读”、“交易”或“提现”。

4. 使用2FA确认创建；将 API 密钥和 API 秘密离线存储在加密保管库中。

5. 切勿在前端代码、浏览器控制台或公共存储库中公开 API Secret。

支持的 API 版本和端点

1. Bybit V5 REST API以统一的结构和一致的响应模式为现货、衍生品和资产端点提供服务。

2. WebSocket公共通道提供实时市场数据，包括订单簿深度（orderbook.50）、股票代码（tickers）和交易执行（publicTrade）。

3. WebSocket私有通道支持仓位更新、订单状态更改、钱包余额通知和执行报告。

4. 统一交易账户端点允许跨现货和衍生品进行全仓操作，无需手动转账。

5. 所有端点都需要严格的时间戳同步——时钟偏差超过30秒会触发拒绝。

身份验证工作流程

1. 每个请求必须包含 X-BAPI-API-KEY 标头，其中包含您的活动 API 密钥。

2. X-BAPI-SIGN 标头携带连接字符串的 HMAC SHA256 哈希：时间戳 + api_key + recv_window + Payload 。

3. X-BAPI-TIMESTAMP 标头包含当前 Unix 时间戳（以毫秒为单位）。

4. X-BAPI-RECV-WINDOW 定义签名验证可接受的时间窗口，默认为 5000 ms。

5. 签名前，有效负载必须采用 JSON 序列化，不带空格，并按字典顺序对密钥进行排序。

速率限制和错误处理

1. REST API 强制公共端点的每个 API 密钥每分钟 120 个请求，私有端点每分钟 60 个请求。

2. WebSocket 连接限制为每个连接 100 个订阅；超过触发自动断开。

3. HTTP 429响应表明速率限制耗尽；客户端必须实现指数退避和抖动。

4. 常见错误码包括10001（签名无效）、10002（时间戳过期）、30087（余量不足）。

5. 所有错误主体都包含 retCode、retMsg 和其他上下文字段，例如用于调试的 orderId 或符号。

常见问题解答

问：测试网和主网可以使用相同的 API 密钥吗？不需要。测试网和主网需要从各自的域生成单独的 API 密钥。 https://api-testnet.bybit.com 上发布的密钥在生产中无效。

问：Bybit 是否支持 Webhook 集成来执行订单？不可以。Bybit 不提供 webhook 传送。客户端必须维护持久的 WebSocket 连接或轮询 REST 端点以获取填充确认。

问：是否可以通过编程方式撤销 API 密钥？是的。使用具有有效身份验证的 DELETE /v5/user/api-key 端点。该操作需要目标密钥的 ID 并且无法撤消。

问：Bybit 是否有官方维护的 Python 或 JavaScript 的 SDK？ Bybit 在 GitHub 上提供社区支持的 SDK，但不发布或认可任何官方维护的特定于语言的库。开发人员依赖第三方维护的 pybit 和 bybit-api 包。