如何使用Bitfinex的API查询帐户余额？

使用BitFinex的API来查询帐户余额，通过使用API​​键进行身份验证，构建对/v2/auth/r/钱包的POST请求以及解析JSON响应。

2025/04/13 15:21

如何使用Bitfinex的API查询帐户余额？

Bitfinex是领先的加密货币交换之一，提供了强大的API，允许用户编程与其平台进行交互。用户执行的最常见操作之一是查询帐户余额。本文将指导您完成使用Bitfinex的API检查您的帐户余额的过程，以确保您可以有效，安全地管理资金。

了解Bitfinex的API身份验证

在查询帐户余额之前，您需要了解如何验证API请求。 Bitfinex使用API​​键和签名的组合来确保安全访问您的帐户。

• 生成API键：登录您的BitFinex帐户，导航到API部分，然后生成新的API密钥。确保为阅读帐户余额提供必要的权限。
• API密钥和秘密：您将收到一个API密钥和一个秘密密钥。保持秘密密钥安全，永远不要分享。
• 创建签名：对于每个API请求，您需要使用秘密键创建一个签名。签名是通过使用秘密密钥哈希请求有效载荷生成的。

建立您的开发环境

要与Bitfinex的API进行互动，您需要设置开发环境。这是这样做的方法：

• 选择一种编程语言：Bitfinex的API可以与各种编程语言一起使用。流行的选择包括Python，JavaScript和Ruby。
• 安装所需的库：例如，如果选择Python，则可以使用requests库来制作HTTP请求， hmac以及hashlib来创建签名。
• 设置API凭据：将API密钥和秘密密钥存储在您的开发环境中。

构建API请求

要查询您的帐户余额，您需要将API请求构建到适当的端点。为此，BitFinex提供/v2/auth/r/wallets端点。

• 端点： https://api.bitfinex.com/v2/auth/r/wallets
• HTTP方法： POST
• 有效载荷：用于此请求的空数组[] 。

创建签名

创建签名是对您的请求进行身份验证的关键步骤。这是这样做的方法：

• 时间戳：以毫秒为单位生成时间戳。该时间戳必须包含在有效载荷中。
• NONCE ：使用时间戳作为NONCE来确保请求是唯一的。
• 有效载荷：通过串联API路径和JSON编码有效载荷来构建有效载荷。
• 签名：使用HMAC-SHA384算法使用您的秘密钥匙和有效载荷创建签名。

这是如何在Python中创建签名的示例：

 import time
 import json
 import hmac
 import hashlib api_key ='your_api_key'
 api_secret ='your_api_secret'







产生时间戳和nonce
时间戳= str（int（time.time（） * 1000））
 nonce =时间戳






构建有效载荷
有效载荷='/api/v2/auth/r/钱包' + json.dumps（[]）






创建签名
signature = hmac.new（api_secret.encode（），payload.encode（），hashlib.sha384）.hexdigest（）

发送API请求

构建有效载荷并创建签名后，您可以发送API请求。这是在Python中做到这一点的方法：

• 标题：在请求的标题中包括API键，签名和NON。
• 发送请求：使用requests库将邮政请求发送到端点。

这是如何在Python发送请求的示例：

 import requests url ='https://api.bitfinex.com/v2/auth/r/wallets'







标题= {






'bfx-nonce': nonce, 'bfx-apikey': api_key, 'bfx-signature': signature
 }
 
响应= requests.post（url，headers =标题，data = json.dumps（[]））
 
如果响应。STATUS_CODE== 200：
 
print(response.json())
别的：
 
print('Error:', response.status_code, response.text)
解析响应
发送请求后，您需要解析响应以提取您的帐户余额。 Bitfinex的响应将以JSON格式为JSON，其中包含一系列钱包对象。
 
钱包对象：每个钱包对象都包含货币，平衡和类型的信息（例如，交换或边距）。
提取余额：通过数组迭代以提取每种货币的余额。
这是如何解析python中的响应的一个示例：
 
wallets = response.json()
对于钱包中的钱包：
 
currency = wallet[1] balance = wallet[2] print(f'Currency: {currency}, Balance: {balance}')
处理错误和边缘案件
查询帐户余额时，处理潜在错误和边缘案例很重要：
 
API速率限制：BitFinex在API请求上具有速率限制。确保您不会超过这些限制以避免被阻塞。
身份验证错误：如果您的签名或非CE不正确，则会收到身份验证错误。仔细检查您的身份验证过程。
网络问题：准备处理与网络相关的问题，例如超时或连接错误。
常见问题
问：我可以使用相同的API密钥查询多个帐户的帐户余额吗？
 
答：不，每个API键都与一个帐户绑定。要查询多个帐户的余额，您需要为每个帐户生成单独的API键。
 
问：我多久可以使用Bitfinex的API查询一次帐户余额？
 
答：Bitfinex对API请求施加了速率限制。您通常可以每分钟最多弥补90个请求，但是最好检查Bitfinex API文档中的当前限制。
 
问：当查询帐户余额时遇到身份验证错误，该怎么办？
 
答：身份验证错误通常是由于签名或非CE值不正确而发生的。确保您的时间戳准确，并使用正确的秘密键来生成签名。如果问题仍然存在，请重新生成您的API键，然后重试。
 
问：我可以使用Bitfinex的API实时查询帐户余额吗？
 
答：Bitfinex的API不提供帐户余额的实时流。您需要定期向/v2/auth/r/wallets端点提出请求，以获得最新的余额。