BitMEX 交易记录查询方法有哪些
BitMEX 作为早期的加密货币衍生品交易所，曾经吸引了大量的交易者。尽管现在市场竞争激烈，仍然有不少用户在使用该平台。查询历史交易记录对于税务申报、盈亏分析、以及审计交易策略来说至关重要。本文将详细介绍 BitMEX 交易记录的查询方法，帮助用户更好地管理自己的交易数据。
一、 BitMEX 网页端查询
BitMEX 网页端提供了基础的交易记录查询功能。 虽然此功能相对简单，但对于日常查看和初步的交易分析而言已足够。 它可以让你快速了解账户的资金流动和交易行为。
- 登录 BitMEX 账户: 访问 BitMEX 官方网站，输入你的注册邮箱和密码登录你的账户。 务必确保你输入的是正确的用户名和密码，并完成任何必要的双重验证（2FA）步骤，例如 Google Authenticator 或短信验证，以提高账户安全性。 这是保护你的资金安全的重要措施。
- 进入“账户”页面: 成功登录后，在页面右上角找到并点击账户图标。 在下拉菜单中，选择“账户”（Account）或者类似的选项，这会将你带到账户管理页面。 该页面汇总了你的账户信息，包括余额、仓位以及访问交易历史的入口。
- 查找“历史记录”或“交易历史”选项: 在账户管理页面，仔细查找“历史记录”、“交易历史”、“订单历史”或者名称类似的选项。 BitMEX 页面设计可能会随时间进行更新，因此不同时间版本的页面可能会有不同的命名，但通常都比较容易找到。 留意页面上的导航栏或侧边栏，这些地方通常会包含指向交易历史的链接。
-
筛选查询条件:
进入交易历史页面后，你会看到各种筛选条件，利用这些条件可以精确地查找你需要的交易记录：
- 交易类型: 选择需要查询的具体交易类型。 常见的类型包括“交易”（Trades，即实际的开仓和平仓记录）、“存款”（Deposits，充值到 BitMEX 账户的记录）、“提款”（Withdrawals，从 BitMEX 账户提取资金的记录）和“利息”（Interest，持仓产生的利息收入或支出）。 “交易”通常指的是你在 BitMEX 平台上进行的开仓和平仓操作，这是最常用的筛选条件之一。
- 时间范围: 设置查询的时间跨度，例如“过去 7 天”、“过去 30 天”、“过去 90 天”或者“自定义时间段”等。 BitMEX 允许你选择特定的开始日期和结束日期，从而能够精确查询特定时间段内的交易记录。 使用自定义时间段可以让你回顾更长时间的历史数据，进行更深入的分析。
- 交易对: 如果你交易了多个不同的交易对，例如 BTC/USD、ETH/USD、LTC/USD 等，你可以选择特定的交易对进行筛选。 这可以帮助你专注于特定资产的交易表现。
- 其他筛选条件: 除了以上常见的筛选条件外，根据 BitMEX 平台的页面设计，可能会提供其他的筛选选项，例如订单状态（已成交、已取消、部分成交等）、订单类型（市价单、限价单等）。 这些额外的筛选条件可以帮助你更精细地定位到特定的交易行为。
- 查看和导出交易记录: 设置好所有筛选条件后，点击“搜索”或者“应用”按钮，BitMEX 平台会根据你的条件显示相应的交易记录。 你可以直接在网页上查看这些记录，每一条记录通常包含交易时间、交易对、交易方向、成交价格、成交数量、手续费等详细信息。 BitMEX 通常会提供导出交易记录的功能，最常见的格式是 CSV（逗号分隔值）格式，这种格式可以用 Excel 或其他电子表格软件打开和处理。 点击“导出”或者类似的按钮，将交易记录下载到本地电脑。 导出后的 CSV 文件可以用于进一步的数据分析、报税或者导入到交易分析工具中。
二、 使用 BitMEX API 查询
BitMEX 提供了功能全面的 API (Application Programming Interface)，它允许用户通过编程方式安全高效地访问和管理他们的账户数据，包括历史交易记录、实时订单状态、账户余额等。使用 API 查询交易记录虽然需要一定的编程基础，但相比手动操作，它能够实现更灵活、更自动化、以及可重复性的数据获取，这对于量化交易者、数据分析师以及需要集成BitMEX数据的开发者来说至关重要。
- 获取 API 密钥: 要开始使用 BitMEX API，首先需要获取有效的 API 密钥。登录你的 BitMEX 账户，导航至“API 密钥管理”页面。在此页面，创建一个新的 API 密钥对（包含API Key和API Secret）。创建密钥时，务必谨慎设置相应的权限。权限设置决定了该密钥可以执行的操作范围。为了安全起见，强烈建议只赋予API密钥读取交易记录的权限，避免不必要的账户风险，例如撤单、下单等操作。API密钥Secret务必妥善保管，切勿泄露给任何第三方。BitMEX提供了详细的权限控制，用户可以根据实际需求进行精细化配置。
-
选择编程语言和 API 客户端:
根据你的技术背景和项目需求，选择一种你熟悉的编程语言，例如 Python、Java、JavaScript、Go 等。然后，找到一个可靠且维护良好的 BitMEX API 客户端库。 这些客户端库封装了底层的 HTTP 请求细节，提供了更友好的编程接口，显著简化了 API 的使用。 Python 的
ccxt库是一个非常受欢迎的选择，它是一个统一的加密货币交易 API，支持包括 BitMEX 在内的众多加密货币交易所的 API 接口，提供了统一的数据格式和调用方式。 除了ccxt，还有一些其他的选择，例如专门为BitMEX开发的客户端库，具体选择取决于项目的具体需求和个人偏好。 -
编写代码查询交易记录:
使用选定的编程语言和 API 客户端，编写代码来查询交易记录。你需要设置 API 密钥，指定查询的时间范围、交易品种等参数。BitMEX API提供了多种查询接口，例如查询历史交易记录、查询订单状态等。 以下是一个使用 Python 和
ccxt库查询 BitMEX 交易记录的示例代码，展示了如何初始化API客户端、设置API密钥、以及调用查询交易记录接口：import ccxt
import pandas as pd
替换为您的 API 密钥和密钥
要连接到 BitMEX 交易所，您需要提供有效的 API 密钥和密钥。请在以下代码段中，将
'YOUR
API
KEY'
和
'YOUR
SECRET
KEY'
替换为您从 BitMEX 平台获取的实际凭据。请务必妥善保管您的 API 密钥和密钥，避免泄露给他人，以确保您的账户安全。API 密钥用于验证您的身份，而密钥用于对您的请求进行签名。正确的配置是访问 BitMEX API 并进行交易操作的前提。如果密钥不正确或缺失，您将无法连接到交易所并执行任何交易。
exchange = ccxt.bitmex({
'apiKey': 'YOUR
API
KEY',
'secret': 'YOUR
SECRET
KEY',
})
在 CCXT 库中，
apiKey
对应您的 API 密钥，
secret
对应您的密钥。确保替换后的字符串被正确地包含在单引号内。 如果您还没有 API 密钥，请登录您的 BitMEX 账户并前往 API 设置页面创建。创建时请务必仔细阅读 BitMEX 提供的 API 密钥权限说明，并根据您的需求设置合适的权限。例如，您可以设置只读权限，只允许 API 读取您的账户信息，而不能进行交易操作，以此来增强安全性。
设置查询参数
symbol = 'BTC/USD'
：指定要查询的交易对，本例中为比特币兑美元 (BTC/USD)。在加密货币交易所中，交易对是两种可以相互交易的资产。务必使用交易所支持的正确交易对格式。某些交易所可能使用不同的符号或名称约定，例如
BTC/USDT
或
BTC/USDC
。理解并正确设置交易对是获取准确数据的关键。
since = exchange.parse8601('2023-01-01T00:00:00Z')
：定义数据查询的起始时间点。
exchange.parse8601
函数用于将 ISO 8601 格式的时间字符串（例如 '2023-01-01T00:00:00Z'）转换为交易所 API 能够理解的时间戳（通常是 Unix 时间戳，以毫秒为单位）。设置正确的起始时间对于获取特定时间段内的数据至关重要，尤其是在进行历史数据分析时。 'Z' 表示 UTC 时间。
limit = 100
：设置单次 API 调用返回的最大数据条数。交易所通常会对每次请求返回的数据量进行限制，以防止服务器过载。
limit
参数允许您控制每次请求返回的数据量。如果需要获取大量数据，您可能需要多次调用 API，并使用
since
参数来逐步获取数据。不同的交易所对
limit
的最大值有不同的限制，需要查阅对应交易所的 API 文档。
all_trades = []
：初始化一个空列表
all_trades
，用于存储从交易所获取的所有交易数据。随着从 API 获取数据的过程，每次 API 调用返回的交易信息都将追加到这个列表中。这个列表最终将包含指定交易对和时间范围内的所有交易记录，可以用于后续的数据分析、可视化或其他目的。
循环查询交易记录
为了获取特定交易对的历史交易数据，程序通常需要循环查询交易所的API。以下代码展示了如何使用循环结构来不断请求交易数据，直到没有更多数据可用为止。
while True:
这行代码创建了一个无限循环，程序将持续执行循环体内的代码，直到遇到
break
语句才会停止。这种结构适用于我们无法预先知道需要查询多少次才能获取所有交易数据的情况。
trades = exchange.fetch_trades(symbol, since=since, limit=limit)
这行代码调用了交易所API的
fetch_trades
方法，用于获取指定交易对的交易记录。
symbol
参数指定了要查询的交易对，例如 'BTC/USD'。
since
参数指定了查询的起始时间戳，只返回晚于该时间戳的交易记录。
limit
参数限制了每次API调用返回的交易记录数量，交易所通常对每次请求的数据量有限制，因此需要设置一个合理的
limit
值。
if not trades: break
这行代码检查
fetch_trades
方法是否返回了任何交易记录。如果
trades
为空列表，表示没有更多新的交易记录了，此时使用
break
语句跳出循环，结束数据获取过程。
all_trades.extend(trades)
这行代码将本次API调用获取到的交易记录
trades
追加到
all_trades
列表中。
all_trades
列表用于存储所有已获取的交易记录，随着循环的进行，它会不断增长，最终包含完整的历史交易数据。
since = trades[-1]['timestamp'] + 1
这行代码更新
since
变量的值。
trades[-1]
获取
trades
列表中的最后一条交易记录。
['timestamp']
获取该交易记录的时间戳。 为了避免重复获取同一条交易记录，我们将时间戳加1，作为下次API调用的起始时间戳。 这样可以确保每次API调用都只返回尚未获取的新交易记录。
将交易记录转换为 Pandas DataFrame
在加密货币交易数据分析中，将原始的交易记录转换为结构化的数据格式至关重要。Pandas DataFrame 是 Python 数据分析库 Pandas 提供的核心数据结构，它以表格形式组织数据，方便进行数据清洗、转换、分析和可视化。
交易记录通常以列表或字典等非结构化形式存在，难以直接进行分析。因此，需要将其转换为 Pandas DataFrame。假设
all_trades
是一个包含交易记录的列表，每个元素代表一笔交易，可以是字典或其他自定义对象，包含诸如交易时间、交易对、买卖方向、成交价格、成交数量等信息。
可以使用以下代码将
all_trades
转换为 Pandas DataFrame：
df = pd.DataFrame(all_trades)
这行代码利用
pd.DataFrame()
函数，将
all_trades
列表直接转换为 DataFrame。Pandas 会自动识别
all_trades
中每个元素的键或属性，并将其作为 DataFrame 的列名。如果
all_trades
中的元素是字典，则字典的键将成为列名。如果
all_trades
中的元素是自定义对象，则对象的属性将成为列名。如果数据结构不规则，DataFrame可能会出现缺失值（NaN）。
转换完成后，
df
就是一个包含所有交易记录的 Pandas DataFrame。可以利用 Pandas 提供的丰富功能，对交易数据进行深入分析，例如计算交易量、盈利情况、风险指标等。
打印交易记录
在Python中，利用pandas库处理加密货币交易数据时，`print(df)` 函数用于在控制台或终端中显示DataFrame `df` 的内容，其中`df`通常存储着从交易所API获取或本地导入的交易记录。此命令能够快速查看DataFrame的结构，包含列名（如交易时间、交易对、买/卖方向、成交价格、成交数量、手续费等）和前几行数据，便于初步的数据检查和验证。
更具体地，`print(df)` 实际上调用了DataFrame对象的`__str__` 方法，该方法生成一个易于阅读的表格形式的字符串表示。默认情况下，pandas会显示DataFrame的前后几行，中间省略部分用省略号表示。然而，通过调整pandas的显示选项，可以控制显示的行数和列数。例如，`pd.set_option('display.max_rows', None)` 可以设置显示所有行，`pd.set_option('display.max_columns', None)` 可以设置显示所有列。还可以使用`df.head(n)` 显示前n行，`df.tail(n)` 显示后n行，或`df.sample(n)` 随机显示n行，以便更灵活地查看数据。
打印交易记录对于调试代码、理解数据结构、以及初步分析交易行为至关重要。例如，可以通过`print(df)` 检查从交易所API接收到的数据是否符合预期格式，确认交易时间戳是否正确，验证买卖方向是否准确，并快速了解交易量的大小。在进一步的数据清洗、转换和分析之前，打印交易记录是必不可少的步骤，能够帮助开发者确保数据的准确性和完整性。
将交易记录保存到 CSV 文件
df.to_csv('bitmex_trades.csv', index=False)
这段代码展示了如何使用 Python 将从加密货币交易所（例如 BitMEX）获取的交易历史数据保存到 CSV 文件中。需要初始化一个 BitMEX 交易所对象，这通常涉及到配置 API 密钥和密钥，以便程序能够安全地访问你的交易账户数据。随后，设置查询参数至关重要，例如指定交易对（例如 BTC/USD 或 ETH/USD），定义数据查询的起始时间，以及设置每次 API 请求所能获取的最大交易记录数量。这些参数控制了数据抓取的范围和效率。
接下来，代码会进入一个循环，不断地向 BitMEX 的 API 发送请求，获取交易记录。由于交易所通常会对每次 API 请求返回的数据量进行限制，因此需要循环地进行分页查询，直到获取到所有满足条件的交易记录为止。循环的退出条件通常是 API 返回的交易记录为空，表示已经到达了交易历史的终点。
当所有交易记录都被成功获取后，代码会将这些数据转换为 Pandas DataFrame 对象。Pandas 是一个强大的数据分析库，DataFrame 是 Pandas 中用于存储表格数据的一种数据结构，非常适合处理交易数据。DataFrame 提供了丰富的函数，可以方便地对数据进行清洗、转换和分析。
df.to_csv('bitmex_trades.csv', index=False)
这行代码会将 DataFrame 中的数据保存到名为 'bitmex_trades.csv' 的 CSV 文件中。
index=False
参数表示不将 DataFrame 的索引列写入 CSV 文件，这通常是我们期望的行为。
运行你编写的代码，程序会将查询到的交易记录保存到 CSV 文件中。你可以使用诸如 Microsoft Excel、Google Sheets 或者其他电子表格软件打开 CSV 文件，以便查看和分析你的交易数据。这些数据可以用于各种目的，例如计算盈亏、分析交易策略的有效性、或者进行技术分析。
三、 使用第三方交易记录分析工具
专业的加密货币交易者通常会借助第三方工具和服务来深入分析其交易记录，尤其是在像 BitMEX 这样的交易所。这些工具超越了交易所提供的基础数据，提供了更高级的功能，例如详细的盈亏分析、复杂税务计算、全面的风险管理、以及自定义报告生成，帮助用户更好地理解其交易行为并优化策略。
-
选择合适的第三方工具：
选择合适的工具至关重要。在做出决定之前，请务必仔细评估以下关键因素：
- 安全性： 安全性是首要考虑因素。确保该工具拥有强大的安全基础设施，包括数据加密、双因素认证等，以最大限度地保护您的 API 密钥和敏感交易数据，防止未经授权的访问。仔细研究该工具的安全协议和隐私政策。
- 功能： 不同的工具提供的功能范围不同。选择一个提供您所需的特定功能的工具。例如，如果您需要详细的税务报告，请选择一个提供税务计算和报告生成功能的工具。如果您需要跟踪止损单和风险敞口，请选择一个提供风险管理功能的工具。确保该工具能够满足您当前和未来的需求。
- 价格： 第三方工具的价格模式各异，包括订阅模式、按交易量收费模式等。比较不同工具的价格和功能，选择一个在您的预算范围内提供最佳价值的工具。有些工具可能提供免费试用版，让您有机会在购买之前体验其功能。
- 信誉： 选择一个在加密货币社区中拥有良好声誉的工具。阅读用户评论、查看在线论坛、咨询其他交易者，了解该工具的可靠性、客户支持质量和整体用户体验。避免选择声誉不佳或缺乏透明度的工具。
- 支持的交易所： 确保该工具支持 BitMEX 以及您使用的其他交易所。某些工具可能只支持有限数量的交易所，因此在选择之前务必进行核实。
- 数据准确性： 选择一个提供准确且可靠数据的工具。数据质量直接影响分析结果的有效性。了解该工具如何获取和验证数据，确保数据的准确性和完整性。
-
连接 BitMEX 账户：
按照第三方工具提供的详细说明，将您的 BitMEX 账户安全地连接到该工具。通常，这需要您提供您的 API 密钥。
- 生成 API 密钥： 在 BitMEX 交易所生成 API 密钥时，务必仔细设置权限。只授予该工具所需的最低权限，例如只读权限或交易权限，以降低潜在的安全风险。切勿共享您的 API 密钥或将其存储在不安全的地方。
- API 密钥管理： 安全地存储和管理您的 API 密钥。考虑使用密码管理器或硬件钱包来保护您的 API 密钥。定期审查和更新您的 API 密钥，以确保安全性。
- 断开连接： 如果您不再使用该工具，请务必从 BitMEX 交易所撤销该工具的 API 密钥，以防止未经授权的访问。
-
分析交易记录：
成功连接后，第三方工具会自动同步您的 BitMEX 交易记录，并生成各种详细的分析报告。
- 盈亏分析： 分析您的盈利和亏损，了解哪些策略有效，哪些策略需要改进。查看按交易对、时间段和交易类型划分的盈亏报告。
- 税务计算： 根据您的交易记录自动计算您的加密货币税务义务。生成税务报告，方便您向税务机关申报。
- 风险管理： 监控您的风险敞口、止损单和杠杆水平，以避免过度承担风险。设置风险警报，及时了解潜在的风险事件。
- 自定义报告： 根据您的特定需求，创建自定义报告，分析您关注的特定指标。
- 数据可视化： 利用图表和图形等数据可视化工具，更直观地了解您的交易表现。
四、 注意事项
- API 密钥安全: 请务必妥善保管你的 API 密钥，切勿泄露给任何第三方。考虑到安全风险，强烈建议仅为API密钥分配必要的权限，例如只赋予读取交易历史的权限。限制API密钥的权限范围，可以有效降低潜在的安全漏洞被利用的风险。定期轮换API密钥，并启用两步验证等安全措施，进一步提升账户安全性。
- 数据准确性: 在不同的查询方法中，返回的数据结果可能会存在细微差异，这可能由于数据同步延迟、API接口版本差异、或者查询参数设置等原因引起。为了确保数据的准确性，建议采用多种查询方法进行交叉验证。比对不同来源的数据，能帮助你识别和纠正潜在的偏差，从而获得更可靠的交易记录信息。请注意各交易所API文档中关于数据精度和时间戳的说明。
- 数据备份: 务必定期备份你的交易记录，以避免因硬件故障、人为失误、或平台意外情况导致的数据丢失。可以将交易记录导出为CSV、Excel或其他通用格式，并存储在多个安全位置，例如本地硬盘、云存储服务、或其他安全设备。建立完善的备份策略，确保数据安全可恢复。
- 隐私保护: 务必谨慎保护你的个人隐私。不要将你的交易记录分享给任何未经授权的个人或机构。加密货币交易虽然在一定程度上具有匿名性，但你的交易活动仍然可能被追踪。保护好你的账户信息、API密钥、以及交易数据，防止信息泄露造成不必要的损失。
- 税务合规: 请务必根据你所在国家或地区的法律法规，及时申报你的加密货币交易所得税。了解当地的税务政策，并咨询专业的税务顾问，确保你的税务申报符合相关规定。妥善保存你的交易记录，以便于税务审计和申报。加密货币税务政策复杂多变，及时了解最新政策动态至关重要。
通过上述方法，你可以便捷地查询、管理和分析你的BitMEX交易记录，从而更深入地了解你的交易表现，并以此为基础做出更加明智的交易决策。合理利用这些信息，能帮助你优化交易策略，提高交易效率，并更好地控制风险。同时，持续关注市场动态，不断学习和实践，是提升交易水平的关键。
