Bybit API自动化交易详细设置指南

• 密钥名称: 为您的 API 密钥起一个有意义的名称，方便您区分不同的密钥。例如，"量化交易机器人"、"网格交易" 等。
• 权限设置: 这是最重要的部分。Bybit API 提供多种权限设置，您需要根据您的交易策略选择合适的权限。常见的权限包括：
  • 读取权限: 允许 API 读取账户信息、市场数据等。

  • 交易权限 : 授予 API 进行交易操作的权力，包括提交买单和卖单（下单）以及取消未成交的订单（撤单）。 请务必极其谨慎地授予交易权限！ 不恰当的交易权限管理可能导致资金损失或账户安全风险。 在启用此权限前，请充分了解相关风险，并确保您的 API 密钥和交易策略的安全可靠。 建议仅在您完全信任的应用程序或脚本中使用交易权限，并且定期审查和更新您的 API 密钥。

    资金划转权限

    该权限允许应用程序编程接口 (API) 在您的不同账户（例如主账户和子账户）之间执行资金转移操作。启用此权限后，API 将能够发起转账，将资金从一个账户转移到另一个账户，而无需您手动确认每个交易。

    风险提示： 授予此权限具有极高的风险，务必谨慎操作。在授予任何 API 资金划转权限之前，请务必彻底了解以下风险：

    • 潜在的安全漏洞： 如果 API 密钥泄露或被恶意利用，攻击者可能未经授权地划转您的资金。
    • 意外的资金转移： 配置错误的 API 或应用程序可能导致意外的资金转移，造成不必要的损失。
    • 欺诈风险： 欺诈应用程序可能会利用此权限窃取您的资金。

    安全建议：

    • 除非绝对必要，否则不要授予此权限。 仔细评估您的需求，并仅在必要时才启用此权限。
    • 限制 API 访问权限。 尽量减少 API 可以访问的账户数量和可以执行的操作类型。
    • 实施严格的安全措施。 保护您的 API 密钥，并定期监控 API 活动，以检测任何可疑行为。
    • 仅授予可信的应用程序此权限。 验证应用程序的开发者，并确保应用程序经过安全审计。

    请务必仔细阅读并理解相关文档和条款，并充分评估风险后再进行操作。如果您不确定，请寻求专业人士的帮助。

    IP 地址限制 (可选): 为了进一步提高安全性，您可以限制 API 密钥只能从指定的 IP 地址访问。 这意味着只有来自这些 IP 地址的请求才能使用该 API 密钥。
• 生成 API 密钥: 填写完所有信息后，点击 "提交" 或 "创建" 按钮，Bybit 将会生成您的 API 密钥。
• 保存 API 密钥: 请务必妥善保存您的 API 密钥和密钥密码 (Secret Key)。 这两个密钥只会在创建时显示一次，之后无法再次查看。 如果您丢失了密钥，您需要重新生成一个新的密钥。建议使用密码管理器或者加密的文本文件来保存您的密钥。
• 启用 API 密钥: 创建完成后，您的 API 密钥可能需要手动启用才能使用。请确保您的 API 密钥状态为 "已启用"。
重要提示:
• 不要将 API 密钥泄露给任何人。
• 定期更换 API 密钥，以提高安全性。
• 监控 API 密钥的使用情况，及时发现异常行为。
• 使用 IP 地址限制，尽可能缩小 API 密钥的访问范围。
• 不要在公共网络或者不安全的设备上保存 API 密钥。

二、交易环境的搭建

在成功获取 API 密钥后，下一步是构建一个稳定可靠的交易环境，用于自动化执行交易策略。该环境涉及编程语言的选择、必要的软件库安装以及与交易所 API 建立安全连接。

1. 选择编程语言

   常见的选择包括 Python、JavaScript (Node.js) 和 Java。Python 因其简洁的语法和丰富的第三方库（如 ccxt、requests）而广受欢迎，适合快速开发和原型设计。JavaScript (Node.js) 则适用于构建高性能的事件驱动型交易系统。Java 以其跨平台性和稳定性在金融领域占据一席之地。选择时，请根据您的编程经验、项目需求和性能目标进行权衡。

