币安Bitfinex账户数据获取：API指南与实战技巧

Binance与Bitfinex账户交易数据获取指南

在加密货币交易的世界里，获取历史交易数据对于策略回测、风险评估以及税务申报至关重要。本文将深入探讨如何从两大交易所——Binance（币安）和Bitfinex——获取账户的交易数据，并详细介绍各自的API文档和数据请求方法。

Binance交易数据获取

Binance为开发者和交易者提供了全面的应用程序编程接口（API），通过这些接口，用户可以程序化地访问和管理其账户数据，包括实时市场信息和历史交易记录。以下列出了几种常用的方法，用于从Binance平台获取账户交易数据的详细信息：

• Binance API： Binance官方API是获取交易数据的最直接途径。它提供了REST API和WebSocket API两种类型。
  • REST API： 通过发送HTTP请求，可以获取历史交易数据、账户余额、订单信息等。需要进行身份验证，确保只有授权用户才能访问敏感数据。身份验证通常涉及API密钥和签名，以保证请求的安全性。REST API适合于获取批量数据，例如特定时间段内的交易历史。
  • WebSocket API： 用于订阅实时市场数据和账户更新。通过建立持久连接，可以接收推送的交易信息，而无需频繁发送请求。WebSocket API适用于需要实时监控交易活动的应用场景，例如自动交易机器人。
• CCXT库： CCXT是一个流行的加密货币交易API封装库，支持多种交易所，包括Binance。它简化了API的调用过程，并提供了一致的接口，方便用户在不同交易所之间切换。使用CCXT，可以避免直接处理复杂的API请求和身份验证流程。
• 第三方API服务： 一些第三方服务提供商也提供了Binance交易数据的API接口。这些服务通常会提供更高级的功能，例如数据分析、回测和交易信号。选择第三方API服务时，需要仔细评估其可靠性、数据质量和安全性。
• Binance Chain API (BSC)： 如果你的交易涉及Binance Smart Chain上的代币，你需要使用BSC API来获取相关数据。这涉及到与区块链节点的交互，获取链上交易记录。可以使用Web3.js或ethers.js等库来简化与BSC API的交互。

无论选择哪种方法，都必须仔细阅读Binance API文档，了解请求频率限制、数据格式和错误处理。务必妥善保管API密钥，避免泄露，以防止未经授权的访问。同时，遵守Binance的使用条款，确保数据获取行为符合规定。

1. 使用 Binance API 获取交易数据

Binance API 是访问币安交易所交易数据的首选且最直接的方式。 币安提供了一套全面的 API 接口，允许开发者和交易者获取实时和历史的市场数据，执行交易操作，并管理账户信息。 该 API 支持多种编程语言，并提供了详细的文档和示例代码，方便用户集成。

币安 API 提供了多种类型的端点，以满足不同的数据需求和访问权限：

现货交易历史 (Spot Trade History):

通过 GET /api/v3/myTrades 端点，您可以查询特定交易对在现货市场的交易历史记录。此接口允许您检索所有已执行的买入和卖出订单，从而进行交易分析和记录。

为了准确获取您的交易历史，您需要提供以下参数：

• symbol ： 必选参数，指定您要查询的交易对，例如 BTCUSDT 。
• limit ： 可选参数，指定返回的交易记录数量上限，默认为 500 ，最大值为 1000 。建议根据您的需求设置合适的 limit 值。
• fromId ： 可选参数，指定从某个交易ID开始查询。用于分页查询，获取指定ID之后的交易记录。
• startTime ： 可选参数，指定查询的起始时间，以毫秒时间戳表示。
• endTime ： 可选参数，指定查询的结束时间，以毫秒时间戳表示。
• recvWindow ： 可选参数，指定请求的有效时间窗口，单位为毫秒。如果服务器接收到请求的时间超过了 recvWindow ，则请求会被拒绝。
• timestamp ： 必选参数，请求的时间戳，以毫秒为单位。

请务必注意，此端点需要进行身份验证。您需要在请求头中包含您的API密钥和签名，以确保您有权访问您的交易历史数据。签名通过HMAC SHA256算法生成，使用您的密钥对请求参数进行签名。

响应数据将以JSON数组的形式返回，每个元素代表一笔交易记录，包含交易ID、价格、数量、手续费等详细信息。

请求参数:

• symbol (必选): 交易对，指定需要查询的交易市场。例如， BTCUSDT 表示比特币兑 USDT 的交易对。务必提供有效的交易对代码，否则请求将会失败。交易所会维护一份可用的交易对列表，建议参考交易所的API文档获取最新列表。
• limit (可选): 返回记录的数量，用于控制单次API调用返回的交易记录条数。 默认值为 500 ，最大允许值为 1000 。如果未指定此参数，则服务器将返回默认数量的记录。 选择合适的 limit 值可以在网络带宽和数据完整性之间取得平衡。
• fromId (可选): 指定起始交易ID，从该ID对应的交易记录开始返回数据，用于分页查询历史交易记录。后续的交易记录ID会大于该 fromId 。 通常用于获取大量交易数据时，通过多次调用API并指定不同的 fromId 来实现分页。
• startTime (可选): 查询的起始时间戳，以 Unix 毫秒时间戳格式表示。 用于筛选指定时间范围内的交易记录。如果未指定，服务器可能返回较早的交易记录。 Unix 毫秒时间戳是指自 1970 年 1 月 1 日 00:00:00 UTC 至今经过的毫秒数。
• endTime (可选): 查询的结束时间戳，同样以 Unix 毫秒时间戳格式表示。 与 startTime 配合使用，定义查询的时间范围。如果未指定，服务器可能返回较晚的交易记录。 必须确保 endTime 大于 startTime ，否则查询结果可能为空或产生错误。

示例请求 (Python):

此示例展示了如何使用 Python 获取币安现货交易历史记录，包括必要的身份验证步骤和请求参数的构建。你需要安装 requests 库，可以使用 pip install requests 命令进行安装。

导入所需的 Python 库：

hashlib 用于生成安全哈希摘要， hmac 用于消息认证码的哈希运算， requests 用于发送 HTTP 请求， time 用于获取当前时间戳。

import hashlib
import hmac
import requests
import time

接下来，定义你的 API 密钥、API 密钥 secret 和币安 API 的基础 URL。 请务必妥善保管你的 API 密钥和 secret，不要将其泄露给任何第三方。

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"
base_url = "https://api.binance.com"

定义一个函数 get_signature 用于生成请求签名。此签名用于验证请求的真实性和完整性。

该函数使用 HMAC-SHA256 算法，将请求参数和你的 API 密钥 secret 进行哈希运算。

def get_signature(data, secret):
"""生成签名"""
return hmac.new(secret.encode('utf-8'), data.encode('utf-8'), hashlib.sha256).hexdigest()

定义一个函数 get_spot_trades 用于获取现货交易历史记录。

此函数接受交易对 symbol 、返回记录数量 limit 、起始交易 ID fromId 、起始时间 startTime 和结束时间 endTime 作为参数。 limit 的最大值为 1000，默认值为 500。 startTime 和 endTime 使用 Unix 时间戳（毫秒）表示。

def get_spot_trades(symbol, limit=500, fromId=None, startTime=None, endTime=None):
"""获取现货交易历史"""
endpoint = "/api/v3/myTrades"
params = {
"symbol": symbol,
"limit": limit,
}
if fromId:
params["fromId"] = fromId
if startTime:
params["startTime"] = startTime
if endTime:
params["endTime"] = endTime

代码示例：

# 构建查询字符串
query_string = '&'.join([f"{k}={v}" for k, v in params.items()])
timestamp = int(time.time() * 1000)
query_string += f"&timestamp={timestamp}"
signature = get_signature(query_string, api_secret)
query_string += f"&signature={signature}"

headers = {"X-MBX-APIKEY": api_key}
url = f"{base_url}{endpoint}?{query_string}"

response = requests.get(url, headers=headers)
response.raise_for_status()  # 检查请求是否成功
return response.()

构造完整的 API 请求 URL，包括 Endpoint，查询字符串，时间戳和签名。

使用 requests.get 方法发送 GET 请求到币安 API。 在 header 中包含 API 密钥，用于身份验证。

使用 response.raise_for_status() 检查请求是否成功。 如果请求失败，将引发 HTTPError 异常。

成功后，返回包含现货交易历史记录的 JSON 响应。

示例调用

要获取特定交易对的现货交易数据，您可以使用 get_spot_trades 函数。以下示例展示了如何获取 BTCUSDT 交易对的最新 100 条交易记录：

symbol = "BTCUSDT"
trades = get_spot_trades(symbol, limit=100)
print(trades)

在上述代码中， symbol 变量被赋值为 "BTCUSDT"，表示我们希望获取比特币与泰达币的交易数据。 limit 参数设置为 100，指定了要检索的交易记录数量上限。 调用 get_spot_trades 函数后，返回的交易数据将存储在 trades 变量中，并使用 print 函数输出到控制台。

