如何用Python玩转币安API？新手也能快速上手！

2025-03-06 区块链 44℃

币安交易所的API接口怎么使用

币安（Binance）交易所提供了一套强大的应用程序编程接口（API），允许开发者以编程方式访问其平台上的各种功能，例如交易、账户信息管理、市场数据获取等等。通过API，开发者可以创建自动化交易机器人、分析工具、投资组合管理系统等。本文将深入探讨如何使用币安的API接口，包括必要的准备工作、身份验证、常用API调用以及一些最佳实践。

准备工作

在使用币安API之前，为了确保交易的顺利进行和账户的安全，需要完成以下准备工作，这些步骤至关重要，不容忽视：

注册币安账户: 如果您尚未拥有币安账户，请访问币安官方网站（www.binance.com）进行注册。注册过程中，请务必使用安全强度高的密码，并仔细阅读并同意用户协议和隐私政策。验证您的电子邮件地址和手机号码是注册过程中的关键步骤，有助于日后账户的安全管理。
开启两步验证 (2FA): 为了最大程度地提升账户安全，强烈建议您启用两步验证。币安支持多种2FA方式，例如Google Authenticator、短信验证以及YubiKey等硬件安全密钥。Google Authenticator 是一种常用的选择，它通过生成动态验证码来增强账户的安全性。设置 2FA 后，每次登录或进行敏感操作时，都需要输入验证码，有效防止未经授权的访问。
创建API密钥: 登录您的币安账户后，导航至用户中心，找到“API 管理”页面。在此页面，您可以创建新的API密钥。创建API密钥时，至关重要的是要仔细设置密钥的权限，包括但不限于只读权限、交易权限、提币权限等。务必根据您的实际需求授予API密钥最小必要的权限，以避免潜在的安全风险。请注意，提币权限应谨慎使用，仅在绝对必要时才开启，并设置提币白名单，限制提币地址，进一步保障资金安全。
- API Key: 这是您的公共密钥，类似于用户名，用于标识您的API请求。API Key 并非敏感信息，可以随请求发送。
- Secret Key: 这是您的私有密钥，相当于密码，用于对API请求进行签名。这是高度敏感的信息，请务必妥善保管您的Secret Key，切勿泄露给任何第三方。任何拥有您的 Secret Key 的人都可以模拟您的操作，造成不可挽回的损失。建议定期更换 Secret Key，并启用IP限制，只允许特定的IP地址访问您的API Key。
选择编程语言和库: 根据您的编程技能和项目需求，选择一种合适的编程语言（例如Python, Java, JavaScript, C#等）以及相应的HTTP请求库。对于Python，常用的库包括 requests 、 aiohttp （异步请求库）和 ccxt 。 ccxt （CryptoCurrency eXchange Trading Library）是一个强大的、专门用于加密货币交易所的统一交易API库，它支持众多交易所，并提供了一致的接口，可以极大地简化与不同交易所API的交互过程。还可以考虑使用 binance-connector ，它是币安官方提供的Python库，提供了更底层的API接口，可以更灵活地控制请求参数和处理响应数据。在选择库时，请仔细阅读其文档，了解其功能和限制，并选择最适合您需求的库。

身份验证

币安API采用API Key和Secret Key机制进行身份验证，以此确保只有授权用户才能访问账户数据和执行交易操作。为了保证请求的安全性和完整性，每个API请求都必须经过签名验证。有效的签名是币安服务器验证请求来源和数据完整性的关键。

构建查询字符串: 需要将所有请求参数按照字母顺序进行排序。排序是基于参数名称的ASCII码值。然后，将排序后的参数及其对应的值以 parameter=value 的形式连接成一个字符串。多个参数之间使用 & 符号进行分隔。例如，如果请求包含参数 symbol=BTCUSDT 和 side=BUY ，正确的排序和连接后的字符串应为 side=BUY&symbol=BTCUSDT 。这一步是生成正确签名的基础，顺序错误会导致签名验证失败。特殊字符（如空格）需要进行URL编码，确保符合HTTP请求规范。
使用HMAC-SHA256算法签名: 使用您的Secret Key作为密钥，对上一步构建的查询字符串执行HMAC-SHA256哈希运算。HMAC-SHA256算法是一种消息认证码算法，通过密钥与消息内容结合生成唯一的哈希值。Secret Key必须妥善保管，泄露会导致账户安全风险。不同的编程语言都提供了相应的HMAC-SHA256库或函数，例如Python中的 hmac 模块。该算法的安全性基于Secret Key的保密性，以及SHA256算法本身的抗碰撞性。
将签名添加到请求头和查询字符串: 生成的HMAC-SHA256签名需要添加到两个位置：请求头和查询字符串。将签名添加到请求头中，HTTP头字段名为 X-MBX-APIKEY ，其对应的值设置为您的API Key。将签名也添加到查询字符串中，参数名为 signature ，其对应的值设置为计算得到的HMAC-SHA256哈希值。同时将API Key添加到Header也是一种身份验证的方式。正确的将两者都添加，服务端才能验证请求的合法性。

以下是一个Python示例，演示如何计算签名并创建带签名的API请求：

