BitMEX历史交易、结算和资金记录查看指南

• 时间戳： 交易执行的具体时间。
• 交易对： 你交易的合约类型（例如 XBTUSD）。
• 买/卖： 指明是买入（做多）还是卖出（做空）。
• 数量： 交易的合约数量。
• 价格： 交易执行的价格。
• 费用： 交易产生的交易费用。
• 委托单ID： 唯一标识该笔交易的委托单 ID。
• 委托单类型：例如市价单、限价单等。

示例 Python 代码：

import requests import hashlib import hmac import time import

api_key = "YOUR_API_KEY" api_secret = "YOUR_API_SECRET"

def generate_signature(api_secret, method, path, data, expires): """生成 API 签名。 该函数使用 HMAC-SHA256 算法，根据 API 密钥、HTTP 方法、请求路径、请求数据和过期时间生成数字签名。 签名用于验证请求的真实性和完整性。 """ nonce = expires message = method + path + str(nonce) + data signature = hmac.new(api_secret.encode('utf-8'), message.encode('utf-8'), digestmod=hashlib.sha256).hexdigest() return signature

def get_trade_history(symbol, startTime, endTime): """从 BitMEX 获取交易历史记录。 该函数通过调用 BitMEX API 的 `/api/v1/execution/tradeHistory` 端点，检索指定交易对在指定时间范围内的交易历史记录。 它使用 API 密钥和签名对请求进行身份验证。 """ method = "GET" path = "/api/v1/execution/tradeHistory" expires = int(time.time()) + 60 # 签名在 60 秒后过期 data = "" signature = generate_signature(api_secret, method, path, data, expires)

headers = {
    "Content-Type": "application/",
    "api-key": api_key,
    "api-signature": signature,
    "api-expires": str(expires)
}

params = {
    "symbol": symbol,
    "startTime": startTime,
    "endTime": endTime
}

url = "https://www.bitmex.com" + path  # 确保使用正确的BitMEX域名

try:
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()  # 检查 HTTP 错误

    if response.status_code == 200:
        try:
            return response.()
        except .JSONDecodeError as e:
            print(f"JSON 解码错误: {e}")
            return None
    else:
        print(f"Error: {response.status_code} - {response.text}")
        return None
except requests.exceptions.RequestException as e:
    print(f"请求错误: {e}")
    return None

示例用法

以下代码展示了如何使用函数获取指定交易对在特定时间范围内的交易历史。请务必替换示例中的参数值为您实际需要查询的数据。

symbol = "XBTUSD"
startTime = "2023-01-01T00:00:00.000Z"
endTime = "2023-01-07T00:00:00.000Z"

上述代码段定义了三个关键变量： symbol 代表交易对的名称，例如 "XBTUSD" (比特币/美元永续合约)。 startTime 和 endTime 分别代表查询交易历史的起始时间和结束时间，时间格式为ISO 8601，务必精确到毫秒。

trade_history = get_trade_history(symbol, startTime, endTime)

此行代码调用名为 get_trade_history 的函数，并将交易对名称、起始时间和结束时间作为参数传递给该函数。该函数会返回一个包含所有符合条件的交易记录的列表，并将其赋值给变量 trade_history 。

if trade_history:
for trade in trade_history:
print(trade)

这段代码首先检查 trade_history 列表是否为空。如果列表不为空，则使用 for 循环遍历列表中的每一条交易记录（ trade ），并使用 print() 函数将每一条交易记录打印到控制台。每一条交易记录通常会包含交易时间、交易价格、交易数量、交易方向等详细信息，具体取决于 get_trade_history 函数的实现方式。

请注意： 上述 Python 代码片段仅为示例，用于演示如何通过 BitMEX API 获取交易历史和结算记录。实际应用中，务必参考 BitMEX 官方 API 文档，进行精确调整，以适应 API 版本更新和功能变化。 务必高度重视 API 密钥 (API Key) 和密钥 (Secret) 的安全。 密钥泄露可能导致资金损失或账户被盗用。 切记将示例代码中的 YOUR_API_KEY 和 YOUR_API_SECRET 替换成你从 BitMEX 平台获取的真实 API 密钥和密钥。 更重要的是，在使用 BitMEX API 之前，请仔细阅读官方文档，特别是关于请求频率限制 (Rate Limits) 的章节。 频繁超出限制可能导致你的 IP 地址或 API 密钥被临时或永久禁止访问。 二、查看结算记录

结算记录详尽地展示了你在 BitMEX 交易所内，持有的永续合约或其它衍生品仓位在每日结算或强制结算时的盈亏状况。 它包含了仓位规模、结算价格、盈亏金额等关键信息，对于追踪交易表现和进行风险管理至关重要。

• 导航至“结算历史”页面： 在 BitMEX 网页界面的用户中心，通常位于“账户”或“帐户”选项的下拉菜单中，寻找并点击“结算历史”或类似的名称选项。 具体位置可能因 BitMEX 平台界面更新而略有不同。
• 筛选时间范围和交易对： 与交易历史类似，为了更有效地查找特定时间段或特定交易品种的结算记录，你可以使用页面提供的筛选功能。 选择特定的时间范围（例如，过去 24 小时、过去 7 天、自定义日期范围）和特定的交易对（例如，XBTUSD、ETHUSD）进行筛选。
• 查看结算详情： 每条结算记录详细列出了结算发生的具体时间戳、结算时合约标的资产的价格（结算价）、你在该合约上的仓位规模（合约数量或名义价值）、以及最终的结算盈亏金额，包括资金费用和其它可能的费用调整。 仔细分析结算详情可以帮助你理解交易策略的有效性，并优化未来的交易决策。

三、查看资金记录

资金记录是了解账户资金流动的关键工具，它详尽地展示了账户内所有资金变动的详细信息，包括但不限于：

• 充值记录： 所有向账户充入加密货币的记录，包括充值时间、充值数量以及对应的交易哈希值（Transaction Hash）。
• 提现记录： 所有从账户提取加密货币的记录，包含提现时间、提现数量、提现地址以及交易状态。
• 利息支付记录： 如果平台提供利息收益，此部分将记录所有利息收入，详细说明利息的计算方式和支付周期。
• 手续费记录： 交易过程中产生的所有手续费，包括开仓、平仓、资金划转等产生的手续费，会详细记录手续费类型和金额。
• 其他资金变动： 比如合约结算、赠金、返佣等其他类型的资金变动也会在此处记录。

操作步骤：

1. 导航至“资金历史”页面： 登录 BitMEX 网页版，在用户界面中通常可以找到“账户”或“帐户”相关选项，点击进入账户管理页面。然后，在该页面中寻找并点击“资金历史”、“交易历史”或类似的选项，以进入资金记录查看页面。
2. 筛选时间范围和资金类型： 为了更有效地查找特定资金记录，你可以根据需要筛选时间范围。例如，选择“最近一周”、“最近一个月”或自定义时间段。同时，还可以按资金类型进行筛选，如“存款”、“取款”、“利息”、“手续费”、“合约结算”等，以便快速定位所需信息。
3. 查看资金变动详情： 每一条资金记录都会详细显示资金变动的具体信息，包括：
   • 时间： 资金变动发生的精确时间。
   • 金额： 资金变动的数量，包括正数（增加）和负数（减少）。
   • 类型： 资金变动的类型，例如存款、提款、利息等。
   • 交易 ID（Transaction ID）或备注信息： 对应交易的唯一标识符，可用于在区块链浏览器上查询交易详情，或平台提供的相关说明和备注。