BitMEX交易历史查询指南：轻松掌握数字资产轨迹
BitMEX 交易历史查询完全指南：掌握你的数字资产轨迹
BitMEX 作为一家老牌的加密货币衍生品交易所，一直备受交易者们的青睐。对于很多用户来说，深入了解并分析自己在 BitMEX 上的交易历史至关重要，这不仅能帮助他们复盘交易策略，找出盈利或亏损的原因，还能有效进行税务申报。本文将深入剖析在 BitMEX 上查看个人交易历史的各种方法，并提供详细的操作步骤，助你轻松掌握自己的数字资产轨迹。
方法一：通过 BitMEX 网站查询交易历史
这是用户常用的方法，它提供了一个直接且用户友好的方式来访问详细的交易记录。BitMEX 平台允许用户在其官方网站上便捷地查看并导出他们的交易历史数据，用户可以根据自身需求，灵活地设置时间范围和筛选特定交易类型，从而精准地获取所需信息。
用户可以通过以下步骤在 BitMEX 网站上查询交易历史：
登录你的 BitMEX 账户： 首先，打开 BitMEX 官方网站 (www.bitmex.com)，输入你的用户名和密码，确保已开启双重验证 (2FA)，提高账户安全性。- 时间范围： 可以选择预设的时间范围，例如“过去 7 天”、“过去 30 天”、“本月”、“上月”等，也可以自定义起始日期和结束日期。
- 交易类型： 可以选择特定的交易类型，例如“全部”、“交易”、“存款”、“提款”、“奖励”、“清算”等。
- 合约： 可以选择特定的合约类型，例如“XBTUSD”、“ETHUSD”等。
- 订单 ID： 如果你知道特定的订单 ID，可以直接输入进行搜索。
- 时间： 交易发生的具体时间。
- 合约： 交易的合约类型。
- 类型： 交易的类型，例如“市价单”、“限价单”、“止损单”等。
- 数量： 交易的数量。
- 价格： 交易的价格。
- 费用： 交易产生的费用。
- 盈亏： 交易的盈亏情况。
你可以点击表格中的每一条记录，查看更详细的交易信息。此外，你还可以点击页面右上角的“导出”按钮，将你的交易历史导出为 CSV 文件，方便你进行进一步的分析。
方法二：通过 BitMEX API 查询交易历史
对于具备编程基础的用户，使用 BitMEX API 查询交易历史提供了一种更加灵活和高效的途径。BitMEX API 允许用户以编程方式访问平台数据，实现自动化交易和数据分析。相比手动下载，API 提供了更精细的控制和更高的效率，特别适用于需要频繁获取和处理交易数据的场景。通过API，你可以自动化地获取交易数据，并将其集成到你的交易工具、量化交易策略或个人分析平台中，极大地提升数据处理效率和分析能力。
获取 BitMEX API 密钥： 首先，你需要在 BitMEX 账户中生成 API 密钥。进入你的账户页面，点击“API”选项卡，然后点击“生成 API 密钥”按钮。你需要设置 API 密钥的权限，例如“交易”、“提取”等。请务必妥善保管你的 API 密钥，不要泄露给他人。requests 库或 bitmex-python 库。/api/v1/order：用于获取你的订单历史。/api/v1/execution：用于获取你的成交历史。/api/v1/position：用于获取你的持仓信息。
你需要根据你的需求选择合适的 API 端点，并设置相应的参数，例如 symbol (合约类型)、startTime (起始时间)、endTime (结束时间) 等。
使用 API 查询交易历史的示例 (Python)：
使用 API 查询交易历史通常涉及向交易所或区块链数据提供商发送身份验证请求，并解析返回的数据。以下是一个使用 Python 和 `requests` 库的示例，展示了如何进行身份验证并查询交易历史，该示例模拟了需要 API 密钥和密钥签名进行身份验证的场景：
import requests
import hashlib
import hmac
import time
import
# 替换为你的 API 密钥和私钥
api_key = 'YOUR_API_KEY'
secret_key = 'YOUR_SECRET_KEY'
# API 端点
base_url = 'https://api.example.com' # 替换为实际的 API 地址
endpoint = '/api/v1/user/transactions' # 替换为实际的交易历史端点
# 创建时间戳
timestamp = str(int(time.time()))
# 构建请求参数 (根据 API 文档进行调整)
params = {
'timestamp': timestamp,
'limit': 100, # 请求的交易数量限制
'offset': 0 # 分页偏移量
}
# 对请求参数进行签名
def generate_signature(secret_key, data):
message = '&'.join([f'{k}={v}' for k, v in data.items()])
message = message.encode('utf-8')
secret = secret_key.encode('utf-8')
signature = hmac.new(secret, message, hashlib.sha256).hexdigest()
return signature
signature = generate_signature(secret_key, params)
# 构建请求头
headers = {
'X-API-Key': api_key,
'X-API-Signature': signature,
'X-API-Timestamp': timestamp
}
# 发送 GET 请求
try:
response = requests.get(base_url + endpoint, headers=headers, params=params)
response.raise_for_status() # 检查请求是否成功
# 解析 JSON 响应
transactions = response.()
# 处理交易数据
for transaction in transactions['data']:
print(f"Transaction ID: {transaction['transaction_id']}")
print(f"Amount: {transaction['amount']}")
print(f"Currency: {transaction['currency']}")
print(f"Type: {transaction['type']}")
print(f"Timestamp: {transaction['timestamp']}")
print("-" * 20)
except requests.exceptions.RequestException as e:
print(f"请求出错: {e}")
except .JSONDecodeError as e:
print(f"JSON 解析出错: {e}")
except KeyError as e:
print(f"KeyError: {e}. 响应数据结构可能不符合预期。")
代码解释：
- 导入必要的库： `requests` 用于发送 HTTP 请求，`hashlib` 和 `hmac` 用于生成签名， `time` 用于生成时间戳，`` 用于解析API返回的数据。
- 设置 API 密钥和私钥： 将 `YOUR_API_KEY` 和 `YOUR_SECRET_KEY` 替换为你的实际密钥。 这些密钥通常在交易所或数据提供商的开发者控制台中找到。
- 定义 API 端点： `base_url` 是 API 的基本 URL，`endpoint` 是交易历史记录的特定端点。请查阅相关 API 文档以获取正确的 URL。
- 生成时间戳： 时间戳用于防止重放攻击。大多数 API 要求在请求中包含时间戳。
- 构建请求参数： `params` 字典包含要发送到 API 的任何参数，例如时间戳、交易数量限制和分页偏移量。根据API的要求定制参数。
- 生成签名： `generate_signature` 函数使用你的私钥对请求参数进行哈希处理，以创建一个唯一的签名。签名用于验证请求的完整性。具体的签名算法和参数顺序必须严格按照API文档进行。
- 构建请求头： `headers` 字典包含 API 密钥、签名和时间戳。这些头部用于向 API 进行身份验证。
- 发送 GET 请求： 使用 `requests.get()` 函数将请求发送到 API 端点。
- 处理响应： 如果请求成功，API 将返回一个包含交易历史记录的 JSON 响应。使用 `response.()` 函数解析 JSON 响应，然后遍历交易数据并打印相关信息。 需要根据API文档确定数据的结构，提取具体的交易信息，例如：交易ID、金额、货币类型、交易类型和时间戳。
- 错误处理： 使用 `try...except` 块处理可能发生的任何错误，例如网络错误、JSON 解析错误或API返回的错误代码。 常见的异常包括 `requests.exceptions.RequestException` (网络错误)，`.JSONDecodeError` (JSON解析错误) 和 `KeyError` (响应数据结构不符合预期)。对于不同的错误，应该给出合适的提示信息，方便调试。
重要注意事项：
- 安全性： 永远不要在客户端代码中硬编码你的 API 密钥和私钥。 将它们存储在安全的地方，例如环境变量或配置文件中。
- 速率限制： API 通常有速率限制，以防止滥用。 确保你遵守 API 的速率限制，并在必要时实施重试逻辑。
- API 文档： 仔细阅读你正在使用的 API 的文档。不同的 API 可能有不同的身份验证方法、请求参数和响应格式。
- 错误处理： 实现完善的错误处理机制，以处理 API 返回的任何错误。
- 数据验证： 验证 API 返回的数据，以确保其准确性和完整性。
API 密钥
API 密钥是访问交易所或加密货币服务应用程序编程接口 (API) 的凭证。 它用于验证您的身份并授权您访问受保护的资源。 通常，您需要一对密钥：一个 API 密钥（也称为“公钥”）和一个 API 密钥密钥（也称为“私钥”）。
API 密钥的格式通常如下所示：
api_key = 'YOUR_API_KEY'
api_secret = 'YOUR_API_SECRET'
API 密钥 (
api_key
):
这是一个公开的标识符，用于识别您的账户。您可以与其他人分享，但务必小心，不要泄露您的 API 密钥密钥。
API 密钥密钥 (
api_secret
):
这是一个私有的、保密的密钥，类似于密码。 绝对不要与任何人分享您的 API 密钥密钥。如果您的 API 密钥密钥泄露，其他人可以使用它来访问您的账户并执行未经授权的操作。
重要安全提示：
- 保管好您的 API 密钥密钥： 将其视为密码一样安全地存储。
- 不要在客户端代码中存储 API 密钥： 这会将它们暴露给未经授权的用户。
- 使用环境变量存储 API 密钥： 这样可以更安全地管理它们。
- 定期轮换您的 API 密钥： 许多交易所允许您生成新的 API 密钥对。
- 限制 API 密钥的权限： 仅授予 API 密钥执行所需操作的权限。例如，如果您只需要读取市场数据，则不要授予提款权限。
- 监控 API 密钥的使用情况： 留意任何可疑活动。
不同的交易所或服务提供商获取 API 密钥的方式可能不同。 通常，您需要在其网站上注册一个账户，然后在账户设置或 API 管理部分生成 API 密钥。 生成 API 密钥时，请务必仔细阅读服务条款和条件。
BitMEX API 域名
BitMEX API 的访问入口点由其域名定义，这是与 BitMEX 服务器建立连接并进行数据交互的基础。选择正确的域名至关重要，因为它决定了你将连接到哪个环境（例如，真实交易或测试）。
正式环境域名：
base_url = 'https://www.bitmex.com'
此 URL 指向 BitMEX 的正式交易平台。使用此域名进行实盘交易，你需要拥有一个有效的 BitMEX 账户并已完成必要的身份验证流程。
测试环境域名（Testnet）：
为了方便开发者进行测试和实验，BitMEX 提供了测试环境（Testnet）。Testnet 允许你在不冒真实资金风险的情况下，模拟交易行为并测试你的 API 集成。
base_url = 'https://testnet.bitmex.com'
请注意，Testnet 环境使用独立的 API 密钥和资金（测试币）。你在正式环境中使用的 API 密钥在 Testnet 中无效，反之亦然。
域名选择的重要性：
务必根据你的需求选择正确的域名。使用错误的域名可能导致连接失败、数据错误或在不希望的环境中执行交易。
其他注意事项：
- 在生产环境中，始终使用 HTTPS 协议以确保数据传输的安全性。
- 定期检查 BitMEX 官方文档，以获取最新的 API 域名和任何可能的更新或更改。
- 在开发和测试阶段，强烈建议使用 Testnet 环境。
API 端点
API 端点
/api/v1/order
用于访问和操作订单相关资源。 该端点支持多种 HTTP 方法，例如 GET、POST、PUT 和 DELETE，具体取决于要执行的操作。
使用 GET 方法可以检索订单信息。 您可以使用查询参数来过滤和排序结果，例如按订单 ID、客户 ID 或创建日期进行筛选。 返回的数据通常是 JSON 格式，包含订单的详细信息，例如订单状态、商品列表、总金额和送货地址。
使用 POST 方法可以创建新的订单。 请求体应包含必要的订单信息，例如客户 ID、商品列表和付款信息。 服务器将验证请求数据并创建新的订单记录。 成功创建后，服务器通常会返回新创建订单的 ID。
使用 PUT 方法可以更新现有订单的信息。 您需要提供要更新的订单的 ID，并在请求体中包含要更新的字段及其新值。 服务器将验证请求数据并更新订单记录。 并非所有字段都可以更新，具体取决于订单状态和业务逻辑。
使用 DELETE 方法可以删除订单。 您需要提供要删除的订单的 ID。 删除操作通常需要管理员权限或满足特定的业务条件才能执行。 删除订单可能会影响相关的数据，例如库存和财务记录，因此需要谨慎操作。
请注意，API 端点
/api/v1/order
可能需要身份验证和授权才能访问。 您需要提供有效的 API 密钥或访问令牌才能访问该端点。 具体的身份验证和授权机制取决于 API 的实现方式。
为了保证数据传输的安全性，建议使用 HTTPS 协议来访问 API 端点。 HTTPS 使用 SSL/TLS 加密来保护数据在客户端和服务器之间的传输，防止数据被窃取或篡改。
请求参数
在进行API数据请求时，需要构建包含特定参数的请求体（通常为JSON格式），以便服务器能够准确地理解和处理你的请求。以下示例展示了一个用于获取交易历史数据的参数集合，适用于如加密货币交易所等平台。
params
字典包含了所有必要的参数：
-
symbol: 交易对代码，指定你希望获取数据的交易品种。在本例中，'XBTUSD'代表比特币兑美元的永续合约。不同的交易所或平台可能使用不同的代码表示同一交易对，请务必查阅相关API文档以获取正确的代码。 -
startTime: 数据起始时间，定义你希望获取数据的最早时间点。时间格式必须符合ISO 8601标准，例如'2023-01-01T00:00:00.000Z'，表示UTC时间的2023年1月1日零点。确保时间戳的准确性，否则可能无法获取有效数据。 -
endTime: 数据结束时间，定义你希望获取数据的最晚时间点。同样需要使用ISO 8601标准的时间格式，例如'2023-01-31T00:00:00.000Z'，表示UTC时间的2023年1月31日零点。结束时间必须晚于起始时间。 -
count: 请求的数据条数上限，控制单次API请求返回的数据量。在本例中，500表示最多获取500条记录。不同的API对单次请求的数据量可能有不同的限制，需要根据实际情况调整。过大的请求量可能导致服务器拒绝请求或返回不完整的数据。请注意，实际返回的数据条数可能小于count，这取决于指定时间范围内实际发生的交易数量。
这些参数需要以特定的格式传递给API接口，具体方式取决于API的设计。常见的做法是将这些参数构建成JSON对象，并通过HTTP POST或GET请求发送给服务器。发送请求时，还需要考虑身份验证和授权等问题，确保你有权限访问相关数据。
生成 API 签名
为了安全地调用 API 接口，你需要生成一个签名。签名过程涉及多个步骤，确保请求的完整性和真实性。以下是签名生成的详细步骤和代码示例，以 Python 为例进行说明。
1. 设置过期时间 (expires):
expires = int(round(time.time()) + 60)
设置请求的过期时间，通常是当前时间加上一个短暂的有效期（例如60秒）。这有助于防止重放攻击。
time.time()
返回当前时间的时间戳（秒），
round()
函数对其进行四舍五入，并转换为整数类型。 过期时间是签名的一部分，确保请求在指定时间后失效。
2. 准备请求参数 (params):
假设你有一个字典
params
包含了所有需要传递的请求参数。例如：
params = {'symbol': 'BTCUSDT', 'side': 'BUY', 'quantity': 1, 'price': 30000}
3. 格式化参数字符串 (data):
data = ''.join(f'{k}{v}' for k, v in sorted(params.items()))
将所有请求参数按照键（key）的字母顺序排序，并将键和值连接成一个字符串。排序是必要的，以确保相同的参数集合总是生成相同的签名。 使用 f-string 可以方便地格式化字符串，将键和值连接起来。
sorted(params.items())
返回一个排序后的键值对列表，然后使用
''.join()
将它们连接成一个字符串。
4. 构建消息 (message):
message = 'GET' + endpoint + '?' + data + str(expires)
构建用于生成签名的完整消息。消息由以下部分组成：
- HTTP 方法（例如：GET, POST, PUT, DELETE， 这里假设是GET）
-
API 接口的端点 (
endpoint)，例如：/api/v1/order - 问号 (?)
-
格式化后的参数字符串 (
data) -
过期时间 (
expires)，需要转换为字符串类型
将这些部分连接起来形成最终的消息字符串。
5. 生成签名 (signature):
signature = hmac.new(api_secret.encode('utf-8'), message.encode('utf-8'), hashlib.sha256).hexdigest()
使用 HMAC-SHA256 算法对消息进行哈希处理，生成签名。
hmac.new()
函数需要三个参数：
-
你的 API Secret (
api_secret)，需要使用 UTF-8 编码 -
待签名的消息 (
message)，同样需要使用 UTF-8 编码 -
哈希算法，这里使用
hashlib.sha256
hexdigest()
方法将哈希结果转换为十六进制字符串，这就是最终的签名。
示例代码：
import time
import hmac
import hashlib
from urllib.parse import urlencode
api_secret = 'YOUR_API_SECRET'
endpoint = '/api/v1/order'
params = {'symbol': 'BTCUSDT', 'side': 'BUY', 'quantity': 1, 'price': 30000}
expires = int(round(time.time()) + 60)
data = ''.join(f'{k}{v}' for k, v in sorted(params.items()))
message = 'GET' + endpoint + '?' + data + str(expires)
signature = hmac.new(api_secret.encode('utf-8'), message.encode('utf-8'), hashlib.sha256).hexdigest()
print(f"Expires: {expires}")
print(f"Signature: {signature}")
# 构建完整的 URL，包含签名和过期时间
url = f"{endpoint}?{urlencode(params)}&expires={expires}&signature={signature}"
print(f"完整URL: {url}")
请务必妥善保管你的
api_secret
，避免泄露。在实际应用中，根据 API 的具体要求调整 HTTP 方法和端点。
设置HTTP请求头
在与API交互时，正确设置HTTP请求头至关重要。请求头包含了关于请求本身的元数据，例如请求内容的类型、授权信息以及其他必要的参数。
以下是一个用于构建HTTP请求头的示例，它包含了几个常见的自定义头部字段：
headers = {
'Content-Type': 'application/',
'api-key': api_key,
'api-signature': signature,
'api-expires': str(expires)
}
Content-Type:
Content-Type
头部字段用于指定请求体的MIME类型。在这里，
application/
表示请求体包含JSON格式的数据。根据API的要求，还可以设置为
application/x-www-form-urlencoded
或
multipart/form-data
等。
api-key:
api-key
头部字段用于传递API密钥，它是身份验证的一种常见方式。API密钥用于标识发出请求的用户或应用程序。请务必妥善保管您的API密钥，避免泄露。
api-signature:
api-signature
头部字段用于传递API签名，用于验证请求的完整性和真实性。签名通常是通过对请求参数、时间戳和密钥进行哈希运算生成的。这有助于防止请求被篡改。
api-expires:
api-expires
头部字段用于传递请求的过期时间戳。时间戳表示请求的有效截止时间，超过该时间后，请求将被视为无效。这有助于防止重放攻击。
注意：
上述头部字段名称和含义仅为示例，实际使用时请参考API文档，根据API的具体要求进行设置。有些API可能需要其他的自定义头部字段，例如
X-Request-ID
用于跟踪请求。
发送 GET 请求
构建 URL: GET 请求通过在 URL 中附加参数来传递数据。将基本 URL 与特定端点连接起来，构成请求的基础地址。随后，将查询字符串添加到 URL 中，查询字符串由参数名、等号和参数值组成，多个参数之间用 & 符号分隔。完整的 URL 格式如下：
url = base_url + endpoint + '?' + data
例如，如果
base_url
是 "https://api.example.com"，
endpoint
是 "/users"，并且
data
是 "name=John&age=30"，那么完整的 URL 将是 "https://api.example.com/users?name=John&age=30"。
发送请求:
使用 Python 的
requests
库可以轻松发送 GET 请求。
requests.get()
函数接受 URL 和可选的请求头作为参数。请求头可以用于指定内容类型、身份验证令牌或其他元数据。
response = requests.get(url, headers=headers)
response
对象包含服务器的响应数据，例如状态码、响应头和响应正文。可以使用
response.status_code
访问状态码，使用
response.headers
访问响应头，使用
response.text
或
response.()
访问响应正文。
示例:
import requests
base_url = "https://api.example.com"
endpoint = "/users"
data = "name=John&age=30"
headers = {"Content-Type": "application/"}
url = base_url + endpoint + '?' + data
response = requests.get(url, headers=headers)
if response.status_code == 200:
print("请求成功")
print(response.()) # 将 JSON 响应解析为 Python 字典
else:
print("请求失败，状态码:", response.status_code)
此示例展示了如何使用
requests
库构建和发送一个简单的 GET 请求，以及如何处理服务器的响应。请注意，实际的 API 端点、参数和请求头将取决于具体的 API 文档。
处理响应
接收到来自BitMEX API的HTTP响应后，验证响应状态至关重要。
response.status_code == 200
指示请求成功完成。在此情况下，服务器返回了预期的数据。随后，使用
response.()
方法将JSON格式的响应体解析为Python字典或列表，以便进一步处理。
.dumps(orders, indent=4)
用于以易于阅读的格式打印解析后的数据，其中
indent=4
参数使JSON数据具有四空格缩进，提高可读性。这对于调试和理解API返回的数据结构非常有用。
如果
response.status_code
不是200，则表示请求失败。常见的错误状态码包括400（错误请求）、401（未授权）、403（禁止访问）和500（服务器内部错误）。打印
response.status_code
和
response.text
有助于诊断问题。
response.text
通常包含错误消息，提供关于失败原因的更多信息。例如，它可能指示无效的API密钥、缺少必需的参数或超出速率限制。务必根据返回的错误信息调整请求。
实际应用中，需要根据BitMEX API的具体端点和返回的数据结构来调整代码。BitMEX API文档提供了每个端点的详细信息，包括请求参数、响应格式、错误代码和速率限制。仔细阅读文档对于有效使用API至关重要。考虑实施错误处理和重试机制，以应对网络问题或API临时不可用。对于生产环境，建议使用更健壮的日志记录和监控系统，以便跟踪API使用情况并及时发现潜在问题。
注意事项：
- 账户安全： 务必高度重视你的 BitMEX 账户安全。立即启用双重验证 (2FA)，这可以显著提高账户的安全性，防止未经授权的访问。同时，请将你的 API 密钥视为最高机密，切勿泄露给任何人。API 密钥一旦泄露，可能导致你的账户被恶意操控，造成无法挽回的损失。定期更换 API 密钥也是一个良好的安全习惯。
- API 限制： BitMEX API 设有速率限制，旨在维护平台的稳定性和公平性。请务必仔细阅读 BitMEX 官方文档，了解具体的速率限制规则。合理规划你的 API 请求频率，避免超出限制。超出速率限制可能导致你的 API 访问被暂时或永久阻止。可以使用错误处理机制来优雅地处理速率限制错误，例如，使用指数退避算法进行重试。
- 数据准确性： 虽然 BitMEX 致力于提供准确可靠的数据，但由于市场波动和技术故障等因素，仍然可能存在数据误差。务必仔细核对你的交易历史，特别是交易价格、数量和时间等关键信息。如果你发现任何异常或不一致之处，请立即联系 BitMEX 客服，提供详细的交易信息和截图，以便他们进行调查和处理。请注意，交易历史的最终记录以 BitMEX 官方数据为准。
- 税务申报： 加密货币交易产生的收益可能需要纳税，具体规定因你所在的司法管辖区而异。请务必了解你所在地区的加密货币税务法规，并咨询专业的税务顾问，以确保你的税务申报符合法律要求。妥善保存你的交易记录，包括交易时间、价格、数量和交易对手等信息，以便进行税务申报。不同国家和地区对加密货币的税务处理方式差异很大，务必谨慎对待。
- 历史数据限制: BitMEX 可能会对通过网页端或者API直接访问的历史数据长度施加限制，这是为了优化平台性能和存储成本。如果你需要访问更早的历史数据，例如用于回溯测试或策略分析，可能需要联系 BitMEX 客服，询问是否有其他途径获取。也可以考虑使用第三方数据服务提供商，他们通常会提供更全面的历史数据，但可能需要付费。在选择第三方数据服务时，务必注意其数据质量和可靠性。
通过掌握以上注意事项，你可以更安全、高效地查询你在 BitMEX 上的交易历史，从而更好地管理你的数字资产。请记住，定期审查你的交易记录，并结合市场分析，不断优化你的交易策略，这是在竞争激烈的加密货币市场中取得成功的关键要素。同时，持续学习和适应市场变化，也是至关重要的。