返回的 trades 数据通常是一个列表，其中每个元素代表一笔交易。 每笔交易可能包含以下信息：交易 ID、交易时间、交易价格、交易数量、买卖方向等。 具体的数据结构取决于交易所 API 的实现方式。

注意事项：

• API 密钥配置： 使用 API 接口前，务必正确配置 API Key（公钥）和 Secret Key（私钥）。API Key 用于标识您的身份，Secret Key 用于对请求进行签名，是访问 API 的必要凭证。请妥善保管您的 Secret Key，切勿泄露给他人，防止被恶意利用。
• 请求签名机制： 所有 API 请求都必须经过签名，以确保数据在传输过程中的完整性和真实性，防止篡改。签名通常使用 Secret Key 和请求参数，通过特定的加密算法生成。详细的签名算法和步骤请参考 API 官方文档，确保签名正确有效。
• 频率限制管理： API 服务提供商通常会设置频率限制（Rate Limiting），以保护服务器稳定运行，防止滥用。请密切关注 API 的频率限制策略，合理控制您的请求频率。超出限制可能导致请求失败或 IP 地址被暂时屏蔽。可以通过批量请求、缓存数据、或使用 API 提供的分页功能来优化请求策略，避免触发限制。

合约交易历史 (Futures Trade History):

查询合约交易历史与现货交易有所不同，需要使用特定的API端点。对于币安U本位合约，使用 GET /fapi/v1/myTrades 端点；而币本位合约，则使用 GET /dapi/v1/myTrades 端点。

这些端点允许用户检索其在相应合约类型上的所有历史交易记录。 为了提高效率，通常需要提供参数，例如交易对 symbol （例如：BTCUSDT、ETHUSD_PERP）、起始时间 startTime 和结束时间 endTime ，以便缩小搜索范围。 还可以使用 limit 参数来限制返回的交易记录数量，默认值和最大值通常为500。 fromId 参数允许从特定的交易ID开始检索，这在处理大量交易记录时非常有用，避免重复获取已经处理过的数据。

请注意，API请求需要有效的API密钥和签名，并且用户需要确保其账户具有足够的权限才能访问交易历史记录。响应通常以JSON格式返回，其中包含交易的价格、数量、手续费、交易时间和其他相关信息。 开发者应仔细阅读币安API文档，了解每个参数的具体含义和使用方法，以确保正确地查询和解析交易历史数据。

请求参数:

• symbol (必选): 交易对，用于指定需要查询的交易品种。 例如， BTCUSDT 代表比特币兑美元的 U 本位合约交易对，而 BTCUSD_PERP 则代表比特币兑美元的币本位永续合约交易对。 务必提供有效的交易对代码，以确保API能够正确检索相关交易数据。不同的交易所支持的交易对可能有所不同，请参考交易所的官方文档获取支持的交易对列表。
• limit (可选): 返回记录的数量，控制API响应中包含的交易记录条数。 默认为 500 条，最大允许设置为 1000 条。 如果未指定此参数，API将默认返回最近的 500 条交易记录。 通过调整此参数，您可以控制每次API调用返回的数据量，以便更好地管理数据处理和网络带宽。
• fromId (可选): 从指定的 tradeId 开始返回数据，实现分页功能。 tradeId 是每笔交易的唯一标识符。 通过提供此参数，您可以从特定的交易记录开始检索数据，避免重复获取已处理的交易数据。 例如，如果您已经获取了 tradeId 为 1000 的交易记录，并将 fromId 设置为 1001，则API将返回从 tradeId 1001 开始的交易记录。
• startTime (可选): 查询起始时间戳 (Unix milliseconds)，用于指定查询的时间范围。 时间戳必须是 Unix 毫秒级时间戳。 API将返回在此时间戳之后发生的交易记录。 如果未指定此参数，API将从最早的可用交易记录开始返回数据，或者根据其他参数（如 endTime 和 limit ）确定起始时间。
• endTime (可选): 查询结束时间戳 (Unix milliseconds)，用于指定查询的时间范围。 时间戳必须是 Unix 毫秒级时间戳。 API将返回在此时间戳之前发生的交易记录。 结合 startTime 和 endTime 参数，您可以精确地定义查询的时间范围，以便获取特定时间段内的交易数据。 如果未指定此参数，API将返回到最近的交易记录为止的数据，或者根据其他参数（如 startTime 和 limit ）确定结束时间。