import hashlib import hmac import urllib.parse

def generate_signature(secret_key, query_string): """ 使用Secret Key对查询字符串进行签名。

    Args:
        secret_key (str): 你的Secret Key.
        query_string (str): 查询字符串.

    Returns:
        str: HMAC-SHA256签名.


  hashed = hmac.new(secret_key.encode('utf-8'), query_string.encode('utf-8'), hashlib.sha256)
    return hashed.hexdigest()

def create_api_request(api_key, secret_key, endpoint, params): """ 创建带签名的API请求。

    Args:
        api_key (str): 你的API Key.
        secret_key (str): 你的Secret Key.
        endpoint (str): API端点.
        params (dict): 请求参数.

    Returns:
        tuple: (url, headers) 元组，包含完整的URL和请求头.


  # 将参数按照字母顺序排序并编码
    query_string = urllib.parse.urlencode(sorted(params.items()))

    # 生成签名
    signature = generate_signature(secret_key, query_string)

    # 构建完整的URL
    url = f"https://api.binance.com/api/v3/{endpoint}?{query_string}&signature={signature}"

    # 构建请求头
    headers = {
        'X-MBX-APIKEY': api_key
    }

    return url, headers

示例用法

要开始使用API，请务必配置必要的身份验证凭据。以下代码段展示了如何设置API密钥和密钥，并构造API请求。

api_key = "YOUR_API_KEY" # 替换成你的API Key
secret_key = "YOUR_SECRET_KEY" # 替换成你的Secret Key
endpoint = "order"

API密钥（ api_key ）和密钥（ secret_key ）用于验证您的请求。请将 "YOUR_API_KEY" 和 "YOUR_SECRET_KEY" 替换为您从交易所或API提供商处获得的真实凭据。 endpoint 变量定义了您要访问的API的特定端点，在本例中是"order"端点，用于提交订单。

接下来，定义一个包含请求参数的字典。这些参数将根据您使用的特定API端点而有所不同。以下示例演示了如何创建一个市价买单。

params = {
"symbol": "BTCUSDT",
"side": "BUY",
"type": "MARKET",
"quantity": 0.001
}

此示例中， symbol 指定交易对（例如，BTCUSDT）， side 指定交易方向（"BUY"）， type 指定订单类型（"MARKET"）， quantity 指定要购买的BTC数量。请根据您的具体需求调整这些参数。

现在，使用 create_api_request 函数创建完整的API请求URL和必要的头部信息。

url, headers = create_api_request(api_key, secret_key, endpoint, params)

create_api_request 函数将使用提供的凭据、端点和参数构建完整的API请求，包括正确签名的头部信息，以确保请求的安全性。

您可以打印生成的URL和头部信息以进行检查：

print(f"URL: {url}")
print(f"Headers: {headers}")

要发送请求，可以使用 requests 库。确保您已安装该库：

import requests

然后，使用 requests.post 方法发送POST请求，并将URL和头部信息作为参数传递：

response = requests.post(url, headers=headers)

response 对象将包含服务器的响应。您可以检查响应状态代码以验证请求是否成功：

print(response.status_code)

状态代码 200 表示成功。任何其他状态代码都可能指示错误。您还可以打印响应的内容以查看服务器返回的数据：

print(response.())

常用API调用

币安API提供了大量的端点，用于访问不同的功能，涵盖现货、合约、杠杆等多种交易类型。以下是一些常用的API调用，并附带详细说明及Python代码示例，方便开发者快速上手：

获取服务器时间: /api/v3/time - 用于检查币安服务器时间，确保本地客户端时间与服务器时间同步，避免时间戳相关的错误。

此API端点非常简单，无需任何授权即可调用。

import requests

url = "https://api.binance.com/api/v3/time"
response = requests.get(url)
print(response.())

获取账户信息: /api/v3/account - 获取账户的余额、交易历史、持仓信息等。需要API Key和签名。注意：必须启用现货交易权限。

获取账户信息需要提供API Key和Secret Key，并通过HMAC SHA256算法进行签名验证，以确保请求的安全性。

import requests
import time
import hashlib
import hmac

api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"
endpoint = "/api/v3/account"

def create_api_request(api_key, secret_key, endpoint, params):
    params['timestamp'] = int(time.time() * 1000)
    query_string = '&'.join([f"{k}={v}" for k, v in params.items()])
    signature = hmac.new(secret_key.encode('utf-8'), query_string.encode('utf-8'), hashlib.sha256).hexdigest()
    params['signature'] = signature
    url = f"https://api.binance.com{endpoint}?{query_string}"
    headers = {'X-MBX-APIKEY': api_key}
    return url, headers

params = {}
url, headers = create_api_request(api_key, secret_key, endpoint, params)

response = requests.get(url, headers=headers)
print(response.())

下单: /api/v3/order - 用于创建新的订单，包括市价单、限价单等。需要API Key和签名，且API密钥需要具有交易权限。

下单操作同样需要API Key和Secret Key进行签名验证，并根据不同的订单类型设置相应的参数，例如交易对(symbol)、方向(side)、类型(type)、数量(quantity)和价格(price，限价单需要)。

