BigONE账户余额查询终极指南：从新手到专家的全方位解析

• 可用余额： 指的是你可以立即用于交易或提现的币种数量。
• 冻结余额： 指的是由于挂单、锁仓或其他原因暂时无法使用的币种数量。
• 总余额： 指的是可用余额和冻结余额的总和。

import requests import hashlib import hmac import time

替换为你的 API Key 和 Secret Key

在进行任何涉及账户操作或数据访问的交易之前，务必将代码中的占位符 API Key 和 Secret Key 替换为你自己从交易所或服务提供商处获得的真实密钥。API Key 用于标识你的身份，Secret Key 则用于安全地签署交易请求，确保只有你才能执行相关操作。

请按照以下格式替换 api_key 和 secret_key 变量：

api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"

重要提示：

• 务必妥善保管你的 Secret Key，切勿将其泄露给他人。
• 不要将 API Key 和 Secret Key 存储在公共代码仓库中，如 GitHub。
• 建议使用环境变量或其他安全的方式来管理你的密钥。
• 定期更换你的 API Key 和 Secret Key，以提高安全性。
• 启用交易所提供的双重身份验证（2FA），进一步保护你的账户。

请注意，API Key 通常具有不同的权限级别。某些 API Key 可能只允许读取数据，而其他 API Key 则允许进行交易。请根据你的需求选择合适的 API Key，并仔细阅读交易所或服务提供商的 API 文档，了解 API Key 的具体权限和使用限制。

错误地使用 API Key 可能会导致资金损失或账户被盗。在使用 API Key 之前，请务必仔细阅读相关的安全指南和最佳实践。

构建请求参数

在与BigONE API交互时，构建正确的请求参数至关重要。以下步骤详细说明了如何构建一个有效的请求，并提供了示例代码片段。

Endpoint ：API的访问地址。例如： endpoint = "https://api.big.one/asset/v3/accounts" 。此URL指向资产管理的v3版本API接口，用于检索账户信息。确保Endpoint的准确性，避免因URL错误导致的请求失败。

Timestamp ：发送请求时的时间戳，通常以Unix时间（自1970年1月1日午夜UTC以来的秒数）表示。获取当前时间戳的代码示例如下： timestamp = str(int(time.time())) 。时间戳用于验证请求的时效性，防止重放攻击。确保服务器时间与本地时间同步，避免因时间戳偏差过大导致请求被拒绝。

HTTP Method ：指定HTTP请求的方法，例如GET、POST、PUT、DELETE等。此示例中使用GET方法： method = "GET" 。根据API接口的要求选择合适的方法。GET通常用于获取资源，POST用于创建资源，PUT用于更新资源，DELETE用于删除资源。

Path ：API Endpoint中除去域名部分，表示请求的具体资源路径。例如： path = "/asset/v3/accounts" 。此路径对应于API的功能模块。确保路径与API文档一致。

Query String ：如果API需要查询参数，则需要构建Query String。Query String是由一系列键值对组成的字符串，用于向API传递参数。例如： query_string = "" 。如果需要传递参数，Query String的格式应为 key1=value1&key2=value2 。将Query String附加到URL的末尾，用 ? 分隔。 例如： /asset/v3/accounts?currency=BTC 。

构建签名

为了保障API请求的安全性，需要对请求进行签名。签名过程涉及将请求的关键要素组合成一个消息字符串，然后使用密钥和哈希算法对该字符串进行加密。

构建签名的具体步骤如下：

1. 构造消息字符串： 消息字符串由时间戳（timestamp）、HTTP方法（method）、请求路径（path）和查询字符串（query_string）组成，各部分之间用换行符（ \n ）分隔。时间戳用于防止重放攻击，HTTP方法表明请求的类型（如GET、POST），请求路径指定了API端点，查询字符串包含了请求参数。
2. 计算签名： 使用HMAC-SHA384算法对消息字符串进行哈希运算。HMAC（Hash-based Message Authentication Code）是一种消息认证码算法，它使用密钥来生成哈希值，从而验证数据的完整性和来源。SHA384是一种安全哈希算法，产生384位的哈希值。
3. 编码： 在进行哈希运算前，需要使用UTF-8编码将密钥（secret_key）和消息字符串转换为字节串。UTF-8是一种通用的字符编码，可以表示世界上大多数语言的字符。哈希运算的结果通常是十六进制字符串。

以下Python代码演示了如何构建签名：

import hmac
import hashlib
import time
import urllib.parse

timestamp = str(int(time.time()))  # 获取当前时间戳
method = 'GET'  # HTTP方法，例如 GET, POST
path = '/v1/user/info'  # API 请求路径
params = {'param1': 'value1', 'param2': 'value2'}  # 请求参数
query_string = urllib.parse.urlencode(params) # 将参数编码为查询字符串
secret_key = 'your_secret_key'  # 你的密钥

message = f"{timestamp}\n{method}\n{path}\n{query_string}"
signature = hmac.new(secret_key.encode('utf-8'), message.encode('utf-8'), hashlib.sha384).hexdigest()

代码解释：