2. 安装必要的库

   根据您选择的编程语言，安装相应的 API 客户端库是至关重要的。例如，如果选择 Python，可以使用 pip 安装 ccxt 库（ pip install ccxt ）。ccxt 提供了统一的 API 接口，方便连接到多个加密货币交易所。可能还需要安装其他库，如用于数据分析的 pandas、用于绘图的 matplotlib 或用于异步编程的 asyncio。务必查阅相关库的官方文档，了解安装和使用方法。

3. 配置 API 连接

   在代码中配置 API 连接涉及设置 API 密钥、私钥和交易所 endpoint。API 密钥用于身份验证，私钥用于签名交易请求。请务必妥善保管您的私钥，切勿泄露给他人。建议将 API 密钥和私钥存储在环境变量或配置文件中，避免硬编码在代码中。配置交易所 endpoint 时，请参考交易所的 API 文档，确保使用正确的 URL 和版本号。

4. 安全措施

   交易环境的安全性至关重要。除了妥善保管 API 密钥和私钥外，还应采取其他安全措施，如：

   • 使用 HTTPS 连接，确保数据传输的安全性。
   • 实施输入验证，防止恶意代码注入。
   • 限制 API 密钥的权限，仅授予必要的访问权限。
   • 定期审查和更新您的代码，修复潜在的安全漏洞。
   • 启用双因素认证 (2FA)，增强账户的安全性。

选择编程语言: 您可以使用多种编程语言来与 Bybit API 交互，常见的选择包括 Python、Java、C++、Node.js 等。 Python 因其易用性和丰富的量化交易库而成为许多人的首选。

• requests: 用于发送 HTTP 请求。
• pybit: Bybit 官方提供的 Python API 库。
• ccxt: 一个通用的加密货币交易所 API 库，支持包括 Bybit 在内的 100 多个交易所。

您可以使用 pip 命令来安装这些库：

bash pip install requests pybit ccxt

from pybit import HTTP

apikey = "YOURAPIKEY" # 替换为您的 API 密钥 apisecret = "YOURAPISECRET" # 替换为您的密钥密码

使用主网

与 Bybit 主网交互，你需要创建一个 HTTP 会话实例。这个实例将用于发送 API 请求并接收响应。

要初始化会话，你需要提供以下参数：

• endpoint : Bybit 主网 API 的 URL 地址，通常为 "https://api.bybit.com" 。 请务必仔细核对，以确保与主网交互，避免在测试网发生交易。
• api_key : 你的 API 密钥，用于身份验证。 请务必妥善保管您的 API 密钥，不要泄露给任何第三方。
• api_secret : 你的 API 密钥的私钥，也用于身份验证。 请务必妥善保管您的 API 密钥的私钥，不要泄露给任何第三方。API 密钥和私钥需要配合使用，才能完成身份验证。

示例代码：

    
session = HTTP(
    endpoint="https://api.bybit.com",
    api_key=api_key,
    api_secret=api_secret
)
    

请将 api_key 和 api_secret 替换为你自己的 API 密钥和私钥。 创建 HTTP 实例后，就可以使用它来调用 Bybit API 的各种方法。

或者使用测试网

为了在不涉及真实资金的情况下测试您的交易策略和API集成，Bybit提供了一个测试网络环境。使用测试网允许您在模拟的交易环境中进行实验，而无需承担任何财务风险。要连接到Bybit的测试网API，您需要配置您的HTTP会话以指向测试网的API端点。

以下代码展示了如何使用 pybit 库创建一个连接到Bybit测试网的HTTP会话。请确保您已经安装了 pybit 库，如果没有，可以使用 pip install pybit 命令进行安装。

在以下代码中， endpoint 参数被设置为 https://api-testnet.bybit.com ，这指定了连接到Bybit测试网API。您还需要提供您的API密钥（ api_key ）和API密钥Secret（ api_secret ），这些密钥需要从Bybit测试网账户获取。请注意，测试网的API密钥与主网的API密钥是不同的，您需要在Bybit测试网平台上注册并获取测试网API密钥。

示例代码：

session = HTTP( endpoint="https://api-testnet.bybit.com", api_key=api_key, api_secret=api_secret )