示例请求 (Python - U本位合约):

使用Python访问币安U本位合约交易历史记录的示例代码，展示了如何构造API请求，包含必要的参数、签名生成过程以及如何处理API响应。

import hashlib import hmac import requests import time

初始化API密钥、密钥和基础URL。请务必替换 YOUR_API_KEY 和 YOUR_API_SECRET 为您真实的API密钥和密钥。 基础URL https://fapi.binance.com 是币安U本位合约API的根地址。

api_key = "YOUR_API_KEY" api_secret = "YOUR_API_SECRET" base_url = "https://fapi.binance.com"

get_signature(data, secret) 函数用于生成API请求的数字签名。 该函数使用HMAC-SHA256算法，使用您的API密钥作为密钥对请求数据进行哈希处理，确保请求的完整性和真实性。

def get_signature(data, secret): """生成签名""" return hmac.new(secret.encode('utf-8'), data.encode('utf-8'), hashlib.sha256).hexdigest()

get_futures_trades(symbol, limit=500, fromId=None, startTime=None, endTime=None) 函数用于获取U本位合约交易历史。它接受交易对代码（symbol）作为必要参数，以及限制返回结果数量（limit）、起始交易ID（fromId）、起始时间（startTime）和结束时间（endTime）作为可选参数。

def get_futures_trades(symbol, limit=500, fromId=None, startTime=None, endTime=None): """获取U本位合约交易历史""" endpoint = "/fapi/v1/myTrades" params = { "symbol": symbol, "limit": limit, } if fromId: params["fromId"] = fromId if startTime: params["startTime"] = startTime if endTime: params["endTime"] = endTime

该代码段首先构造请求参数，包括交易对代码和结果数量限制。如果提供了起始交易ID、起始时间和结束时间，这些参数也会被添加到请求参数中。 时间戳（timestamp）参数是必需的，表示请求发送的时间，以毫秒为单位。然后，使用 get_signature 函数生成请求签名，并将签名添加到请求参数中。 X-MBX-APIKEY Header必须包含您的API Key。 使用 requests 库发送GET请求到币安API，并处理响应。使用 response.raise_for_status() 检查HTTP请求是否成功，如果返回的状态码不是200，会抛出异常。 函数返回包含交易历史记录的JSON数据。

# 构建查询字符串
query_string = '&'.join([f"{k}={v}" for k, v in params.items()])
timestamp = int(time.time() * 1000)
query_string += f"&timestamp={timestamp}"
signature = get_signature(query_string, api_secret)
query_string += f"&signature={signature}"

headers = {"X-MBX-APIKEY": api_key}
url = f"{base_url}{endpoint}?{query_string}"

response = requests.get(url, headers=headers)
response.raise_for_status()  # 检查请求是否成功
return response.()

示例调用

要获取特定交易对（例如 BTCUSDT）的最新交易数据，你可以使用 get_futures_trades 函数。此函数允许你指定要检索的交易数量，并通过 limit 参数进行控制。例如，以下代码演示了如何获取 BTCUSDT 交易对的最近 100 笔交易：

symbol = "BTCUSDT"
trades = get_futures_trades(symbol, limit=100)
print(trades)

在上述代码段中， symbol 变量被设置为 "BTCUSDT"，指定了要查询的交易对。然后，调用 get_futures_trades 函数，并将 symbol 和 limit 作为参数传递。 limit 参数设置为 100，表示请求最近的 100 笔交易。函数返回的交易数据存储在 trades 变量中，最后使用 print(trades) 打印出来，以便查看返回的交易信息。

请注意，返回的 trades 变量可能是一个包含多个交易记录的列表或数组。每条交易记录通常包含交易时间、交易价格、交易数量以及其他相关信息。具体的数据结构取决于交易所或API的实现方式。

注意事项:

• API Endpoint 选择: 为了成功检索交易历史，请务必根据您使用的合约类型选择正确的API endpoint。 对于U本位合约（USDT结算的期货），请使用 /fapi/v1/myTrades 。 对于币本位合约（以加密货币结算的期货），请使用 /dapi/v1/myTrades 。 错误的endpoint会导致API调用失败或返回不准确的数据。
• 签名机制与API URL: 尽管签名过程与现货交易类似，即都需要使用您的API密钥和密钥进行签名以验证请求的身份和完整性，但请注意，期货交易和现货交易使用不同的API URL。 确保您使用与所选endpoint相对应的基础URL。 例如，U本位合约通常使用 fapi.binance.com ，而币本位合约使用 dapi.binance.com 。 不正确的URL也会导致API调用失败。在构建请求时，请仔细检查并确认URL的正确性。

