Bybit API 参考手册

Bybit API (Application Programming Interface) 允许开发者以编程方式访问 Bybit 交易所的功能，从而实现自动化交易、数据分析、策略回测等。对于有编程基础的交易者和机构投资者来说，Bybit API 是一个强大的工具。本手册旨在为初学者提供 Bybit API 的全面介绍，涵盖其核心概念、认证方法、常用端点以及实际应用示例。

1. API 简介

API 就像一个桥梁，连接不同的软件系统，使它们能够互相通信和交换数据。在加密货币交易领域，交易 API 允许开发者直接与交易所的交易引擎交互，而无需手动操作交易界面。

Bybit 提供两种主要的 API：

REST API: 基于 HTTP 请求的 API，适用于大部分常见应用场景，如获取市场数据、下单、查询账户信息等。
WebSocket API: 基于 WebSocket 协议的 API，提供实时数据流，适用于需要快速响应市场变化的应用，如高频交易、实时监控等。

选择哪种 API 取决于您的具体需求。如果需要实时数据，WebSocket API 是更好的选择。如果只需要定期获取数据或执行简单的交易操作，REST API 即可满足需求。

交易机器人的开发通常依赖于 API 的运用。

2. API 认证

在使用 Bybit API 之前，您需要进行身份验证，以确保您的账户安全。Bybit 采用 API Key 和 API Secret 组合进行认证。

API Key: 类似于您的用户名，用于标识您的应用程序。
API Secret: 类似于您的密码，用于验证您的身份。请务必妥善保管您的 API Secret，切勿泄露给他人。

您可以按照以下步骤获取 API Key 和 API Secret:

登录您的 Bybit 账户。
导航至 API Management 页面 (通常在账户设置或个人资料中)。
创建一个新的 API Key。
设置 API Key 的权限，例如，允许交易、读取账户信息等。
复制并安全保存您的 API Key 和 API Secret。请注意，API Secret 只会显示一次。

Bybit API 使用 HMAC SHA256 算法对请求进行签名，以确保请求的安全性。

API 安全是至关重要的，需要高度重视。

3. REST API 常用端点

以下是一些常用的 Bybit REST API 端点：

端点描述 HTTP 方法示例 **获取市场深度图** 获取特定交易对的买卖盘信息。 GET /v2/depth?symbol=BTCUSD&limit=20 **获取 K 线数据** 获取特定交易对的历史价格数据。 GET /v2/kline/list?symbol=BTCUSD&interval=1&from=1678886400 **获取交易对信息** 获取特定交易对的交易规则、价格精度等信息。 GET /v2/symbols **下单** 创建一个新的订单。 POST /v2/order/create **查询订单** 获取特定订单的信息。 GET /v2/order/info?symbol=BTCUSD&order_id=123456789 **取消订单** 取消一个未完成的订单。 POST /v2/order/cancel **获取账户信息** 获取您的账户余额、持仓等信息。 GET /v2/account/info **获取交易历史** 获取您的交易历史记录。 GET /v2/trade/execution

请注意，以上只是部分常用端点。Bybit API 提供了更丰富的端点，您可以参考 Bybit API 文档获取完整的列表：Bybit API 文档。

了解 流动性 对于理解深度图至关重要。

4. WebSocket API 常用频道

WebSocket API 通过订阅不同的频道来接收实时数据。以下是一些常用的频道：

频道描述 **trade** 接收实时交易信息。 **depth** 接收实时深度图信息。 **kline** 接收实时 K 线数据。 **position** 接收账户持仓变化信息。 **order** 接收订单状态变化信息。

例如，订阅 trade 频道可以实时获取 BTCUSD 交易对的交易信息。

WebSocket 协议是实时数据传输的关键技术。

5. API 参数和数据格式

Bybit API 使用 JSON 格式进行数据交换。所有请求和响应都采用 JSON 格式。

API 请求通常需要传递一些参数，例如交易对、数量、价格等。这些参数需要在请求体中以 JSON 格式传递。

API 响应通常包含以下信息：

ret_code: 返回码，表示请求是否成功。0 表示成功，非 0 表示失败。
ret_msg: 返回消息，提供关于请求结果的详细信息。
'''result

平台	期货特点	注册
Bybit Futures	杠杆高达125倍，USDⓈ-M 合约	立即注册
BingX Futures	跟单交易	加入BingX
Bitget Futures	USDT 保证合约	开户
Bybit	加密货币交易平台，杠杆高达100倍	Bybit
Pionex Futures	内置交易机器人，USDⓈ-M 永续合约	注册 Pionex

Bybit API 参考手册