确保将 api_key 和 api_secret 替换为您的实际测试网API密钥和密钥Secret。通过这种方式配置的 session 对象将用于与Bybit测试网API进行所有后续的交互，允许您安全地测试您的代码和交易策略。

• 强烈建议您先在 Bybit 测试网上进行测试，确保您的代码能够正常工作，然后再在主网上进行交易。
• 测试网的 API 地址为 https://api-testnet.bybit.com。
• 主网的 API 地址为 https://api.bybit.com。
• 请仔细阅读您选择的 API 库的文档，了解其使用方法和注意事项。

三、常见 API 调用

以下是一些常见的 Bybit API 调用示例，旨在帮助开发者快速掌握如何通过 API 与 Bybit 交易所进行交互，实现自动化交易和数据获取。

1. 获取账户信息

   通过 API 获取账户余额、可用资金、持仓信息等。这对于监控账户状态和制定交易策略至关重要。

   // 示例：获取账户余额
   GET /v5/account/wallet-balance
   

   该 API 调用需要提供 API 密钥和签名，确保请求的安全性。返回的数据通常包括不同币种的余额信息。

2. 下单交易

   使用 API 创建市价单、限价单、止损单等。下单是交易的核心操作，API 提供了灵活的参数配置，满足不同的交易需求。

   // 示例：创建一个限价买单
   POST /v5/order/create
   {
     "symbol": "BTCUSDT",
     "side": "Buy",
     "type": "Limit",
     "qty": "0.01",
     "price": "20000",
     "timeInForce": "GTC"
   }
   

   下单时需要指定交易对、买卖方向、订单类型、数量和价格等参数。 timeInForce 参数控制订单的有效期，例如 GTC (Good Till Cancelled) 表示订单持续有效直到被取消。

3. 撤销订单

   通过 API 取消未成交的订单。及时撤销未成交订单可以有效控制风险。

   // 示例：撤销一个订单
   POST /v5/order/cancel
   {
     "symbol": "BTCUSDT",
     "orderId": "1234567890"
   }
   

   撤单时需要提供交易对和订单 ID。API 提供了批量撤单的功能，可以一次性撤销多个订单。

4. 获取历史数据

   通过 API 获取历史 K 线数据、交易记录等。历史数据是分析市场趋势和回测交易策略的重要依据。

   // 示例：获取 BTCUSDT 的 1 分钟 K 线数据
   GET /v5/market/kline?symbol=BTCUSDT&interval=1&limit=200
   

   该 API 调用需要指定交易对、K 线周期和数据条数。返回的数据通常包括开盘价、最高价、最低价、收盘价和成交量等信息。

5. 订阅实时数据

   通过 WebSocket API 订阅实时交易数据、深度数据等。实时数据对于高频交易和快速反应市场变化至关重要。

   // 示例：订阅 BTCUSDT 的交易数据
   {
     "op": "subscribe",
     "args": ["publicTrade.BTCUSDT"]
   }
   

   WebSocket API 提供了推送服务，可以实时接收市场数据，避免了频繁轮询 API 接口带来的延迟和资源消耗。

获取账户余额

获取账户余额是与加密货币交易所或钱包交互时的一项基本操作。以下展示了如何使用特定会话对象（ session ）来检索指定币种（如USDT）的钱包余额。

balance = session.get_wallet_balance(coin="USDT")

上述代码行通过调用 session 对象的 get_wallet_balance 方法来执行余额查询。 coin="USDT" 参数指定了要查询余额的币种为 USDT（泰达币）。实际应用中，您可以根据需要修改此参数以查询其他支持的币种余额，例如 BTC（比特币）或 ETH（以太坊）。

print(balance)

这行代码将从 get_wallet_balance 方法返回的余额值打印到控制台。 balance 变量将包含账户中 USDT 的可用余额数量。余额的具体数值和数据类型取决于交易所 API 的实现，通常为浮点数或字符串类型。

注意事项：

• 确保您已正确初始化了 session 对象，并已通过身份验证。
• 不同的交易所或钱包 API 可能有不同的余额查询方法和参数。请查阅相关 API 文档以获取准确的使用说明。
• 余额可能以不同的精度显示。在使用余额进行交易或其他操作时，请注意精度问题。
• 某些交易所可能需要额外的权限才能查询余额。请确保您的 API 密钥具有足够的权限。
• 在处理金融数据时，务必注意安全性和保密性。不要在不安全的环境中泄露 API 密钥或其他敏感信息。