• timestamp : 使用 time.time() 获取当前Unix时间戳，并转换为字符串。
• method : 设置为所需的HTTP方法。
• path : 设置为API的请求路径。
• query_string : 使用 urllib.parse.urlencode() 将请求参数字典编码为URL查询字符串。
• secret_key : 替换为你自己的密钥。
• message : 将时间戳、HTTP方法、请求路径和查询字符串组合成消息字符串。
• signature : 使用 hmac.new() 创建HMAC对象，并指定密钥、消息和哈希算法（SHA384）。然后，调用 hexdigest() 方法获取十六进制表示的签名。

签名生成后，通常将其作为请求头或查询参数发送到API服务器。服务器将使用相同的密钥和算法重新计算签名，并与接收到的签名进行比较，以验证请求的真实性和完整性。

构建请求头

为了确保API请求的有效性和安全性，需要构建包含特定信息的请求头。以下是一个示例，展示了如何使用必要的字段来构造 headers 字典：

headers = {
    "Content-Type": "application/",
    "ONE-API-KEY": api_key,
    "ONE-TIME": timestamp,
    "ONE-SIGN": signature
}

字段解释：

• Content-Type : 指定请求体的MIME类型。这里设置为 application/ ，表明请求体将使用JSON格式进行编码。 其他常见的类型包括 application/x-www-form-urlencoded （用于表单数据）和 multipart/form-data （用于文件上传）。选择正确的 Content-Type 对于API服务器正确解析请求至关重要。
• ONE-API-KEY : 用于身份验证的API密钥。 请务必妥善保管您的API密钥，避免泄露，防止未经授权的访问。 api_key 变量应替换为您实际的API密钥字符串。
• ONE-TIME : 时间戳，通常以Unix时间（自1970年1月1日UTC以来的秒数）表示。 时间戳用于防止重放攻击。 timestamp 变量应替换为当前时间的时间戳。 服务器端通常会验证时间戳的有效性，例如，拒绝时间戳超过一定时限的请求。
• ONE-SIGN : 请求签名，用于验证请求的完整性和真实性。 签名通常通过对请求的某些部分（例如，请求体、API密钥、时间戳）进行哈希运算生成。 signature 变量应替换为根据特定签名算法计算出的签名字符串。签名算法的具体实现取决于API提供商的要求，常见的算法包括HMAC-SHA256。

重要提示：

• 确保替换示例代码中的 api_key , timestamp 和 signature 为实际的值。
• 根据API的具体要求，可能需要包含其他自定义的请求头字段。请参考API文档以获取完整的信息。
• 在生产环境中，应使用安全的方式管理API密钥，例如，使用环境变量或密钥管理服务。

发送请求

使用Python的 requests 库向指定的API端点发送GET请求。此操作通过调用 requests.get() 函数实现，该函数接收两个关键参数： endpoint 和 headers 。

endpoint 参数是一个字符串，表示API的URL地址。这个URL精确地指向服务器上提供的特定资源或功能。例如，它可能是一个用于检索特定用户信息的地址，或者是一个用于获取实时市场数据的地址。请确保URL的格式正确，包括协议（例如 https:// ）和任何必要的查询参数。

headers 参数是一个字典，用于设置HTTP请求头。请求头可以包含诸如 Content-Type （指定请求体的MIME类型）、 Authorization （用于身份验证，例如Bearer token）以及 User-Agent （标识发起请求的客户端）等信息。正确的请求头对于API服务器正确处理请求至关重要，特别是对于需要身份验证或特定内容类型的API。

response = requests.get(endpoint, headers=headers) 这行代码执行实际的HTTP GET请求，并将服务器的响应存储在名为 response 的变量中。该 response 对象包含了服务器返回的所有信息，包括状态码、响应头和响应体。后续步骤将分析此响应对象，以确定请求是否成功，并提取所需的数据。

在发送请求前，请确保已正确安装 requests 库。可以使用 pip install requests 命令进行安装。同时，注意处理可能出现的网络异常，例如连接超时或DNS解析错误。适当的错误处理机制可以提高程序的健壮性。

处理响应

收到服务器响应后，需要对其进行处理以提取所需信息或诊断潜在问题。以下代码展示了如何根据HTTP状态码来处理响应：

if response.status_code == 200:
    # HTTP 状态码 200 表示请求成功
    try:
        data = response.()  # 尝试将响应内容解析为 JSON 格式
        print(data)  # 打印解析后的 JSON 数据，通常包含账户余额等信息
    except .JSONDecodeError:
        print("Error: 响应内容不是有效的 JSON 格式") #提示JSON解析错误
        print(response.text) # 打印原始响应文本，便于调试
except AttributeError as e:
    print(f"Error: 'response' 对象缺少必要属性或方法: {e}")#捕获response对象可能的属性错误
else:
    # 处理非 200 的 HTTP 状态码，表示请求失败
    print(f"Error: {response.status_code} - {response.text}") # 打印错误状态码和错误信息，帮助定位问题

代码详解：

• response.status_code == 200 ：检查HTTP状态码是否为200，200代表请求成功。
• response.() ：尝试将响应内容解析为JSON格式，适用于API返回JSON数据的情况。如果响应不是JSON格式，会抛出 .JSONDecodeError 异常。
• try...except 块：用于捕获JSON解析错误，并提供备选方案（打印原始响应文本）以便调试。同时，捕获response对象可能缺失属性的错误，提供更全面的错误处理。
• response.text ：获取原始的响应文本，用于打印错误信息或在无法解析JSON时进行调试。
• 当状态码不是200时，会打印包含状态码和错误信息的错误消息，便于快速定位问题。