如何使用BYBIT API进行合同交易？

BYBIT API启用具有安全身份验证的自动合同交易，通过WebSocket实时数据以及USDT和反向合同的全订单管理。

2025/08/11 13:01

了解合同交易的Bybit API

BYBIT API是一种强大的工具，可让交易者自动在Bybit Exchange上自动化其合同交易策略。通过利用API，用户可以通过编程订单，管理职位，检索市场数据并监视帐户状态。首先，必须了解BYBIT支持Restful API和WebSocket API进行实时交互。合同交易的API端点是专门针对USDT永久，逆永久和期货合约量身定制的。在任何集成之前，请确保您根据打算交易的合同类型访问正确的API文档。

首先，请导航到您的BYBIT帐户设置并生成API密钥。在此过程中，您必须定义“订单”，“资产”和“只读”之类的权限。对于合同交易，需要“订单”和“职位”权限。切勿在客户端代码或公共存储库中公开您的秘密密钥。拨打API调用时，请务必使用HTTP ，以确保安全通信。

设置您的API凭据

要有效地使用BYBIT API，必须首先创建和配置API键。登录到您的BYBIT帐户，然后访问您的个人资料下的API管理部分。单击创建API ，然后将名称分配给您的密钥以易于标识。设置权限时：

• 允许贸易许可允许订单安置和取消
• 启用职位许可以访问开放位置并利用设置
• 除非绝对必要以降低安全风险，否则限制提款

创建后，您将收到三个关键组件： API密钥，秘密密钥和用户ID 。安全地存储这些。您还可以设置IP限制，以限制对特定IP地址的API访问，从而增强安全性。如果您的IP更改，则必须相应地更新白名单。请注意，BYBIT使用HMAC-SHA256进行身份验证，因此您的请求必须包含正确签名的消息。

身份验证的API请求

必须使用您的API密钥和秘密密钥对BYBIT的每个私人API请求进行身份验证。身份验证过程涉及使用HMAC-SHA256哈希生成签名。要签名的字符串通常包括HTTP方法，请求路径，查询参数和时间戳。时间戳必须在服务器时间的5秒内，以防止重播攻击。

这是构建签名的方法：

• 加入请求方法（例如，post），请求路径（例如，/v5/order/create）和查询字符串（如果有）
• 使用您的秘密钥匙使用HMAC-SHA256哈希串联字符串
• 用十六进制格式编码结果
• 在请求标题中以X-BAPI-SIGN包含签名

所需的其他标头包括X-BAPI-API-KEY ， X-BAPI-TIMESTAMP和X-BAPI-RECV-WINDOW （可选，默认为5000ms）。不正确的时间戳或签名会导致身份验证故障。始终验证您的系统时钟与NTP服务器同步。

下达和管理合同订单

要通过BYBIT API发布合同订单，请使用/V5/订单/创建端点。您必须包括基本参数，例如符号，侧面（买或出售）， ordertype （限制，市场等），数量和价格（用于限额订单）。对于USDT划分的合同，符号格式为BTCUSDT 。对于违反合同，它是BTCUSD 。

要考虑的关键参数：

• TimeInforce ：选项包括GoodTillCancel，AmptighoreCancel，Fillorkill
• 减少：设置为true，以确保订单仅降低位置大小
• Closeontrigger ：可用于停止损失或替代订单
• positiondx ：对冲模式所需；单程为0，长1，短2

要取消订单，请使用订购或OrderLinkID使用/V5/订单/取消端点。要检索活动订单，请使用/V5/订单/实时。对于职位管理， /v5/位置/列表端点返回当前职位，包括尺寸，入口价格和杠杆作用。使用/V5/位置/设置杠杆调整杠杆。

检索市场和帐户数据

实时市场数据对于知情交易决策至关重要。 Bybit为此目的提供了几个公共终点。使用/V5/Market/Tickers以获取所有合同的最新价格，资金率和24小时的数量。对于订单簿数据，使用/v5/market/orderbook带有符号和深度参数（例如，1、5、50级）。要获取历史烛台数据，请使用/V5/Market/Kline与类别，符号，间隔和开始/结束时间。

对于帐户相关的数据， /v5/帐户/钱包平衡端点返回所有硬币的钱包余额。使用/V5/帐户/信息获取总体帐户详细信息，包括总权益和可用余额。要监视最近的订单填充，请使用/V5/订单/执行列表。这将返回以价格，数量，费用和出口执行交易。

实施Websocket进行实时更新

对于低延迟交易，请使用BYBIT的Websocket API，而不是轮询休息端点。连接到USDT合同或wss://stream.bybit.com/v5/public/linear for wss://stream.bybit.com/v5/public/inverse for thersevers合同。要订阅实时数据，请将带有OP字段设置的JSON消息发送到“订阅”，而ARGS数组包含orderBookL2_25.BTCUSDT ， tickers.BTCUSDT或candle.1.BTCUSDT等主题。

对于诸如订单更新和位置更改之类的私人数据，请验证WebSocket连接。使用您的API密钥，时间戳和签名发送身份验证请求。经过身份验证后，订阅order ， position和execution主题以接收实时更新。 Websocket消息使用ZLIB压缩，因此在解析之前对其进行解压缩。

常见问题

BYBIT API的速率限制是多少？

BYBIT执行限制以防止滥用。对于REST API，限制通常为每个API密钥每秒60个请求。超过此结果在HTTP 429错误中。 Websocket连接允许更高的吞吐量，但也受到基于订阅计数和消息频率的限制。

如何处理诸如“无效签名”之类的API错误？

确保您的秘密密钥是正确的，不要修剪。验证签名字符串包括确切的方法，路径和参数。检查时间戳是否为毫秒，在BYBIT服务器时间的5秒内。使用https://api.bybit.com/v5/market/time获取当前服务器时间。

我可以将BYBIT API用于电网交易还是DCA机器人？

是的，API支持自动化策略。使用/v5/order/在循环中以不同的价格和数量创建。实施逻辑以取消陈旧的订单并根据市场条件调整位置。确保您的机器人处理资金付款和清算风险。

测试网络可用于API合同交易吗？

是的，Bybit在https://api-testnet.bybit.com上提供了测试网环境。使用它来模拟交易，而不会冒着实际资金的风险。为TestNet生成单独的API键。所有终点都反映了实时环境，允许进行完整的策略测试。