获取持仓信息

获取交易账户中特定交易对（如 BTCUSDT）的持仓信息，是量化交易和风险管理的关键步骤。通过 API 接口，可以实时获取包括多仓和空仓在内的详细持仓数据。

以下代码展示了如何使用 session 对象调用 get_positions 方法来获取 BTCUSDT 交易对的持仓信息，并将结果打印到控制台：

positions = session.get_positions(symbol="BTCUSDT")
print(positions)

get_positions 方法返回的数据通常包含以下关键字段：

• symbol: 交易对，例如 "BTCUSDT"。
• side: 持仓方向，"Buy" 表示多仓，"Sell" 表示空仓。
• size: 持仓数量，即合约数量。
• entryPrice: 平均持仓成本价。
• markPrice: 当前标记价格，用于计算盈亏。
• pnl: 当前盈亏金额。
• leverage: 杠杆倍数。
• liquidationPrice: 预估的爆仓价格。

通过分析这些数据，可以了解当前持仓的风险状况，并制定相应的交易策略。例如，可以根据盈亏情况调整仓位大小，或者设置止损止盈价格来控制风险。

下一个限价买单

在加密货币交易中，限价买单是一种常见的订单类型，允许交易者指定愿意购买加密货币的最高价格。以下代码示例展示了如何在交易平台上创建一个限价买单，该订单会在市场价格达到或低于指定价格时执行。为了更清晰地说明，我们逐步解释代码中的每个参数。

order = session.place_order(

这行代码调用了交易会话的 place_order 函数，用于提交新的订单到交易平台。 session 对象代表与交易所建立的连接，它包含了用户的API密钥和其他认证信息。 place_order 函数负责将订单信息发送到交易所的服务器。

symbol="BTCUSDT",

symbol 参数指定了交易的交易对。在这个例子中， BTCUSDT 代表比特币 (BTC) 与泰达币 (USDT) 的交易对。这意味着我们希望用泰达币购买比特币。

side="Buy",

side 参数定义了订单的方向。 "Buy" 表示这是一个买入订单，意味着我们希望购买指定数量的比特币。

order_type="Limit",

order_type 参数指定了订单的类型。 "Limit" 表示这是一个限价单。限价单允许交易者设定一个他们愿意支付的最高价格。只有当市场价格达到或低于这个价格时，订单才会被执行。

qty=0.001,

qty (quantity) 参数指定了订单的数量。在这个例子中， 0.001 表示我们希望购买 0.001 个比特币。请注意，数量的单位取决于交易对中基础货币的精度。

price=30000,

price 参数指定了限价单的价格。在这个例子中， 30000 表示我们愿意以每个比特币 30000 泰达币的价格购买。如果市场价格高于 30000 泰达币，则订单不会立即执行，而是会保留在订单簿中，直到市场价格下跌到 30000 泰达币或更低。

time_in_force="GoodTillCancel"

time_in_force 参数指定了订单的有效期。 "GoodTillCancel" (GTC) 表示订单将保持有效，直到被完全执行或被交易者手动取消。其他常见的有效期类型包括 "ImmediateOrCancel" (IOC)，它会立即执行所有可能的订单数量，并取消剩余部分；以及 "FillOrKill" (FOK)，它要求订单必须立即全部执行，否则将被取消。

)

这标志着 place_order 函数调用的结束。

print(order)

这行代码用于打印订单的详细信息。 order 对象包含了交易所返回的订单信息，例如订单ID、状态、执行价格等。这些信息对于跟踪订单状态和分析交易结果非常有用。

下一个市价卖单

以下代码展示了如何使用交易会话 ( session ) 发送一个市价卖单。市价单 (Market Order) 指的是以当前市场上最优价格立即执行的订单，其目的是快速成交。请注意，市价单的最终成交价格可能会与下单时的价格略有偏差，尤其是在市场波动剧烈时。

以下代码片段展示了如何创建一个市价卖单，交易标的为 BTCUSDT (比特币/美元)，卖出数量为 0.001 BTC。 time_in_force 参数设置为 "GoodTillCancel" (GTC)，意味着该订单会一直有效，直到被完全执行或被手动取消。