2. 使用第三方库简化API交互

为了更便捷地与币安API进行交互，开发者可以利用各种优秀的第三方库。这些库通常封装了复杂的HTTP请求和响应处理逻辑，提供了更友好的接口，从而显著简化开发流程。

例如， python-binance 是一个非常流行的Python币安API库。它提供了完整的币安API接口封装，包括现货交易、合约交易、账户信息查询等功能。使用该库，开发者无需手动构建HTTP请求，只需调用相应的函数即可完成API调用。

除了 python-binance ， 还有其他编程语言的类似库， 例如JavaScript的'node-binance-api'， Java的'BinanceConnector' 等。 选择合适的库取决于你使用的编程语言和项目需求。

使用第三方库通常包括以下步骤：

1. 安装库： 使用相应的包管理器安装所需的库，例如 Python 的 pip。
2. 配置API密钥： 在代码中配置你的币安API密钥和私钥，以便进行身份验证。务必妥善保管你的密钥，避免泄露。
3. 调用API： 使用库提供的函数调用相应的API接口，例如获取账户余额、下单交易等。
4. 处理响应： 解析API返回的数据，并根据需要进行处理。

通过使用第三方库，开发者可以专注于业务逻辑的实现，而无需花费大量时间处理底层的API交互细节，从而提高开发效率。

示例 (python-binance):

使用 python-binance 库可以方便地与币安交易所进行交互。 在使用前，请确保已经安装该库。 可以通过 pip 进行安装： pip install python-binance 。

from binance.client import Client

要进行身份验证，需要提供 API 密钥和 API 密钥。 请务必妥善保管您的 API 密钥和密钥，不要泄露给他人。 可以通过币安官网创建和管理 API 密钥。

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"

创建一个 Client 实例，将 API 密钥和密钥作为参数传递给构造函数。

client = Client(api_key, api_secret)

通过 get_my_trades 方法可以获取指定交易对的历史成交记录。 symbol 参数指定交易对，例如 'BTCUSDT'。 limit 参数指定返回的最大成交记录数量，例如 100。

trades = client.get_my_trades(symbol='BTCUSDT', limit=100)
print(trades)

get_my_trades 方法返回的是一个包含成交记录的列表。 每条成交记录都是一个字典，包含成交价格、数量、时间等信息。

使用第三方库可以显著简化与交易所 API 的交互， 降低开发复杂性。 选择库时，务必关注其社区活跃度、文档完整性、安全性审计报告等指标， 确保库的可靠性和安全性，避免潜在风险。 定期更新库到最新版本，可以修复已知漏洞并获得最新功能。

Bitfinex交易数据获取

Bitfinex提供了API接口，允许开发者访问其交易数据。与币安（Binance）相比，Bitfinex的API使用复杂度略有提升。Bitfinex API主要提供两种数据获取方式：REST API和WebSocket API。

REST API： 适用于获取历史交易数据。通过发送HTTP请求到指定的API端点，可以检索特定时间段内的交易记录、订单簿快照、历史价格等数据。使用REST API时，需要注意API调用频率限制，避免因过度请求而被限制访问。详细的API文档和参数说明可在Bitfinex官方网站查阅。

WebSocket API： 适用于接收实时交易数据流。通过建立WebSocket连接，可以订阅感兴趣的交易对或市场数据频道，实时接收最新的交易信息、订单簿更新、价格变动等数据。WebSocket API具有低延迟、高效率的特点，适合构建实时交易策略和监控系统。同样需要注意连接数和数据请求的限制。

在使用Bitfinex API之前，建议仔细阅读其官方API文档，了解API的使用规则、认证方式、数据格式以及错误处理机制。部分API端点可能需要进行身份验证，需要提前注册Bitfinex账号并获取API密钥。

1. 使用 Bitfinex REST API

Bitfinex 提供了强大的 REST API，允许开发者以编程方式访问其交易平台的功能。通过 REST API，你可以获取市场数据、管理订单、执行交易以及访问账户信息。

