如何使用Bybit API？

BYBIT API可以通过安全的REST和WebSocket端点启用自动交易，实时数据流以及位置管理。

2025/08/04 23:42

了解Bybit API及其用例

BYBIT API是一个强大的接口，允许交易者和开发人员以编程方式与Bybit的交易平台进行交互。它可以自动化交易策略，实时市场数据检索，订单放置，职位管理和帐户余额监控。 API支持RESTFUL和WEBSOCKETS协议，为不同的用例提供了灵活性。 REST API是一次性请求的理想选择，例如下订单或支票余额，而Websocket最适合连续数据流，例如实时价格更新或订单簿更改。在使用API之前，用户必须从其BYBIT帐户中生成API密钥，该键是身份验证凭证。

生成您的bybit API密钥

要开始使用BYBIT API，必须首先创建一个API键。此过程直接在您的BYBIT帐户仪表板中完成。在您的个人资料设置下导航到API管理部分。单击创建API ，将提示您输入API键的名称并设置IP限制。 IP白色列表通过限制API访问指定的IP地址来增强安全性。输入所需的详细信息后，BYBIT将生成一对凭据： API密钥和一个秘密密钥。这些必须安全存储，因为初始创建后不会再次显示秘密密钥。切勿共享这些键或以客户端代码暴露它们。

为请求配置API身份验证

BYBIT API中的所有私人端点都需要使用API密钥和秘密密钥进行身份验证。身份验证是通过HMAC SHA256签名实现的。每个请求必须包括特定的标题：

• X-BAPI-API-KEY ：您的API密钥
• X-Bapi-Sign ：生成的签名
• X-Bapi-Timestamp ：当前的时间戳以毫秒为单位
• X-BAPI-RECV-WINDOW ：可选，定义请求有效性的时间窗口（默认为5000ms）

要生成X-BAPI-SIGN ，请以特定顺序（Timestamp + api_key + recv_window + query_string）加入请求参数，然后使用HMAC SHA256与您的秘密密钥一起使用它们。大多数编程语言为此提供内置库。例如，在Python中，使用hmac和hashlib模块。确保时间戳与BYBIT的服务器时间同步，以避免签名错误。

使用REST API下订单

要通过BYBIT API进行交易，请将邮政请求发送到适当的端点，例如/v5/order/create 。必需的参数包括：

• 符号：交易对，例如， btcusdt
• 侧面：买卖
• OrderType ：例如极限，市场或停止
• 数量：交易数量
• 价格：限额订单的要求
• TimeInforce ：指定执行说明，例如， GTC （良好直到取消）

在发送请求之前，请确保正确格式化所有参数并包含在签名计算中。成功的响应将返回包含OrderID ， OrderLinkID和状态的JSON对象。始终验证响应代码和消息以确认执行。使用OrderLinkid在随后的查询中跟踪您的订单。

使用WebSocket流式传输实时数据

对于需要实时更新（例如算法交易机器人或市场监控仪表板）的应用程序，bybit的Websocket API至关重要。连接到Websocket端点： wss://stream.bybit.com/v5/public/linear for USDT永久合同。建立连接后，使用订阅消息格式订阅主题。示例包括：

• orderbookl2_25.btcusdt ：前25个订单簿级别
• tickers.btcusdt ：实时股票数据
• Candle.1.btcusdt ：1分钟烛台数据
• publictrade.btcusdt ：最近的交易

收到的每个消息将包含一个主题字段和数据有效载荷。相应地解析JSON响应。对于私人数据（例如位置或余额更新），请建立与私人端点的单独的Websocket连接，并包括类似于REST的身份验证标头。

通过API管理职位和风险

BYBIT API允许完全控制开放位置。要检索当前职位，请将get请求发送到/v5/position/list 。响应包括尺寸，入门额，未实现的PNL和杠杆作用。要修改位置，例如调整停止损失或付费级别，请使用/v5/position/trading-stop端点。必需参数：

• 象征
• Stoploss ：停止损失价格
• TakeProfit ：卖方价格

确保这些值在允许的价格范围内和帐户杠杆设置范围内。要结束职位，请按相同数量的相对的市场订单下达对立的市场订单。例如，如果您持有1 BTC的买入头寸，请发送1 BTC的卖出市场订单。通过检查下一个位置查询中更新的位置大小来确认关闭。

常见问题

如何重置我的Bybit API秘密密钥？

BYBIT不允许直接重置秘密键。您必须删除现有的API密钥并创建新的API密钥。导航到API管理，找到密钥，单击删除，确认操作，然后生成新的密钥对。立即使用新凭据更新您的应用程序。

我可以在没有IP限制的情况下使用BYBIT API吗？

是的，但是这是高度灰心的。残留IP限制会使您的API密钥暴露于潜在的滥用中。如果必须禁用它，请确保您的应用程序使用其他安全层，例如加密存储和最少的权限范围。

BYBIT API适用于什么速率限制？

BYBIT执行限制以防止滥用。 REST API每个IP最多允许每秒60个请求。 WebSocket连接每个连接最多24个订阅。超过极限会导致429误差。在多个IP上分发请求，或在可能的情况下使用批处理。

为什么我会遇到“无效的签名”错误？

这通常是由于不正确的参数排序，时间戳不匹配或错误的哈希方法而发生的。验证时间戳是否匹配X-Bapi-Timestamp标头，参数在词典上进行排序，并且HMAC SHA256与正确的秘密键一起使用。用简单的端点进行测试，例如/v5/user/query-api ，以隔离问题。