order = session.place_order(
    symbol="BTCUSDT",
    side="Sell",
    order_type="Market",
    qty=0.001,
    time_in_force="GoodTillCancel"
)
print(order)

session.place_order() 函数用于提交订单。 symbol 参数指定交易的资产对， side 参数设置为 "Sell" 表示卖出操作， order_type 参数设置为 "Market" 表示市价单， qty 参数指定卖出的数量， time_in_force 参数定义订单的有效时间。

在订单成功提交后， print(order) 语句会将订单的详细信息打印到控制台，包括订单ID、状态、成交价格等。通过这些信息，您可以监控订单的执行情况。

根据 order_id 撤销订单

通过指定 order_id 可以精确撤销特定的未成交订单。此方法适用于已知订单 ID 的情况，允许用户取消之前提交的、尚未完全成交的交易请求。

以下代码展示了如何使用 Python SDK 撤销指定 order_id 的订单：

cancel = session.cancel_order(symbol="BTCUSDT", order_id="YOUR_ORDER_ID")
print(cancel)

参数说明：

• symbol ：交易对代码，例如 "BTCUSDT"，表示比特币兑美元。
• order_id ：需要撤销的订单的唯一标识符。请将 "YOUR_ORDER_ID" 替换为实际的订单 ID。

返回值：

cancel 变量将包含交易所返回的撤单操作结果。该结果通常包含撤单是否成功的信息，以及交易所分配的撤单 ID。开发者应检查此返回值以确认撤单操作已成功执行。

注意事项：

• 仅能撤销未完全成交的订单。如果订单已经完全成交，则无法撤销。
• 撤单请求可能因为网络延迟或其他原因而失败。开发者应该实现适当的错误处理机制，以应对撤单失败的情况。
• 频繁的撤单操作可能会影响交易体验，甚至触发交易所的风控策略。请谨慎使用撤单功能。
• 在真实交易环境中，请务必使用实际的 order_id 进行测试，确保撤单功能正常运作。

撤销所有未成交的订单

通过 session.cancel_all_active_orders(symbol="BTCUSDT") 函数，可以批量撤销指定交易对（例如"BTCUSDT"）的所有未成交挂单。此操作适用于在特定市场环境下需要快速清空当前订单簿的情况，例如行情突变或策略调整。

函数调用会向交易所发出取消所有该交易对未成交订单的请求。交易所收到请求后，会逐一取消这些订单。API返回的信息通常包含一个确认消息，指示取消请求已成功提交，但实际取消完成可能需要一定时间，具体取决于交易所的处理速度和当前的网络状况。

代码示例：

cancel_all = session.cancel_all_active_orders(symbol="BTCUSDT")
print(cancel_all)

cancel_all 变量将包含API调用返回的结果，通常是一个包含状态信息的字典或对象。开发者应检查返回的状态信息，确认取消请求是否成功提交。需要注意的是，即使请求成功提交，也并不意味着所有订单都立即被取消。建议开发者在取消订单后，通过查询订单状态API来确认订单是否已完全取消。

获取最新价格

获取加密货币的最新价格是量化交易和投资决策的关键步骤。 通过API接口，我们可以实时获取指定交易对（例如BTCUSDT，即比特币兑美元）的ticker信息，其中包含了最新成交价格、最高价、最低价、成交量等重要数据。

以下代码示例展示了如何使用API获取BTCUSDT的最新ticker信息：

ticker = session.get_tickers(symbol="BTCUSDT")
print(ticker)

代码解释：

• session ：表示一个API会话，它已经通过身份验证并准备好发送请求。
• get_tickers(symbol="BTCUSDT") ：这是API会话对象上的一个方法，用于获取指定交易对的ticker信息。 symbol 参数指定了要查询的交易对，这里是"BTCUSDT"。
• ticker ：变量 ticker 将存储从API返回的ticker数据。 该数据通常以字典或JSON格式表示，包含了如最新成交价、最高价、最低价等关键信息。
• print(ticker) ：这行代码会将 ticker 变量的内容打印到控制台，以便查看返回的ticker数据。

返回值示例：