import time
import requests
import hashlib
import hmac

api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"
endpoint = "/api/v3/order"

def create_api_request(api_key, secret_key, endpoint, params):
    query_string = '&'.join([f"{k}={v}" for k, v in params.items()])
    signature = hmac.new(secret_key.encode('utf-8'), query_string.encode('utf-8'), hashlib.sha256).hexdigest()
    params['signature'] = signature
    url = f"https://api.binance.com{endpoint}"
    headers = {'X-MBX-APIKEY': api_key}
    return url, headers

params = {
    "symbol": "BTCUSDT",
    "side": "BUY",
    "type": "MARKET",
    "quantity": 0.001,
    "timestamp": int(time.time() * 1000)
}

url, headers = create_api_request(api_key, secret_key, endpoint, params)

response = requests.post(url, headers=headers, data=params)  # Use data=params for POST requests
print(response.status_code)
print(response.())

取消订单: /api/v3/order - 用于取消未成交的订单。需要API Key和签名。如果订单已经成交，则无法取消。

取消订单需要提供交易对(symbol)和订单ID(orderId)，并使用API Key和Secret Key进行签名验证。

import time
import requests
import hashlib
import hmac

api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"
endpoint = "/api/v3/order"

def create_api_request(api_key, secret_key, endpoint, params):
    query_string = '&'.join([f"{k}={v}" for k, v in params.items()])
    signature = hmac.new(secret_key.encode('utf-8'), query_string.encode('utf-8'), hashlib.sha256).hexdigest()
    params['signature'] = signature
    url = f"https://api.binance.com{endpoint}"
    headers = {'X-MBX-APIKEY': api_key}
    return url, headers


params = {
    "symbol": "BTCUSDT",
    "orderId": 12345,  # 替换成你的订单ID
    "timestamp": int(time.time() * 1000)
}

url, headers = create_api_request(api_key, secret_key, endpoint, params)

response = requests.delete(url, headers=headers, data=params)  # Use data=params for DELETE requests
print(response.status_code)
print(response.())

获取市场行情: /api/v3/ticker/price - 获取指定交易对的当前价格。无需API Key，公开API。

此API端点可以获取指定交易对的最新成交价格，无需任何授权即可调用。

import requests

url = "https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT"
response = requests.get(url)
print(response.())

最佳实践

安全第一: 务必妥善保管你的API Key和Secret Key，它们如同访问你账户的钥匙，一旦泄露将可能导致资产损失。切勿将这些密钥存储在不安全的地方，如版本控制系统或公共代码仓库。建议使用环境变量或专门的密钥管理工具进行安全存储。启用双因素认证（2FA）以增加额外的安全层。
限制权限: 创建API密钥时，遵循最小权限原则，只授予你的应用程序所需的最小权限集。例如，如果你的应用程序只需要读取市场数据，就不要授予交易权限。精细化地控制API密钥的权限，降低潜在的安全风险。审查并定期更新你的API密钥权限策略。
速率限制: 币安API为了保障系统稳定性和公平性，设置了速率限制，限制了单位时间内可以发送的请求数量。超出限制将会收到错误提示，影响应用程序的正常运行。仔细阅读官方文档，了解不同API端点的速率限制。实施适当的请求频率控制机制，避免触发速率限制。使用指数退避策略是一种常用的方法，当遇到速率限制错误时，延迟一段时间后重试，并逐渐增加延迟时间。
错误处理: 编写健壮且全面的错误处理代码至关重要，能够处理API返回的各种错误信息，例如网络错误、参数错误、身份验证错误等。记录错误日志，方便调试和问题排查。根据不同的错误类型，采取相应的处理措施，例如重试、通知用户或停止操作。
使用 ccxt 库: ccxt （CryptoCurrency eXchange Trading Library）是一个流行的Python库，它简化了与众多加密货币交易所API的交互，包括币安。 ccxt 库封装了复杂的API调用细节，自动处理签名、身份验证、速率限制等常见任务。它还提供了统一的接口，方便你切换到其他交易所或同时连接多个交易所。 ccxt 能够极大地提高开发效率，并减少代码量。
测试环境: 币安提供了一个模拟交易的测试环境（也称为沙盒环境），允许你在不使用真实资金的情况下测试你的交易策略和应用程序。利用测试环境，你可以验证代码的正确性、评估风险和性能，避免在实际交易中造成不必要的损失。熟悉测试环境的使用方法，并在上线前进行充分的测试。
阅读官方文档: 详细阅读币安API官方文档是使用API的前提。官方文档包含了API的最新信息，包括端点、参数、返回值、错误代码、速率限制等。通过仔细阅读文档，你可以全面了解API的功能和限制，避免出现不必要的错误。关注官方文档的更新，及时了解API的变化。
及时更新: 币安API可能会进行更新，以修复漏洞、增加新功能或改进性能。关注币安官方公告、博客或社交媒体，及时了解API的更新信息。更新你的代码，以适应新的API版本，确保你的应用程序能够正常运行并充分利用新的功能。忽视API更新可能导致应用程序出现故障或无法访问。