• 身份验证： 使用 Bitfinex API 密钥进行身份验证是访问私有 API 端点的必要步骤。API 密钥包括一个密钥 (Key) 和一个密钥 (Secret)，必须妥善保管，避免泄露。
• API 端点： Bitfinex REST API 的基本 URL 为 `https://api.bitfinex.com/v2/`。所有 API 请求都以此 URL 为前缀，后跟特定的端点路径，例如 `/tickers` 用于获取交易对的行情数据。
• 请求方法： Bitfinex API 支持多种 HTTP 请求方法，包括 GET、POST 和 PUT。GET 用于检索数据，POST 用于创建或更新资源，PUT 则用于替换现有资源。具体使用哪种方法取决于所请求的 API 端点。
• 请求参数： 通过查询字符串或请求体传递参数给 API 端点。查询字符串用于 GET 请求，而请求体通常用于 POST 和 PUT 请求，并以 JSON 格式编码。
• 响应格式： Bitfinex API 以 JSON 格式返回响应数据。响应数据包括请求的结果以及任何相关的错误信息。
• 速率限制： 为了防止滥用，Bitfinex API 实施了速率限制。超过速率限制可能会导致 API 请求被拒绝。建议开发者实施重试机制来处理速率限制错误。
• 常用端点：
  • /tickers : 获取指定交易对的实时行情数据，例如最新成交价、最高价、最低价、交易量等。
  • /trades : 获取指定交易对的交易历史记录，包括成交时间、价格和数量。
  • /book : 获取指定交易对的订单簿信息，包括买单和卖单的价格和数量。
  • /order/new : 创建新的订单，可以指定订单类型、交易对、数量和价格。
  • /order/cancel : 取消指定的订单。
  • /positions : 获取当前账户的持仓信息。
  • /balances : 获取当前账户的余额信息。
• 错误处理： API 调用可能因各种原因失败，例如无效的 API 密钥、无效的参数或服务器错误。开发者应该仔细检查响应状态码和错误信息，并采取适当的措施来处理错误。
• 安全性： 在使用 Bitfinex API 时，务必注意安全性。不要在公共场所或不安全的网络中泄露 API 密钥。定期轮换 API 密钥，以降低安全风险。

交易历史 (Order History):

获取完整的交易历史记录，你需要调用 Bitfinex API 的 /v2/auth/r/orders/hist 端点。这个端点允许你查询所有已完成或已取消的订单信息，包括订单的详细执行情况、交易对、下单时间、成交价格、成交数量以及订单状态等关键数据。

使用此端点前，请确保已通过身份验证。身份验证通常涉及提供你的 API 密钥和密钥，并使用 HMAC-SHA384 算法生成签名。

/v2/auth/r/orders/hist 端点支持多种参数，以便于你根据特定条件筛选交易历史。常用的参数包括：

• symbol : 指定交易对，例如 "tBTCUSD" 表示比特币兑美元。如果不指定，则返回所有交易对的订单历史。
• start : 起始时间戳 (毫秒)。用于筛选指定时间之后的订单。
• end : 结束时间戳 (毫秒)。用于筛选指定时间之前的订单。
• limit : 返回订单的最大数量。默认为 50，最大值为 1000。
• id : 订单ID。用于获取特定ID的订单历史。

返回的数据通常是一个 JSON 数组，其中每个元素代表一个订单。每个订单对象会包含如下字段：

• ID : 订单的唯一标识符。
• SYMBOL : 交易对，例如 "tBTCUSD"。
• MTS_CREATE : 订单创建的时间戳 (毫秒)。
• MTS_UPDATE : 订单最后更新的时间戳 (毫秒)。
• AMOUNT : 订单数量。正数为买单，负数为卖单。
• AMOUNT_ORIG : 原始订单数量。
• TYPE : 订单类型，例如 "LIMIT"（限价单），"MARKET"（市价单）。
• PRICE : 订单价格。
• PRICE_AVG : 平均成交价格。
• ORDER_ID : 关联订单ID。
• ORDER_ID_PEER : 对等订单ID。
• ORDER_STATUS : 订单状态，例如 "ACTIVE"（活动），"EXECUTED"（已执行），"CANCELED"（已取消）。

请参考 Bitfinex 官方 API 文档，获取关于 /v2/auth/r/orders/hist 端点的更详细信息，包括请求示例、参数说明和返回值的完整定义。正确理解和使用这些信息对于成功检索和分析你的交易历史至关重要。

请求参数:

• symbol (必选): 交易对，用于指定需要查询历史数据的市场。例如 tBTCUSD 代表比特币对美元的交易对。 务必注意 Bitfinex 交易所特有的交易对命名格式，'t' 开头表示交易对，后续为币种代码。务必使用大写字母表示币种代码。例如， tETHUSD 代表以太坊对美元。请参考 Bitfinex 官方文档获取完整的交易对列表。
• limit (可选): 返回历史数据的记录数量。默认值为 50 条记录。允许的最大值为 120 条记录。如果请求的数据量超过 120 ，服务器将截断结果，仅返回最新的 120 条记录。较小的 limit 值可以加快响应速度。
• start (可选): 查询历史数据的起始时间戳。该参数以 Unix 毫秒时间戳格式表示，例如 1678886400000 。如果未指定，则服务器将从最早可用的数据开始返回，受到 limit 参数的限制。使用精确的起始时间戳可以更精确地定位所需的数据范围。
• end (可选): 查询历史数据的结束时间戳。同样以 Unix 毫秒时间戳格式表示，例如 1678972800000 。如果未指定，则服务器将返回到当前时间为止的数据，同样受到 limit 参数的限制。 start 和 end 参数的组合可以精确地定义所需的时间范围。注意 end 时间戳必须晚于 start 时间戳。

示例请求 (Python):

为了与Bitfinex API进行安全交互，你需要使用API密钥、密钥以及Python编程语言。 下面的代码段展示了如何构建一个经过身份验证的请求，以获取交易历史记录。 请确保已安装必要的库，例如 hashlib 、 hmac 、 requests 和 time 。

import hashlib import hmac import requests import time import

在使用API之前，设置你的API密钥、API密钥和基本URL。 将占位符替换为你从Bitfinex收到的实际凭据。

api_key = "YOUR_API_KEY" api_secret = "YOUR_API_SECRET" base_url = "https://api.bitfinex.com"

API安全的关键在于生成签名。 该函数使用SHA384算法创建一个唯一的消息身份验证代码（MAC），确保请求的完整性和真实性。 它连接API路径、随机数和数据，然后使用你的API密钥对结果进行哈希处理。

def get_signature(path, data, secret): """生成用于Bitfinex API请求的HMAC SHA384签名。""" nonce = str(int(round(time.time() * 1000000))) data_string = .dumps(data) payload = "/api/v2/" + path + nonce + data_string signature = hmac.new(api_secret.encode('utf-8'), payload.encode('utf-8'), hashlib.sha384).hexdigest() return signature, nonce

以下函数封装了从Bitfinex获取交易历史记录的逻辑。 它接受交易对代码（例如“tBTCUSD”）、限制结果数量、开始时间和结束时间作为参数。 它构建请求数据、生成签名、设置必要的标头并向Bitfinex API发出POST请求。

def get_bitfinex_trades(symbol, limit=50, start=None, end=None): """从Bitfinex获取指定交易对的历史订单。""" endpoint = "/v2/auth/r/orders/hist" path = "auth/r/orders/hist" # 用于签名

data = {
    "symbol": symbol,
    "limit": limit,
}
if start:
    data["start"] = start
if end:
    data["end"] = end

signature, nonce = get_signature(path, data, api_secret)

headers = {
    "bfx-apikey": api_key,
    "bfx-signature": signature,
    "bfx-nonce": nonce,
    "Content-Type": "application/"
}
url = f"{base_url}{endpoint}"

response = requests.post(url, headers=headers, =data)
response.raise_for_status()  # 引发HTTPError以获取错误的请求
return response.()

示例调用

以下代码展示了如何使用 get_bitfinex_trades 函数来获取 Bitfinex 交易所的交易历史数据。该函数允许你指定交易对（symbol）以及返回的交易记录数量（limit）。

symbol = "tBTCUSD"

这行代码定义了一个变量 symbol ，并将其设置为 "tBTCUSD" 。 "tBTCUSD" 代表比特币（BTC）与美元（USD）的交易对。 t 前缀表明这是一个交易对。 其他交易对例如 tETHUSD （以太坊/美元）。

trades = get_bitfinex_trades(symbol, limit=20)

这行代码调用 get_bitfinex_trades 函数，传入交易对 symbol 和交易记录数量 limit 作为参数。 limit=20 表示最多获取 20 条交易记录。 函数返回的结果（一个包含交易信息的列表）被赋值给变量 trades 。 如果没有指定 limit, 则默认返回最近的交易记录。

print(trades)

这行代码使用 print 函数将 trades 变量的内容输出到控制台。 你将会看到一个包含交易时间、价格、数量等信息的列表。

注意事项:

