如何访问BYBIT合同的历史交易数据？

了解BYBIT的历史交易数据

BYBIT合同的历史交易数据是指过去执行交易的记录，包括价格，数量，时间戳，侧面（买入/出售）和合同类型等信息。这些数据对于从事技术分析，进行回测策略或审核其交易绩效的交易者至关重要。 BYBIT通过多种方法（包括其官方API和Web界面）提供对此数据的访问。这些数据通常涵盖BTCUSD，Ethusd等各种加密货币的永久合同和期货合约。

区分公共贸易历史和个人贸易历史很重要。公共数据反映了订单簿上执行的所有交易，并且可供任何用户使用。个人贸易历史记录仅包括您的帐户执行的交易，需要访问身份验证。通过API检索两种类型的数据，都以JSON格式构成，使其适合集成到分析工具中。

通过BYBIT API访问公共贸易历史

要检索BYBIT合同的公共历史贸易数据，请使用官方的BYBIT REST API端点：

• API端点： https://api.bybit.com/v5/market/recent-trade

该端点返回指定符号的最新交易。要访问更深的历史记录，您必须使用每个响应中返回的光标参数进行分页。这是提出请求的方法：

• 使用所需参数的HTTP获取请求：
  • category ：设置为USDT合同的linear或反向合同的inverse
  • symbol ：指定合同，例如， BTCUSDT
  • limit ：每个请求的记录数（最多1000）
  • cursor ：使用前面响应中的光标获取下一批

python中的示例请求：

 import requests url ='https://api.bybit.com/v5/market/recent-trade' params = {






'category': 'linear', 'symbol': 'BTCUSDT', 'limit': 100
 }
 
响应= requests.get（url，params = params） data = reverse.json（）

返回的JSON包括价格，大小，侧面，时间和符号等字段。要检索旧数据，请从next_page_cursor字段中提取光标，并将其包含在下一个请求中。

使用API身份验证检索个人贸易历史记录

要访问您的个人合同贸易历史记录，需要身份验证。您必须从BYBIT帐户设置中生成一个具有“订单”和“读取”权限的API密钥。相关端点是：

• API端点： https://api.bybit.com/v5/order/execution-list

此端点返回与您的帐户相关的填充合同订单。必需的参数包括：

• category ： linear或inverse
• symbol ：例如， BTCUSDT
• start_time和end_time ：UNIX时间戳定义时间范围
• limit ：每个请求最多50个记录
• api_key ， timestamp和sign ：身份验证标头

生成请求的步骤：

• 在毫秒中产生时间戳
• 使用您的API秘密使用HMAC SHA256创建签名
• 包括标题： X-BAPI-API-KEY ， X-BAPI-TIMESTAMP ， X-BAPI-SIGN

示例用于签名的Python代码：

 import hmac import time api_key ='your_api_key' api_secret ='your_api_secret'时间戳= str（int（time.time（） * 1000））






param_str = f'category =线性＆符号= btcusdt＆limit = 50＆start_time = 1700000000000＆end_time = 1701000000000'签名= hmac.new（api_secret.encode（），param_str.encode（），digestmod ='sha256'）。hexdigest（）






标题= {






'X-BAPI-API-KEY': api_key, 'X-BAPI-TIMESTAMP': timestamp, 'X-BAPI-SIGN': signature
 }
 
响应= requests.get（url，params = params，headers =标题）

每个记录包括exec_price，exec_qty，side，Fee和order_id 。

将Bybit Web界面用于贸易历史记录

对于不愿使用API的用户，BYBIT提供了基于Web的界面来查看个人合同贸易历史记录。登录到您的BYBIT帐户并导航到：

• 衍生品→订单→贸易历史记录

在这里，您可以：

• 选择线性合同或反合同
• 从下拉列表中选择一个特定符号
• 按日期范围进行过滤
• 一次以CSV格式导出多达100个记录

显示的列包括符号，侧面，数量，价格，费用，封闭的PNL和时间。请注意，Web界面不允许一键单击所有历史数据的大量导出。您必须通过日期手动分页，并在需要时下载多个CSV文件。

处理和存储历史数据

检索后，应将历史贸易数据存储以进行分析。推荐格式包括CSV，Parquet或数据库表。对于连续数据收集，请设置定期调用API并附加新记录的CRON作业或脚本。

主要注意事项：

• 费率限制：BYBIT允许公共终点每分钟60个请求，私人终点为120
• 数据删除：使用exec_id或trade_time作为唯一标识符
• 时区处理：所有时间戳都在UTC中
• 数据保留：BYBIT在Web界面上保留长达6个月的个人贸易历史

将数据存储在结构化目录中：

 /trade_data/ /public/ btcusdt_20231201.csv

/私人的/

my_trades_20231201.csv

使用Python中的Pandas合并和分析：

import pandas as pd

df = pd.read_csv（'btcusdt_20231201.csv'） df ['time'] = pd.to_datetime（df ['time']，unit ='ms'）

常见问题

Bybit的合同贸易历史记录有多远？ BYBIT的公共API通常在recent-trade端点保留最多7天的贸易数据。对于较旧的公共数据，需要第三方聚合器或自定义数据收集脚本。通过私人API的个人贸易历史可以追溯到几个月，具体取决于创建日期和BYBIT的内部保留政策。

我可以获取tick级历史数据以进行回测吗？是的， /v5/market/recent-trade端点提供刻度级数据，包括每次交易的价格和数量。要构建完整的刻度历史记录，您必须连续进行轮询API或使用WebSocket流（ publicTrade主题）来捕获实时交易并存储它们。

访问私人数据时，为什么我会遇到“无效的签名”错误？当HMAC签名不匹配时，会发生此错误。确保按字母顺序正确排序参数字符串，时间戳为毫秒，并且正确输入了API秘密。还要验证HTTP方法（GET/POST）与端点的预期格式匹配。

是否可用于过期的期货合约？是的，可以通过指定合同活动期间使用的正确符号名称来访问过期期货合约的历史贸易数据。例如， BTCUSD231229用于2023年12月BTC逆期。适用相同的API端点，具有category=inverse和适当的符号。