API通常会返回一个包含以下字段的JSON对象：

{
  "symbol": "BTCUSDT",
  "bidPrice": "29000.00",
  "bidQty": "1.00",
  "askPrice": "29001.00",
  "askQty": "0.50",
  "lastPrice": "29000.50",
  "lastQty": "0.10",
  "openPrice": "28500.00",
  "highPrice": "29200.00",
  "lowPrice": "28400.00",
  "volume": "100.00",
  "quoteVolume": "2900000.00",
  "openTime": 1678886400000,
  "closeTime": 1678972800000,
  "firstId": 123456789,
  "lastId": 987654321,
  "count": 1000
}

字段解释：

• symbol : 交易对，例如 "BTCUSDT"。
• bidPrice : 最高买入价。
• bidQty : 最高买入价对应的数量。
• askPrice : 最低卖出价。
• askQty : 最低卖出价对应的数量。
• lastPrice : 最新成交价。
• lastQty : 最新成交量。
• openPrice : 开盘价。
• highPrice : 最高价。
• lowPrice : 最低价。
• volume : 交易量（以基础货币计）。
• quoteVolume : 交易额（以报价货币计）。
• openTime : 开盘时间戳。
• closeTime : 收盘时间戳。
• firstId : 首笔成交ID。
• lastId : 末笔成交ID。
• count : 成交笔数。

通过解析这些数据，我们可以获取所需的信息，例如最新价格 ( lastPrice )，并将其用于交易策略或其他分析中。

获取 K 线数据

K 线数据，也称为 OHLC（Open, High, Low, Close）数据，是加密货币交易中常用的数据类型，用于分析价格趋势。以下是如何使用 API 获取 K 线数据的示例，以 BTCUSDT 交易对为例，获取 1 分钟 K 线数据：

kline = session.get_kline( symbol="BTCUSDT", interval="1", # 1 分钟 K 线 from_time=1678886400 # 起始时间戳，Unix 时间戳格式 ) print(kline)

• symbol: 指定交易对，例如 "BTCUSDT"，表示比特币兑美元。不同的交易所支持的交易对有所不同。
• interval: 定义 K 线的时间周期。 "1" 表示 1 分钟 K 线，常见的周期还包括 "5" (5 分钟), "15" (15 分钟), "30" (30 分钟), "60" (1 小时), "1D" (1 天), "1W" (1 周), "1M" (1 月)。交易所对可用的时间周期有所限制。
• from_time: 指定起始时间，Unix 时间戳格式。Unix 时间戳是从 1970 年 1 月 1 日 00:00:00 UTC 到指定时间的秒数。例如， 1678886400 对应于某个特定日期和时间。需要根据实际需求调整起始时间。
• limit (可选): 指定返回 K 线的数量上限。如果未指定，API 可能会返回默认数量的 K 线。
• to_time (可选): 指定结束时间，Unix 时间戳格式。与 from_time 结合使用，可以精确控制返回的时间范围。

get_kline 函数返回的数据通常是一个列表，每个元素代表一个 K 线。每个 K 线包含以下信息：

• 开盘价 (Open): 该时间周期内的第一笔交易价格。
• 最高价 (High): 该时间周期内的最高交易价格。
• 最低价 (Low): 该时间周期内的最低交易价格。
• 收盘价 (Close): 该时间周期内的最后一笔交易价格。
• 交易量 (Volume): 该时间周期内的总交易量。
• 时间戳 (Timestamp): 该 K 线对应的时间戳。

根据交易所的不同，返回的 K 线数据格式可能略有差异，但通常都包含以上核心信息。在使用前，务必查阅交易所的 API 文档，了解具体的返回格式和参数要求。

• 请仔细阅读 Bybit API 文档，了解每个 API 接口的参数和返回值。
• 在实际交易中，您需要根据您的交易策略来调整 API 调用的参数。
• 注意控制下单频率，避免触发 Bybit 的风控规则。
• 处理 API 返回的错误信息，及时发现并解决问题。

四、风险控制

自动化交易系统具备显著的效率优势，能够全天候运行并快速响应市场变化。然而，它也伴随着潜在风险。务必实施全面的风险控制策略，以保障您的账户和资金安全，降低潜在损失。