Bitfinex API配置详解：入门到精通的实用指南

bash pip install requests websocket-client

bash pip install bitfinex-api-py

apikey = "YOURAPIKEY" apisecret = "YOURAPISECRET"

endpoint = "/v1/balances" url = "https://api.bitfinex.com" + endpoint

创建 Payload (用于身份验证请求)

在进行身份验证的API请求时，需要创建一个包含必要信息的Payload。其中， nonce 是一个至关重要的参数，用于防止重放攻击。它通常是一个单调递增的数值，确保每个请求的唯一性。

nonce = str(int(round(time.time() * 1000))) 这行代码生成了一个基于当前时间的毫秒级时间戳作为 nonce 。 time.time() 返回当前时间的秒数，乘以1000将其转换为毫秒， round() 函数进行四舍五入取整， int() 函数将结果转换为整数，最后 str() 函数将其转换为字符串类型。使用毫秒级的时间戳可以提供更高的精度和更低的重复概率。

payload = { "request": endpoint, "nonce": nonce } 这段代码定义了Payload的内容。 request 字段指定了请求的API端点 ( endpoint )， nonce 字段包含了刚刚生成的时间戳。Payload的内容会根据具体的API接口需求而有所不同，但通常会包含请求所需的所有参数。

payload_ = .dumps(payload) 使用 .dumps() 函数将Python字典 ( payload ) 转换为JSON字符串。JSON (JavaScript Object Notation) 是一种轻量级的数据交换格式，易于阅读和解析，被广泛应用于Web API中。转换成JSON字符串是为了方便后续的编码和签名操作。

payload_base64 = base64.b64encode(payload_.encode('utf-8')) 对JSON字符串进行Base64编码。使用 encode('utf-8') 将JSON字符串编码为UTF-8字节串。然后，使用 base64.b64encode() 函数对字节串进行Base64编码。Base64编码将任意二进制数据转换为ASCII字符串，使其可以在HTTP等文本协议中安全传输。Base64编码后的数据用于生成数字签名。

数字签名用于验证请求的完整性和身份。以下代码使用HMAC-SHA384算法生成签名。

signature = hmac.new( api_secret.encode('utf-8'), payload_base64, hashlib.sha384 ).hexdigest() 这段代码使用API密钥 ( api_secret ) 和Base64编码后的Payload ( payload_base64 ) 生成HMAC-SHA384签名。 hmac.new() 函数创建一个HMAC对象，第一个参数是密钥（需要编码为UTF-8字节串），第二个参数是要签名的数据，第三个参数是哈希算法 ( hashlib.sha384 )。 hexdigest() 方法将签名转换为十六进制字符串。API密钥必须妥善保管，避免泄露。

headers = { "bfx-apikey": api_key, "bfx-signature": signature, "bfx-nonce": nonce } 定义HTTP请求头。 bfx-apikey 字段包含API密钥， bfx-signature 字段包含生成的签名， bfx-nonce 字段包含用于生成签名的nonce值。这些请求头用于向服务器验证客户端的身份，确保只有授权的用户才能访问API。

response = requests.post(url, headers=headers, data=payload_) 使用 requests.post() 函数发送POST请求。 url 指定了API端点， headers 包含了身份验证信息， data 包含了JSON格式的Payload。根据API接口的不同，可能需要使用不同的HTTP方法 (例如 GET, PUT, DELETE)。

if response.status_code == 200: balances = response.(); print(balances) else: print(f"Error: {response.status_code} - {response.text}") 处理API响应。检查HTTP状态码是否为200 (表示成功)。如果成功，使用 response.() 函数将JSON响应解析为Python字典，并打印结果。如果状态码不是200，则打印错误信息，包括状态码和响应内容。通过检查状态码和响应内容，可以帮助开发者诊断和解决API调用中的问题。

def on_message(ws, message): print(message)

def on_error(ws, error): print(error)

def on_close(ws): print("### closed ###")

def onopen(ws): authpayload = { "apiKey": apikey, "event": "auth", "nonce": str(int(round(time.time() * 1000))), "signature": hmac.new( apisecret.encode('utf-8'), str(int(round(time.time() * 1000))).encode('utf-8'), hashlib.sha384 ).hexdigest() } ws.send(.dumps(authpayload)) # Subscribe to a channel (e.g., trades for BTCUSD) subscribepayload = { "event": "subscribe", "channel": "trades", "symbol": "tBTCUSD" } ws.send(.dumps(subscribe_payload))

ws = websocket.WebSocketApp("wss://api.bitfinex.com/ws/2", onmessage = onmessage, onerror = onerror, onclose = onclose) ws.onopen = onopen ws.run_forever()