• 签名机制详解： Bitfinex API 的签名过程涉及多种加密算法和请求参数的精确构造，务必认真研读官方 API 文档，理解签名所需的 nonce 生成、请求体序列化、HMAC-SHA384 算法应用等关键步骤。特别关注不同 API 端点对签名参数的特定要求，避免因签名错误导致请求失败。建议参考官方提供的示例代码或使用经过验证的第三方库进行签名操作。
• 交易对格式规范： Bitfinex 使用特定的交易对格式，必须以字母 t 开头，后跟币种和计价货币的代码。例如，比特币兑美元的交易对表示为 tBTCUSD 。如果交易对格式不正确，API 将无法识别并返回错误。请确保在所有 API 请求（如查询价格、下单等）中正确使用交易对格式。 可以通过API接口查询支持的交易对列表。
• 频率限制策略： Bitfinex 对 API 请求的频率有限制，旨在防止滥用和维护系统稳定性。超出频率限制的请求可能会被拒绝，导致程序运行中断。务必在代码中实现频率控制逻辑，例如使用令牌桶算法或漏桶算法来平滑请求速率。关注 API 文档中关于不同端点的具体频率限制说明，并根据实际情况进行调整。建议在开发阶段进行充分的压力测试，以确保程序在真实环境中能够稳定运行。
• API密钥安全： Bitfinex API 密钥是访问您账户的重要凭证，务必妥善保管，避免泄露。不要将 API 密钥存储在公开的代码仓库或不安全的文件中。建议使用环境变量或加密配置文件来存储 API 密钥，并在程序启动时动态加载。定期更换 API 密钥，以提高安全性。启用双因素认证 (2FA) 可进一步增强账户安全。
• 错误处理机制： 在调用 Bitfinex API 时，可能会遇到各种错误，例如网络连接问题、API 密钥无效、参数错误等。务必在代码中实现完善的错误处理机制，捕获并处理这些错误。根据 API 返回的错误代码和错误信息，进行相应的处理，例如重试请求、记录日志、发送告警等。避免程序因未处理的错误而崩溃。
• WebSocket 连接维护： 如果使用 Bitfinex 的 WebSocket API 进行实时数据订阅，需要维护与服务器的持久连接。网络不稳定或服务器故障可能会导致连接中断。务必在代码中实现自动重连机制，并在连接断开后重新订阅所需的数据。定期发送心跳包，以保持连接活跃。

2. 利用第三方库简化API交互

为了简化与Bitfinex API的交互过程，开发者可以考虑使用第三方库。这些库通常封装了API的请求和响应处理，提供了更友好的接口，从而降低开发难度和提高效率。

例如， bitfinex-api-py 是一个Python库，专门用于与Bitfinex API进行交互。它提供了诸如获取市场数据、下单、管理账户等功能，使得开发者可以使用更简洁的代码完成复杂的操作。

重要提示： 在选择和使用第三方库时，务必进行充分的评估。评估内容包括：

• 库的维护情况： 检查库的更新频率和维护者是否活跃，以确保bug能及时修复和功能得到持续改进。
• 代码质量和安全性： 审查库的代码，了解其实现方式，避免引入潜在的安全风险。
• 社区支持： 了解库的社区活跃度，是否有足够的用户和开发者提供支持和帮助。
• 文档完整性： 确保库提供清晰、完整的文档，方便开发者理解和使用。

不建议直接使用来源不明或缺乏维护的第三方库，因为这可能会导致安全漏洞或兼容性问题。在使用前，务必进行充分的测试和验证，确保其满足您的需求并符合安全标准。 还需要注意第三方库的版本兼容性问题，确保与您的项目环境相匹配。

3. 通过Bitfinex报告功能导出交易历史

Bitfinex平台内置了报告生成功能，旨在帮助用户便捷地导出其交易历史记录。用户可以通过其直观的用户界面，指定所需的时间范围，生成包含详细交易信息的CSV格式文件。此方法的优点在于操作简便，无需编写复杂的代码。然而，相较于API接口，其自动化程度较低，更适用于偶尔的数据导出需求。用户需登录Bitfinex账户，在报告页面选择相应的参数，如下载时间段、报告类型等，然后平台会自动生成相应的报告文件。

Bitfinex的报告功能可能存在数据延迟，特别是对于高频交易者。导出的数据可能需要进一步处理，才能满足特定的分析需求。用户应仔细核对导出的数据，确保其准确性和完整性，避免因数据错误而导致分析偏差。考虑到数据安全，建议在导出报告后，妥善保管CSV文件，防止泄露个人交易信息。用户在利用报告功能获取交易数据时，应留意Bitfinex官方发布的最新使用指南和注意事项，以确保操作的正确性和安全性。