如何使用BitFinex的REST API？

Bitfinex的REST API使您可以通过编程方式进行交易，获取市场数据并管理您的帐户；本指南提供了有效使用的步骤和示例。

2025/04/14 03:35

使用BitFinex的REST API使您可以通过编程交互方式进行交流，从而使您可以执行诸如交易，检索市场数据和管理帐户之类的任务。本指南将引导您完成基本步骤，并提供有关如何有效使用Bitfinex的REST API的详细说明。

Bitfinex的REST API入门

在开始使用Bitfinex的REST API之前，您需要设置一个API键。为此，请执行以下步骤：

• 登录到您的Bitfinex帐户。
• 导航到“帐户”部分，然后选择“ API”。
• 单击“新密钥”以生成新的API键。
• 选择要授予键的权限，例如交易，提款或仅阅读访问权限。
• 确认键的创建，并安全地存储API密钥和秘密。

拥有API密钥和秘密后，您可以开始向Bitfinex REST API提出请求。 API使用HTTPS并支持JSON进行数据交换。

身份验证和安全性

身份验证对于确保您的API相互作用至关重要。 Bitfinex使用API​​键的组合和使用API​​秘密生成的签名。这是对您的请求进行身份验证的方法：

• 生成一个nonce ：一个确保每个请求都是唯一的唯一数字。这可以是时间戳或增加整数。
• 创建有效载荷：将API路径，NONCE和任何其他参数组合到JSON对象中。
• 生成签名：使用您的API秘密使用HMAC-SHA384算法来签名有效载荷。
• 包括标题：将API键，有效载荷和签名添加到您的请求标题中。

这是如何在Python中创建必要标题的示例：

 import time
 import json
 import hmac
 import hashlib api_key ='your_api_key'
 api_secret ='your_api_secret'.encode（）







生成nonce
 nonce = str（int（time.time（） * 1000））






创建有效载荷
有效载荷= {






'request': '/v1/balance', 'nonce': nonce
 }
 
将有效载荷转换为JSON并编码
payload_json = json.dumps（有效载荷）.encode（）
 
生成签名
签名= hmac.new（api_secret，payload_json，hashlib.sha384）.hexdigest（）
 
准备标题
标题= {
 
'X-BFX-APIKEY': api_key, 'X-BFX-PAYLOAD': payload_json.decode(), 'X-BFX-SIGNATURE': signature
 }

提出API请求

有了身份验证，您现在可以提出Bitfinex的REST API请求。这是一些常见的终点以及如何使用它们：

• 检索帐户余额：使用/v1/balances端点检查您的帐户余额。

 import requests url ='https://api.bitfinex.com/v1/balances'
响应= requests.get（url，标头=标题）
打印（response.json（））

• 下订单：使用/v1/order/new端点下订单。您需要指定符号，金额，价格和订单类型。

 payload = { 'request': '/v1/order/new', 'nonce': nonce, 'symbol': 'btcusd', 'amount': '0.01', 'price': '10000', 'exchange': 'bitfinex', 'type': 'exchange limit', 'side': 'buy'

}

payload_json = json.dumps（有效载荷）.encode（）
签名= hmac.new（api_secret，payload_json，hashlib.sha384）.hexdigest（）

标题= {

'X-BFX-APIKEY': api_key, 'X-BFX-PAYLOAD': payload_json.decode(), 'X-BFX-SIGNATURE': signature

}

url ='https://api.bitfinex.com/v1/order/new'
响应= requests.post（url，标头=标题）
打印（response.json（））

• 检索市场数据：使用/v1/pubticker端点获取特定交易对的当前股票。

 url = 'https://api.bitfinex.com/v1/pubticker/btcusd'
 response = requests.get(url)
 print(response.json())

处理错误和响应

使用BitFinex REST API时，正确处理错误并正确解释响应很重要。这里有一些提示：

• 检查HTTP状态代码：200个状态代码表示成功的请求，而其他代码表示错误。
• 解析响应JSON ：响应将包含带有请求的数据或错误消息的JSON对象。
• 常见错误代码：熟悉常见错误代码，例如400（不良请求），401（未经授权）和500（内部服务器错误）。

这是如何处理Python中错误的示例：

 import requests url ='https://api.bitfinex.com/v1/balances'
响应= requests.get（url，标头=标题）







如果响应。STATUS_CODE== 200：






print('Request successful:', response.json())
别的：
 
print('Error:', response.status_code, response.text)
使用Websocket进行实时数据
虽然REST API适用于许多任务，但使用WebSockets可以提供实时数据更新。要连接到Bitfinex的Websocket API，请按照以下步骤：
 
建立Websocket连接：使用Python中的websocket-client类的WebSocket库。
 import websocket
 ws = websocket.websocket（）
 ws.connect（'wss：//api-pub.bitfinex.com/ws/2'）

• 订阅频道：发送JSON消息以订阅特定渠道，例如股票或订单簿更新。

 subscribe_msg = { 'event': 'subscribe', 'channel': 'ticker', 'symbol': 'tBTCUSD'

}

ws.send（json.dumps（subscribe_msg））

• 流程传入消息：解析传入的JSON消息以处理实时数据。

 result = ws.recv()
 print(result)

管理API率限制

Bitfinex对API请求施加了限制，以防止滥用。有效地管理这些限制：

• 了解限制：Bitfinex对于身份验证和未经身份验证的请求具有不同的速率限制。经认证的请求通常限制为每分钟90个请求。
• 在您的代码中实现速率限制：使用Python中的ratelimit之类的库来确保您保持范围。

 from ratelimit import limits, sleep_and_retry @sleep_and_retry
 @limits（呼叫= 90，周期= 60）
 def call_api（）：







# Make your API call here pass
使用该功能
call_api（）

常见问题

问：我可以使用Bitfinex的REST API来自动交易策略吗？

答：是的，您可以使用REST API通过编程下订单，检查余额和检索市场数据来自动化交易策略。确保您实施适当的错误处理和限制费率以保持稳定的交易环境。

问：是否可以使用Bitfinex REST API提取资金？

答：是的，您可以使用/v1/withdraw端点提取资金。您需要指定提款方法，金额和地址。确保您在API密钥上具有必要的权限以执行提款。

问：如何在不影响我的实时帐户的情况下测试我的API请求？

答：BitFinex提供了测试网络环境，您可以在其中测试API请求而不会影响您的实时帐户。您可以注册一个TestNet帐户，并使用TestNet API端点来模拟交易和其他操作。

问：如果遇到身份验证错误，该怎么办？

答：如果遇到身份验证错误，请仔细检查API密钥，秘密和签名生成过程。确保每个请求的nonce都是唯一的，并且有效载荷正确格式化。如果问题持续存在，请考虑再生您的API密钥和秘密。