HTX历史成交查询方法指南
HTX (原火币全球站) 作为一个全球领先的加密货币交易所，为用户提供了便捷的交易平台。 了解如何查询历史成交记录对于投资者进行盈亏分析、策略复盘至关重要。本文将详细介绍HTX平台查询历史成交记录的各种方法，帮助用户更好地管理和分析自己的交易数据。
一、网页端查询
网页端是HTX（火币全球站）用户常用的交易平台，它提供了包括现货交易、合约交易在内的全面的交易功能。对于需要详细了解自己交易行为的用户，查询历史成交记录至关重要。以下是在HTX网页端查询历史成交记录的详细步骤，确保您能准确追踪您的交易活动：
- 登录您的HTX账户： 打开HTX官方网站，使用您的注册邮箱或手机号以及账户密码登录您的个人HTX账户。请务必确保您访问的是官方网站，谨防钓鱼网站，保护您的账户安全。
注意事项：
- 交易对和时间范围选择： 务必仔细核对您所选的交易对是否正确，例如 BTC/USDT 或 ETH/BTC。不正确的交易对将导致无法检索到所需的成交记录。同时，精确设置时间范围至关重要。例如，如果您只想查找过去 24 小时的交易记录，请将开始时间和结束时间设置为正确的值。忽略此步骤可能导致搜索结果不准确或空白。
- 加载时间与交易量： 当您在短时间内执行了大量交易时，例如高频交易或使用交易机器人，成交记录的数量可能会非常庞大。这会导致页面加载时间显著增加。请耐心等待，避免在加载过程中刷新页面，以免中断数据加载进程。如果长时间无法加载，请尝试缩小时间范围或分批查询。
- 历史数据查询与导出： 如果您需要查询跨越较长时间段的历史成交记录，例如数月或数年，直接在页面上加载所有数据可能会非常耗时，甚至导致浏览器崩溃。建议采用分批导出的方式，将数据按月、按周或按日分割成较小的文件进行导出。导出完成后，您可以使用电子表格软件（如 Excel 或 Google Sheets）或其他数据分析工具将这些文件合并，以便进行进一步的分析和处理。某些交易所或交易平台可能提供 API 接口，允许您通过编程方式批量获取历史数据，这通常比手动导出更高效。
二、APP端查询
HTX（火币）APP 为用户提供了随时随地进行数字资产交易的便捷途径。通过移动端应用程序，您可以轻松访问并管理您的交易活动。以下是在 HTX APP 上查询历史成交记录的详细步骤，助您追踪交易详情：
- 打开您的 HTX APP，确保您已登录您的交易账户。如果您尚未登录，请使用您的用户名和密码进行登录。为确保账户安全，建议您启用二次验证（例如 Google Authenticator 或短信验证）。
注意事项：
- 网络连接稳定性： 请务必确保您的HTX APP在访问和加载成交记录时，拥有稳定且高速的网络连接。不稳定的网络环境，如Wi-Fi信号弱或移动数据连接不稳定，可能导致成交记录加载失败或延迟，影响您的交易数据分析。建议在网络状况良好的环境下进行操作，或尝试切换网络连接方式。
- APP版本差异： HTX APP的界面布局、功能入口以及具体操作步骤会随着版本更新而有所调整。查找和访问成交记录的基本逻辑和流程通常保持一致。请注意，不同版本的APP在菜单名称、图标显示或功能位置上可能存在差异。当遇到界面变化时，请仔细浏览APP的各个模块，寻找与“交易记录”、“历史订单”、“成交明细”等相关的选项。如有疑问，可以参考HTX官方发布的最新版APP使用指南或联系客服。
- 数据导出方式： 如果HTX APP未直接提供一键导出成交记录的功能，您仍然可以通过其他方式获取所需数据。 截图： 您可以分批次截取APP内的成交记录页面，然后将截图整理成文档。此方法适用于数据量较小的情况。 复制： 部分APP允许用户复制成交记录的文本内容，您可以将复制的文本粘贴到备忘录、文档编辑器或其他支持文本格式的应用中进行保存和整理。 第三方工具： 在某些情况下，可能需要借助第三方数据分析工具或API接口来获取更完整的交易数据。但请务必注意数据安全，选择信誉良好且安全可靠的第三方工具，并仔细阅读其用户协议和隐私政策，避免泄露您的个人信息和交易数据。
三、API 查询
HTX API 为开发者、量化交易者以及机构客户提供了高级的数据查询功能。通过 API 接口，用户可以编写自定义程序，自动化地获取历史交易数据，进行深度分析，并实现算法交易策略。 API 查询适用于需要高频数据、复杂数据分析和自动化交易的场景。
使用 API 查询可以实现以下功能：
- 历史成交记录查询： 获取指定交易对的历史成交价格、成交量和成交时间等详细信息，用于回测交易策略、分析市场趋势。
- K 线数据查询： 获取不同时间周期的 K 线数据，如 1 分钟、5 分钟、1 小时、1 天等，用于技术分析和图表绘制。
- 实时市场深度查询： 获取当前市场买单和卖单的挂单量和价格，用于了解市场供需情况和评估交易成本。
- 账户信息查询： 查询账户余额、持仓情况、挂单信息等，用于监控账户状态和管理交易风险。
示例 (Python):
在Python中，可以使用以下代码片段生成符合特定加密货币交易所API要求的签名，例如用于发起安全请求。
这个例子涵盖了生成HMAC签名所需的关键步骤，包括导入必要的库、构造消息、使用密钥进行哈希运算、以及对结果进行编码。
import hmac # 提供了创建HMAC（Hash-based Message Authentication Code，基于哈希的消息认证码）的功能。HMAC常用于验证消息的完整性和身份验证。
import hashlib # 提供了多种哈希算法，如SHA-256，用于生成消息的哈希值。
import base64 # 提供了Base64编码和解码功能，用于将二进制数据转换为文本格式，方便在网络上传输。
import urllib.parse # 提供了URL编码和解码功能，用于处理URL中的特殊字符，确保URL的正确性。
import time # 提供了获取当前时间戳的功能，时间戳常用于API请求中，以防止重放攻击。
import requests # 提供了发送HTTP请求的功能，用于与API服务器进行交互。
# 你的API密钥和密钥（从交易所获得）
api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"
# 构建请求参数（示例）
params = {
"symbol": "BTCUSDT",
"side": "BUY",
"type": "MARKET",
"quantity": 0.1,
"timestamp": int(time.time() * 1000) # 毫秒级时间戳
}
# 将参数转换为查询字符串
query_string = urllib.parse.urlencode(params)
# 创建HMAC签名
def generate_signature(query_string, secret_key):
"""
使用HMAC-SHA256算法生成签名。
Args:
query_string (str): 要签名的查询字符串。
secret_key (str): 你的密钥。
Returns:
str: Base64编码的签名。
"""
encoded_secret_key = secret_key.encode('utf-8') # 将密钥编码为UTF-8字节串
encoded_query_string = query_string.encode('utf-8') # 将查询字符串编码为UTF-8字节串
hmac_digest = hmac.new(encoded_secret_key, encoded_query_string, hashlib.sha256).digest() # 使用SHA256算法计算HMAC值
signature = base64.b64encode(hmac_digest).decode('utf-8') # 将HMAC值进行Base64编码
return signature
# 生成签名
signature = generate_signature(query_string, secret_key)
# 构造请求头
headers = {
"X-MBX-APIKEY": api_key, # 一些交易所使用此header传递api key
"Content-Type": "application/x-www-form-urlencoded" # 表单数据格式
}
# 构造完整的URL (示例)
base_url = "https://api.example.com/v1/order" # 替换为实际的API endpoint
url = base_url + "?" + query_string + "&signature=" + signature
# 发送POST请求（示例）
try:
response = requests.post(url, headers=headers)
response.raise_for_status() # 检查HTTP状态码，如果不是200，则抛出异常
print(response.()) # 打印返回的JSON数据
except requests.exceptions.RequestException as e:
print(f"请求出错: {e}")
代码解释：
-
hmac,hashlib,base64,urllib.parse,time, 和requests是必要的Python库。 -
api_key和secret_key需要替换为你自己的API密钥和密钥。 -
params字典包含了API请求的参数，包括交易对、交易方向、订单类型、数量和时间戳。 -
urllib.parse.urlencode(params)将参数字典转换为URL编码的查询字符串。 -
generate_signature(query_string, secret_key)函数使用HMAC-SHA256算法生成签名，并进行Base64编码。 -
headers字典包含了请求头，包括API密钥和内容类型。 -
url变量构造了完整的API请求URL，包括基本URL、查询字符串和签名。 -
requests.post(url, headers=headers)发送POST请求到API服务器。 -
错误处理使用
try...except块来捕获请求异常。
注意：
- 请务必妥善保管你的API密钥和密钥，避免泄露。
- 不同的交易所可能有不同的API签名要求，请参考交易所的官方文档。
- 时间戳的精度（秒或毫秒）也可能因交易所而异。
-
确保安装了requests库：
pip install requests
替换为您的 API Key 和 Secret Key
access_key = 'YOUR_ACCESS_KEY'
secret_key = 'YOUR_SECRET_KEY'
此处的
access_key
和
secret_key
需要替换为您在火币交易所申请的真实 API 密钥。API 密钥是您访问火币 API 的凭证，请务必妥善保管，避免泄露。
def generate_signature(method, url, params):
"""生成 API 请求签名"""
timestamp = str(int(time.time()))
params_str = urllib.parse.urlencode(sorted(params.items()))
payload = f"{method.upper()}\napi.huobi.pro\n{url}\n{params_str}"
digest = hmac.new(secret_key.encode('utf-8'), payload.encode('utf-8'), hashlib.sha256).digest()
signature = base64.b64encode(digest).decode()
return signature, timestamp
generate_signature
函数用于生成 API 请求的数字签名，这是火币 API 安全机制的重要组成部分。该函数接收 HTTP 方法 (
method
)，请求 URL (
url
) 和请求参数 (
params
) 作为输入，并返回生成的签名 (
signature
) 和时间戳 (
timestamp
)。
签名生成的步骤包括：
- 获取当前时间戳。
- 将请求参数按照字母顺序排序并进行 URL 编码。
-
构造 payload 字符串，其格式为
"{method.upper()}\napi.huobi.pro\n{url}\n{params_str}"。 -
使用
secret_key对 payload 进行 HMAC-SHA256 加密。 - 将加密后的结果进行 Base64 编码，得到最终的签名。
def get_historical_trades(symbol, size, from_id=None):
"""查询历史成交记录"""
method = 'GET'
url = '/v1/order/matchresults'
params = {
'symbol': symbol,
'size': size,
'AccessKeyId': access_key,
'SignatureMethod': 'HmacSHA256',
'SignatureVersion': 2,
}
if from_id:
params['from'] = from_id
get_historical_trades
函数用于从火币 API 获取指定交易对的历史成交记录。它接收交易对代码 (
symbol
)，返回的成交记录数量 (
size
) 和起始成交 ID (
from_id
，可选) 作为输入。
该函数构建一个包含以下参数的 GET 请求：
-
symbol: 交易对代码，例如 "btcusdt"。 -
size: 返回的成交记录数量，最大值为 200。 -
AccessKeyId: 您的access_key。 -
SignatureMethod: 签名方法，固定为 "HmacSHA256"。 -
SignatureVersion: 签名版本，固定为 2。 -
from: 可选参数，指定起始成交 ID，用于分页查询。如果不提供，则从最新的成交记录开始返回。
signature, timestamp = generate_signature(method, url, params)
params['Signature'] = signature
params['Timestamp'] = timestamp
在构造请求参数后，调用
generate_signature
函数生成签名，并将签名和时间戳添加到请求参数中。
-
Signature: API 请求的数字签名。 -
Timestamp: 发起 API 请求时的时间戳（UTC 时间）。
url = f'https://api.huobi.pro{url}?{urllib.parse.urlencode(params)}'
response = requests.get(url)
response.raise_for_status()
return response.()
将请求参数添加到 URL 中，并使用
requests
库发送 GET 请求。
response.raise_for_status()
会在 HTTP 响应状态码表示错误时抛出异常。
response.()
将响应内容解析为 JSON 格式并返回。
示例用法
symbol = 'btcusdt'
：定义交易对，这里使用比特币兑USDT交易对作为示例。该参数指定了要查询历史成交记录的交易市场。务必根据交易所支持的交易对进行调整。
size = 100
：设置每页返回的成交记录数量。此处的
size
参数决定了API单次调用返回的最大记录数。大多数交易所对此参数有限制，通常最大值为100。根据API文档进行配置。
data = get_historical_trades(symbol, size)
：调用
get_historical_trades
函数，传入交易对
symbol
和记录数量
size
，获取历史成交数据。此函数负责与交易所API交互，并返回包含成交记录的字典。
if data['status'] == 'ok':
：检查API请求是否成功。
data['status']
字段指示了API调用的状态。如果状态为
'ok'
，则表示请求成功，可以进一步处理返回的成交数据。
trades = data['data']
：从返回的数据中提取成交记录列表。
data['data']
通常包含一个列表，其中每个元素代表一笔成交记录。
for trade in trades:
：遍历成交记录列表，处理每一笔成交数据。循环迭代每一笔成交记录，以便提取并显示相关信息。
print(f"Trade ID: {trade['id']}")
：打印成交ID。
trade['id']
是每笔成交记录的唯一标识符。
print(f"Price: {trade['price']}")
：打印成交价格。
trade['price']
代表该笔交易的成交价格。
print(f"Amount: {trade['field-amount']}")
：打印成交数量。
trade['field-amount']
表示成交的加密货币数量。请注意，不同的交易所API可能使用不同的字段名称来表示成交数量，如
amount
或
qty
。
print(f"Time: {trade['created-at']}")
：打印成交时间。
trade['created-at']
表示成交发生的时间。时间戳格式可能因交易所而异，需要根据具体情况进行转换。
print("-" * 20)
：打印分隔符，用于分隔不同的成交记录。
else:
：处理API请求失败的情况。
print(f"Error: {data['err-msg']}")
：打印错误信息。
data['err-msg']
包含了API返回的错误信息，有助于诊断问题。常见的错误包括无效的交易对、API调用频率超限等。
注意事项：
- 编程基础： 使用API对接火币交易所需要具备一定的编程基础，理解HTTP请求、JSON数据格式，以及至少掌握一种编程语言（例如Python、Java、C++等）。熟悉RESTful API的概念和使用方法是必要条件。
- 密钥安全： 务必妥善保管您的API Key（访问密钥）和Secret Key（私有密钥）。API Key用于标识您的身份，Secret Key用于签名请求，一旦泄露可能导致资产损失。切勿将密钥泄露给他人，不要将其存储在公共代码仓库或不安全的地方。建议使用环境变量或加密配置文件管理密钥。
- 频率限制： 火币交易所对API调用频率有限制，高频调用可能会触发风控系统，导致API Key被暂时或永久禁用。在开发过程中，务必注意控制API的调用频率，合理设计程序逻辑，避免不必要的重复请求。建议阅读火币官方API文档，了解具体的频率限制规则，并根据实际情况进行调整。可以使用延时、批量请求等方式优化调用策略。
- 文档更新： 火币API文档会定期更新，包括接口变更、参数调整、新增功能等。请密切关注火币官方公告，及时了解API的最新变化，并根据更新后的文档调整您的代码，确保API调用的正确性和兼容性。建议定期检查您的代码，确认其与最新的API文档保持一致。
- 示例参考： 上述Python示例代码仅作为参考，展示了基本的API调用流程。在实际应用中，您需要根据您的具体需求和业务逻辑进行修改和完善。例如，您可能需要处理更复杂的错误情况、实现更高级的交易策略、或者对接其他数据源。请务必充分理解示例代码的含义，并进行充分的测试，确保其能够满足您的需求。
四、第三方工具
除了 HTX 官方提供的查询渠道外，众多第三方工具也为用户提供了便捷的历史成交记录查询与分析服务。这些工具通常集成了高级数据处理功能，旨在满足专业交易者对深度分析的需求。
这些工具的功能可能包括但不限于：
- 高级图表分析： 提供K线图、成交量图等多种图表类型，并支持自定义时间周期、技术指标叠加，帮助用户更直观地理解市场趋势和价格波动。
- 盈亏计算： 自动计算用户的交易盈亏，并可按时间段、交易对等维度进行细分，方便用户评估交易策略的效果。
- 策略回测： 允许用户将历史成交数据导入回测系统，模拟不同交易策略在过去市场环境下的表现，评估策略的潜在收益和风险。
- 数据导出与分析： 支持将成交数据导出为CSV、Excel等格式，方便用户使用其他数据分析工具进行更深入的研究。
- 交易信号提示： 一些工具还会根据成交数据和技术指标生成交易信号，为用户提供交易决策参考。
使用第三方工具时，务必注意以下几点：
- 数据安全： 选择信誉良好、安全可靠的工具，避免泄露您的 HTX 账户信息和API密钥。
- 数据准确性： 确认工具提供的数据源与 HTX 官方数据一致，避免因数据偏差导致分析结果失真。
- 费用： 部分第三方工具可能需要付费使用，请根据您的需求和预算进行选择。
- 免责声明： 了解工具提供商的免责声明，明确其不对您的交易决策负责。
选择第三方工具时，请务必注意以下几点：
- 安全性： 选择信誉良好、安全可靠的第三方工具至关重要，务必仔细审查其安全措施和用户评价。 优先选择经过安全审计，拥有良好声誉和长期运营历史的工具。 详细阅读用户协议和隐私政策，了解数据处理方式和保护措施，避免因使用不安全的工具而导致账户信息泄露或资产损失。 考虑双因素认证(2FA)支持，增强账户安全。
- 功能性： 第三方工具的功能性直接关系到您的交易效率和策略执行。 选择功能符合您特定需求的工具，例如高级图表分析、自动化交易机器人、风险管理工具或投资组合跟踪等。 深入了解工具提供的各种功能，并评估其是否能够满足您的交易目标和风险承受能力。 避免选择功能冗余或不实用的工具，专注于能够提升交易效果的关键功能。 考虑工具是否提供回测功能，以便在真实交易前评估策略的有效性。
- 兼容性： 确保所选第三方工具与 HTX (火币) 平台完全兼容，能够无缝对接并稳定运行。 检查工具是否支持 HTX 交易所的 API 接口，并且能够正确读取和写入交易数据。 关注工具的更新频率，确保其能够及时适应 HTX 平台的升级和变化，避免因兼容性问题导致交易中断或数据错误。 查阅官方文档或用户社区，了解工具与 HTX 平台的兼容性信息，并参考其他用户的经验反馈。
- 费用： 在使用第三方工具之前，务必清楚了解其收费模式，包括订阅费、交易手续费、API 使用费等。 比较不同工具的收费标准和服务内容，选择性价比最高的方案。 注意是否存在隐藏费用或额外收费项目，例如数据流量费或高级功能解锁费。 部分工具可能提供免费试用期，可以充分利用试用期评估工具的价值和适用性。 考虑免费增值模式(Freemium)，此类工具通常提供基本功能免费使用，高级功能则需要付费订阅。
常用第三方工具
- 交易终端： 专业交易终端通常支持与HTX账户对接， 提供深度市场分析、高级订单类型（如冰山订单、止损限价单）以及定制化交易界面等功能。部分终端还提供模拟交易环境，方便用户在真实交易前测试策略。用户应选择信誉良好、安全性高的交易终端，并仔细阅读其服务条款。
- 数据分析平台： 数据分析平台提供HTX交易所的历史交易数据、订单簿数据、K线数据等， 并支持自定义指标计算、数据可视化和回溯测试。这些平台可以帮助交易者识别市场趋势、评估交易策略的有效性、进行风险管理。使用时需注意数据更新频率、数据质量以及平台的数据安全措施。
- 量化交易平台： 量化交易平台允许用户使用编程语言（如Python）构建和执行自动化交易策略。这些平台通常提供API接口，方便用户获取HTX的实时市场数据和执行交易指令。在HTX上进行量化交易，需要对编程、算法和金融市场有深入了解， 并严格控制风险。选择平台时，应关注其API的稳定性、执行速度和回测功能的准确性。
使用第三方工具前，务必全面阅读并理解其使用说明文档，明确工具的功能范围、潜在风险、数据来源以及安全措施。审慎评估工具的可靠性与安全性，确保您的HTX账户和个人信息的安全。同时，注意HTX官方对于第三方工具使用的相关规定，避免违规操作。