bybit API智能炒币编程机器人开发入门配置教程二

aijiebots入门量化交易机器人,完全免费,办公环境运行,适合小白入门。

鉴权/认证

信息

请先生成测试网主网API KEY。

REST接口根URL:

  • 测试网:
    https://api-testnet.bybit.com

  • 主网(请根据您的网络情况选择以下任意一个地址使用):
    https://api.bybit.com
    https://api.bytick.com

重要

  • 荷兰地区用户: 主网域名:https://api.bybit.nl

  • 香港地区用户: 主网域名:https://api.byhkbit.com
    如您继续使用该域名, 则Bybit无法保证该域名的稳定性和速度, 以及该域名对于以上地区的用户可能随时停止服务

选择用于鉴权的API密钥类型

系统生产的API密钥: Bybit 系统生成的API 密钥基于HMAC 对称加密算法运作。您将获得一对公钥和私钥。请将这对密钥视为密码一样妥善保管。

跟随HMAC签名示例来完成加密过程。

自动生成的API密钥: 自动生成的API 密钥基于RSA 非对称加密算法运作。您必须通过软件自行创建公钥和私钥,然后仅向Bybit 提供公钥。 Bybit 不会替您保管私钥。

  1. 使用开源的RSA密钥对创建器来创建出一组RSA密钥对

  2. 跟随RSA签名示例来完成加密过程。

公共参数

需要签名的接口必须包含以下http头参数:

  • X-BAPI-API-KEY- API密钥

  • X-BAPI-TIMESTAMP- UTC毫秒时间戳

  • X-BAPI-SIGN- 请求参数签名

  • X-Refereror Referer- 经纪商用户专用的头参数

另外我们提供可选的X-BAPI-RECV-WINDOW参数(单位是毫秒,默认值为5000),来指定请求在多长时间内有效,同时用来防止重放攻击。

警告

注意,timestamp参数必须符合如下规则:
server_time - recv_window <= timestamp < server_time + 1000
其中server_time是Bybit服务器时间,您可以通过Bybit服务器时间接口获取.

构建请求

提示

为了帮助诊断高级网络问题,您可以考虑将cdn-request-id添加到您的请求头中。对于每个请求,它的值应该是唯一的。 .

基本步骤:

  1. 时间戳+ API key + [recv_window] [queryString(无需排序) | jsonBodyString]

  2. 使用HMAC_SHA256或者RSA_SHA256算法对第1步中拼接的string签名,并转换为16进制字符串(HMAC_SHA256) / Base64编码(RSA_SHA256),得出sign参数。

  3. 添加生成的签名到HTTP头当中 注意: GETPOST请求的加密明文是不相同,请参考以下示例.

信息

签名计算示例

对明文加密的示例

  • 得到

  • 邮政

# 拼接規則:
timestamp+api_key+recv_window+queryString

# 明文
"1658384314791XXXXXXXXXX5000category=option&symbol=BTC-29JUL22-25000-C"

# 解析
timestamp = "1658384314791"
api_key = "XXXXXXXXXX"
recv_window = "5000"
queryString = "category=option&symbol=BTC-29JUL22-25000-C"

http请求示例

  • http-get

  • http-post

GET /v5/order/realtime?category=option&symbol=BTC-29JUL22-25000-C HTTP/1.1
Host: api-testnet.bybit.com
-H 'X-BAPI-SIGN: XXXXXXXXXX' \
-H 'X-BAPI-API-KEY: XXXXXXXXXX' \
-H 'X-BAPI-TIMESTAMP: 1658384431891' \
-H 'X-BAPI-RECV-WINDOW: 5000'

外层通用数据结构

参数类型说明
重试代码数字成功/错误码
返回消息细绳成功/错误消息. 成功消息可以是OKsuccess,SUCCESS
结果目的业务数据体
重定向文本信息目的额外信息. 大部分场景下都是{}
时间数字当前时间戳(毫秒)
{
   "retCode": 0,
   "retMsg": "OK",
   "result": {
   },
   "retExtInfo": {},
   "time": 1671017382656
}



  admin   2024-5-24