币安API使用教程： 从零开始打造你的量化交易机器人

1. 准备工作：API密钥申请与开发环境配置

在开始使用编程方式与币安交易所进行交互之前，首要步骤是在币安平台上申请API密钥，并妥善保管。API密钥分为API Key（公钥）和Secret Key（私钥），它们是您访问币安API的凭证。请务必仅将Secret Key保存在安全的地方，切勿泄露给他人，以防止资产损失。申请API密钥时，需要开启相应的权限，例如现货交易、杠杆交易等，具体取决于您的交易策略需求。同时，建议启用IP地址访问限制，仅允许特定的IP地址访问您的API，增强安全性。

完成API密钥的申请后，需要配置您的开发环境。这通常包括安装Python（建议使用3.7及以上版本），以及必要的Python库，例如 requests （用于发送HTTP请求）、 python-binance （官方提供的Python币安API库，简化API调用流程）和 pandas （用于数据处理和分析，例如K线数据的处理）。您可以使用 pip 命令来安装这些库： pip install python-binance requests pandas 。 根据您的开发习惯，可以选择合适的集成开发环境（IDE），例如PyCharm、VS Code等，以提高开发效率。

1.1 申请API密钥

1. 登录币安账户： 要使用币安API，首先必须拥有一个经过验证的币安账户。如果还没有账户，请访问 币安官网 进行注册。务必使用强密码并启用双重身份验证 (2FA)，以确保账户安全。
2. 访问API管理页面： 成功登录后，前往个人中心。通常，"API管理"选项可以在账户的安全设置、用户中心，或者配置文件页面中找到。具体位置可能因币安界面更新而略有变化。如果找不到，可以使用搜索功能查找 "API"。
3. 创建API密钥： 在API管理页面，点击“创建API”或类似按钮。系统会提示你输入API密钥的标签，用于标识该密钥的用途。选择一个容易识别的标签，例如“MyTradingBot”或“PortfolioTracker”，方便日后管理多个API密钥。
4. 设置权限： 这是配置API密钥时最重要的一步。权限设置决定了你的应用程序可以通过API执行哪些操作。
   • 只读权限 (Read Only)： 允许应用程序访问市场数据（例如实时价格、历史交易数据、订单簿等），但**绝对禁止**进行任何交易、下单或提现操作。此权限适用于纯数据分析、监控和展示用途。
   • 交易权限 (Enable Trading)： 允许应用程序代表你进行交易，包括下单、取消订单等。 务必极其谨慎地授予此权限！ 只在明确需要自动交易的情况下才启用。强烈建议同时开启IP限制，只允许特定IP地址访问API，并定期审查已授权的权限，确保没有超出预期的操作。使用交易权限时，请确保你的交易策略经过充分测试，并了解潜在的风险。
   • 提现权限 (Enable Withdrawals)： 允许应用程序提现账户中的资金。 永远不要轻易授予此权限！ 授予此权限会给你的账户带来极高的安全风险，一旦泄露，可能导致资金损失。除非你绝对信任该应用程序并且清楚其提现逻辑，否则请勿启用此权限。即便需要，也务必设置极其严格的提现地址白名单。

   安全提示： 为了最大限度地保护你的资金安全，建议启用Google Authenticator或短信验证码等双重身份验证方式，并定期更改API密钥。切勿将API Key和Secret Key泄露给任何人！

5. 保存密钥： 成功创建API密钥后，系统会生成API Key（公钥）和Secret Key（私钥）。 Secret Key只会显示一次，请务必使用安全的方式妥善保存，例如使用密码管理器！ 如果Secret Key丢失，你将无法恢复，只能重新生成新的API密钥，之前的密钥将失效。建议将API Key和Secret Key存储在安全的地方，例如加密的配置文件或环境变量中，避免硬编码在代码中。

1.2 环境配置

为了顺利进行加密货币交易程序的开发，您需要配置以下必要的开发环境和依赖库：

• Python： 推荐使用Python 3.6或更高版本。Python是一种流行的编程语言，拥有丰富的库和框架，非常适合用于开发加密货币相关的应用程序。您可以从Python官方网站 https://www.python.org 下载并安装最新版本。安装完成后，请确保将Python添加到您的系统环境变量中，以便在命令行中直接运行Python解释器。
• pip： pip 是Python的包管理工具，用于安装和管理Python软件包。通常情况下， pip 会随Python一同安装。您可以通过在命令行中运行 pip --version 来检查 pip 是否已成功安装。如果未安装，您可以按照Python官方文档的指引进行安装： https://pip.pypa.io/en/stable/installation/ 。 pip 能够简化依赖项的安装过程，并确保您的项目能够使用所需的第三方库。
• python-binance 库： python-binance 是币安官方提供的Python API库，用于与币安交易所进行交互。通过该库，您可以方便地获取市场数据、执行交易、管理账户等。这个库封装了币安API的复杂性，使得开发者能够更专注于业务逻辑的实现。

安装 python-binance 库：

使用 pip 命令来安装 python-binance 库。打开您的命令行终端，并执行以下命令：

pip install python-binance

执行上述命令后， pip 将会自动从Python Package Index (PyPI) 下载并安装 python-binance 库及其依赖项。安装完成后，您就可以在您的Python代码中导入并使用该库了。您还可以使用 pip list 命令来查看已安装的Python软件包，以确认 python-binance 库已成功安装。

2. 连接币安API：身份验证

使用API密钥进行身份验证是连接币安API的至关重要的第一步，它允许你的应用程序安全地访问你的币安账户并执行交易或其他操作。币安API密钥分为两种：API Key（公钥）和Secret Key（私钥）。务必妥善保管你的Secret Key，切勿泄露给他人，因为它相当于你的账户密码。

以下是如何使用 python-binance 库进行身份验证的示例代码。 python-binance 是一个流行的Python库，简化了与币安API的交互。安装 python-binance 可以使用pip： pip install python-binance 。

from binance.client import Client

api_key  =  'YOUR_API_KEY'   # 替换为你的API Key
api_secret =  'YOUR_API_SECRET' # 替换为你的Secret Key

client =  Client(api_key, api_secret)

在上面的代码片段中，你需要将 YOUR_API_KEY 和 YOUR_API_SECRET 替换为你实际的API Key和Secret Key。这两个密钥可以在币安网站上创建和管理。 创建API Key时，请务必设置适当的权限，例如启用交易、读取账户信息等。 如果仅需要读取数据，建议禁用交易权限，以提高安全性。 另外，可以限制API Key的IP地址，只允许特定的IP地址访问，进一步增强安全性。

Client 对象初始化后，你可以使用它来调用各种币安API端点，例如获取账户余额、下单、查询订单状态等。 务必阅读币安API的文档，了解每个端点的具体用法和参数。

验证连接是否成功

为了验证与交易所API的连接是否成功，你可以尝试执行以下Python代码片段。这段代码通过发送一个简单的请求（例如获取账户信息）来测试连接的有效性。如果API密钥配置正确且网络连接正常，程序将成功获取账户信息并打印“连接成功！”。反之，如果出现任何问题，程序将捕获异常并打印错误信息，帮助你诊断连接问题。

try:
    account = client.get_account()
    print("连接成功！")
    # print(account)  # 可以打印账户信息进行验证
except Exception as e:
    print(f"连接失败：{e}")

务必将代码中的 YOUR_API_KEY 和 YOUR_API_SECRET 替换为你从交易所获得的真实API Key和Secret Key。API Key用于标识你的身份，而Secret Key用于对你的请求进行签名，确保安全性。 Client 对象是连接交易所API的入口，通过它你可以调用各种API接口。获取账户信息是一个常用的测试方法，因为它不需要任何参数，而且可以快速验证API密钥是否有效。如果连接失败，错误信息通常会包含详细的错误代码和描述，例如“Invalid API-key, IP, or permissions for action”，可以帮助你快速定位问题所在，例如API密钥是否正确、IP地址是否在白名单中、或者账户权限是否足够。在实际开发中，你可能需要根据具体的交易所API文档进行调整，例如设置超时时间、代理服务器等。

3. 获取市场数据：现货交易对

币安API提供了广泛且细致的市场数据接口，方便开发者获取各种现货交易对的实时和历史信息。这些数据对于算法交易、风险管理、市场分析等应用至关重要。

通过这些接口，您可以获取诸如以下的关键数据：

• 交易对信息： 包括交易对的符号（例如：BTCUSDT）、基础货币、报价货币以及交易状态等。
• 实时价格： 获取最新的成交价格，用于快速的市场决策。
• 最新成交数据： 追踪最新的交易记录，包括价格、数量和时间戳。
• 订单簿信息： 获取买单和卖单的深度信息，帮助您了解市场的供需情况。
• K线数据： 获取不同时间周期的K线（蜡烛图）数据，用于技术分析。币安API支持多种K线周期，例如1分钟、5分钟、1小时、1天等。
• 24小时交易量： 获取过去24小时的交易量、最高价、最低价和成交额等统计信息。

这些现货交易对数据接口为开发者提供了强大的工具，可以构建复杂的交易策略和市场分析系统。务必仔细阅读币安API的官方文档，了解每个接口的参数、返回值以及频率限制，以便高效且稳定地获取所需数据。

3.1 获取所有交易对信息

通过调用 client.get_exchange_info() 方法，可以从币安交易所获取完整的交易对信息。该方法返回一个包含了交易所各种配置信息的字典，其中 symbols 键对应的值是一个列表，列表中的每个元素代表一个交易对。

exchange_info = client.get_exchange_info()
symbols = exchange_info['symbols']

接下来，通过循环遍历 symbols 列表，可以提取并打印每个交易对的名称。每个 symbol 元素本身也是一个字典，包含了该交易对的详细信息，例如交易对的交易代码、交易对的状态、交易的最小/最大数量限制、价格精度、交易手续费等等。通过访问 symbol['symbol'] 可以获取交易对的交易代码，例如"BTCUSDT"。

for symbol in symbols:
print(f"交易对：{symbol['symbol']}")
# print(symbol) # 打印所有交易对的详细信息

该段代码的核心功能是获取并展示币安平台所有可交易的交易对。 symbol 字典中存储了交易对的各种重要参数，包括但不限于交易对类型（如SPOT、MARGIN）、交易规则（如限价单、市价单的可用性）、价格过滤规则以及数量过滤规则，这些规则对交易行为进行约束，以确保市场的稳定性和公平性。开发者可以通过访问 symbol 字典中的不同键来获取这些详细信息，从而更好地理解和利用交易所提供的服务。

3.2 获取单个交易对的价格

symbol = 'BTCUSDT' # 要查询的交易对
ticker = client.get_ticker(symbol=symbol)
print(f"{symbol} 当前价格：{ticker['lastPrice']}")

这段代码通过 client.get_ticker(symbol=symbol) 方法，从Binance API获取指定交易对（在本例中为BTCUSDT）的实时价格数据。 symbol 变量定义了需要查询的交易对，必须是交易所支持的有效交易对代码。 get_ticker 函数返回一个包含各种实时市场数据的字典对象，例如：

• askPrice : 当前最佳卖出价格
• bidPrice : 当前最佳买入价格
• lastPrice : 最新成交价格（即当前价格）
• highPrice : 24小时内最高成交价格
• lowPrice : 24小时内最低成交价格
• volume : 24小时内成交量（以基础货币计价）
• quoteVolume : 24小时内成交额（以报价货币计价）
• openTime : 统计周期的开始时间
• closeTime : 统计周期的结束时间
• priceChange : 价格变动
• priceChangePercent : 价格变动百分比
• weightedAvgPrice : 加权平均价格
• 其他交易相关的统计数据。

3.3 获取K线数据 (蜡烛图)

K线数据（也称为蜡烛图）是加密货币交易中常用的技术分析工具，用于可视化一段时间内的价格变动。以下代码展示了如何使用API获取指定交易对的K线数据。

symbol = 'BTCUSDT' 定义交易对，这里以比特币兑美元 (BTCUSDT) 为例。你可以将其更改为其他支持的交易对，如ETHUSDT、BNBUSDT等，以获取相应交易对的数据。

interval = Client.KLINE_INTERVAL_1HOUR 指定K线的时间间隔。 Client.KLINE_INTERVAL_1HOUR 表示1小时的K线。常用的时间间隔包括：

• Client.KLINE_INTERVAL_1MINUTE (1分钟)
• Client.KLINE_INTERVAL_5MINUTE (5分钟)
• Client.KLINE_INTERVAL_15MINUTE (15分钟)
• Client.KLINE_INTERVAL_30MINUTE (30分钟)
• Client.KLINE_INTERVAL_1HOUR (1小时)
• Client.KLINE_INTERVAL_4HOUR (4小时)
• Client.KLINE_INTERVAL_1DAY (1天)
• Client.KLINE_INTERVAL_1WEEK (1周)
• Client.KLINE_INTERVAL_1MONTH (1月)

klines = client.get_klines(symbol=symbol, interval=interval) 使用API的 get_klines 方法获取K线数据。 symbol 参数指定交易对， interval 参数指定时间间隔。返回的数据是一个列表，每个元素代表一个K线。

for kline in klines: 循环遍历获取到的K线数据。每个 kline 是一个列表，包含以下数据：

1. Open time : K线开始的时间戳 (Unix 时间戳，单位为毫秒)。
2. Open : 开盘价。
3. High : 最高价。
4. Low : 最低价。
5. Close : 收盘价。
6. Volume : 交易量 (以基础货币计价，例如BTCUSDT中的BTC)。
7. Close time : K线结束的时间戳 (Unix 时间戳，单位为毫秒)。
8. Quote asset volume : 交易额 (以报价货币计价，例如BTCUSDT中的USDT)。
9. Number of trades : 交易笔数。
10. Taker buy base asset volume : 主动买入的交易量 (以基础货币计价)。
11. Taker buy quote asset volume : 主动买入的交易额 (以报价货币计价)。
12. Ignore : 忽略字段 (通常为0)。

open_time = kline[0] , open_price = kline[1] , close_price = kline[4] 从K线数据列表中提取开盘时间、开盘价和收盘价。 print(f"时间：{open_time}, 开盘价：{open_price}, 收盘价：{close_price}") 打印提取出的数据。你可以根据需要修改打印的内容，例如加入最高价、最低价、交易量等。

通过修改 interval 变量，你可以轻松获取不同时间周期的K线数据，从而进行更全面的技术分析。

4. 进行交易：下单与查询订单

警告：进行交易操作需要承担风险，请务必使用测试网络进行测试，并了解交易规则。

4.1 下单

本节介绍如何在币安交易平台通过API进行下单操作。下单是交易的核心环节，涉及指定交易对、数量、买卖方向和订单类型等关键参数。以下示例代码展示了如何使用Python Binance Connector库创建一个市价买单，并捕获可能出现的异常。

定义交易所需的参数：

symbol = 'BTCUSDT'  # 交易对：比特币/泰达币
quantity = 0.001   # 交易数量：买入0.001个比特币
side = 'BUY'   # 交易方向：买入
type = 'MARKET'   # 订单类型：市价单

其中， symbol 指定了交易对，这里是BTCUSDT，表示比特币兑泰达币。 quantity 定义了交易的数量，此处为0.001个BTC。 side 指定了交易的方向， BUY 表示买入。 type 指定了订单的类型， MARKET 表示市价单，即以当前市场最优价格立即成交的订单。

接下来，尝试执行下单操作，并处理可能出现的异常：

try:
    order = client.order_market(
        symbol=symbol,
        side=side,
        quantity=quantity
    )
    print(f"下单成功：{order}")
except Exception as e:
    print(f"下单失败：{e}")

这段代码使用 client.order_market() 方法创建一个市价单。如果下单成功，会打印出订单的详细信息；如果下单失败，会捕获异常并打印出错误信息。常见的下单失败原因包括：账户余额不足、API密钥权限不足、交易对不存在等。务必仔细检查相关参数配置，确保账户状态正常。

这段代码示例演示了以市价买入0.001个BTCUSDT的操作。可以通过修改 side 变量的值为 SELL 来实现卖出操作，即卖出指定数量的BTC。 type 变量的值还可以设置为 LIMIT 来创建限价单，即以指定的价格挂单，等待市场价格达到指定价格时成交。使用限价单时，需要额外指定 price 参数，表示期望的成交价格。

例如，以下代码展示了如何创建一个限价买单：

symbol = 'BTCUSDT'
quantity = 0.001
side = 'BUY'
type = 'LIMIT'
price = 29000  # 期望的成交价格：29000 USDT

try:
    order = client.order_limit(
        symbol=symbol,
        side=side,
        quantity=quantity,
        price=price
    )
    print(f"下单成功：{order}")
except Exception as e:
    print(f"下单失败：{e}")

注意，限价单的成交具有不确定性，只有当市场价格达到或低于（买单）/高于（卖单）指定价格时，订单才会成交。可以设置 timeInForce 参数来指定订单的有效时间，例如 GTC （Good Till Cancelled，一直有效直到取消）、 IOC （Immediate Or Cancel，立即成交或取消）、 FOK （Fill Or Kill，全部成交或取消）。

4.2 查询订单

查询特定订单是交易API的基本功能，允许用户检索有关特定订单的详细信息，例如订单状态、价格、数量和交易费用。要查询订单，你需要提供订单的唯一标识符，通常是 orderId ，以及交易对 symbol 。

symbol = 'BTCUSDT'
指定要查询的交易对，例如比特币兑美元(BTCUSDT)。 symbol 参数区分大小写，必须与交易所支持的符号完全匹配。不同的交易所支持的交易对有所不同，因此在查询之前，务必确认交易所支持该交易对。

order_id = 123456789 # 替换为你的订单ID
order_id 是你在交易所创建订单时获得的唯一标识符。请务必使用正确的 order_id ，否则查询将返回错误或无效信息。请注意，订单ID通常是数字类型的字符串。

try:
order = client.get_order(symbol=symbol, orderId=order_id)
这段代码块尝试通过交易所API客户端的 get_order 方法来查询订单。它使用先前定义的 symbol 和 order_id 作为参数。如果查询成功，服务器将返回订单的详细信息。
print(f"订单信息：{order}")
如果 get_order 方法成功返回订单信息，这段代码会将订单信息打印到控制台。订单信息通常包含订单状态（例如，已成交、已取消、挂单中）、订单类型（例如，市价单、限价单）、订单价格、订单数量和交易费用等。

except Exception as e:
print(f"查询订单失败：{e}")
如果在查询订单过程中发生任何错误（例如，无效的 order_id 、网络连接问题、API 密钥无效），这段代码块将捕获异常并打印错误消息到控制台。这有助于调试和诊断问题。常见的错误包括无效的 API 密钥、权限不足、网络超时或服务器错误。

这段代码段展示了如何使用订单ID查询特定订单的信息。你需要将 order_id 变量替换为你希望查询的实际订单ID。确保你已正确配置了 API 密钥，并且拥有查询订单信息的权限。返回的订单信息通常以JSON格式呈现，包含订单的各种属性。

5. 使用WebSocket API：实时数据流

币安API不仅提供REST API进行数据请求，还提供了强大的WebSocket API，用于接收实时市场数据流。相比于轮询REST API，WebSocket API能够提供更低延迟、更高效率的数据更新，例如实时价格变动、深度数据更新、K线数据变化等，非常适合对实时性要求高的交易策略和数据分析应用。

要使用币安WebSocket API，你需要安装相应的Python库。虽然 python-binance 库也提供WebSocket支持，但这里我们展示一个更清晰的示例，它可以更好地控制连接和数据处理。

以下是一个使用 ThreadedWebsocketManager 连接币安WebSocket并接收实时市场数据的示例代码：

from binance import ThreadedWebsocketManager

twm = ThreadedWebsocketManager()
twm.start()

上述代码初始化并启动了一个线程化的WebSocket管理器。接下来，你需要定义一个函数来处理接收到的WebSocket消息：

def handle_socket_message(msg):
    print(f"接收到消息：{msg}")

handle_socket_message 函数接收一个 msg 参数，该参数包含了从币安WebSocket服务器接收到的数据。你可以根据实际需求对数据进行解析和处理，例如提取价格、计算指标、更新交易界面等。

接下来，你可以订阅特定的数据流。例如，要订阅BTCUSDT的实时K线数据（每分钟更新一次），可以使用以下代码：

# 订阅BTCUSDT的实时K线数据（每分钟更新一次）
twm.start_kline_socket(callback=handle_socket_message, symbol='BTCUSDT', interval='1m')

或者，要订阅BTCUSDT的实时交易数据，可以使用以下代码：

# 订阅BTCUSDT的实时交易数据
twm.start_trade_socket(callback=handle_socket_message, symbol='BTCUSDT')

twm.start_kline_socket 和 twm.start_trade_socket 函数都接受一个 callback 参数，该参数指定了用于处理接收到的消息的函数。 symbol 参数指定了要订阅的交易对， interval 参数 (仅用于K线数据) 指定了K线的时间周期。 币安的WebSocket API支持多种数据流，包括K线数据、交易数据、深度数据等。你可以根据自己的需求选择合适的数据流进行订阅。

完整示例代码:

from binance import ThreadedWebsocketManager

# 初始化WebSocket管理器
twm = ThreadedWebsocketManager()

# 启动WebSocket连接
twm.start()

# 处理接收到的消息
def handle_socket_message(msg):
    print(f"Received message: {msg}")

# 订阅BTCUSDT的实时K线数据 (1分钟)
twm.start_kline_socket(callback=handle_socket_message, symbol='BTCUSDT', interval='1m')

# 或者，订阅BTCUSDT的实时交易数据
# twm.start_trade_socket(callback=handle_socket_message, symbol='BTCUSDT')


# Keep the program running to continue receiving data
try:
    while True:
        pass
except KeyboardInterrupt:
    twm.stop()
    print("WebSocket connection closed")

请确保在程序结束时调用 twm.stop() 方法，以关闭WebSocket连接。

订阅BTCUSDT实时价格更新

通过 twm.start_symbol_ticker_socket 方法，您可以建立一个WebSocket连接，实时接收BTCUSDT交易对的价格变动信息。该方法需要传入两个关键参数： callback 和 symbol 。

symbol 参数指定您希望订阅的交易对，本例中为'BTCUSDT'，表示比特币兑美元的交易对。您可以根据需要替换为其他支持的交易对。

callback 参数是一个函数，用于处理从WebSocket连接接收到的消息。每当BTCUSDT的价格发生变动，服务器会将包含价格信息的JSON消息推送到您的客户端。 handle_socket_message 函数负责解析这些消息，并根据您的需求进行处理，例如更新UI、计算交易信号等。请务必确保 handle_socket_message 函数能够正确解析和处理接收到的数据，避免出现错误。

示例代码如下：

twm.start_symbol_ticker_socket(callback=handle_socket_message, symbol='BTCUSDT')

请确保您的 handle_socket_message 函数已正确定义，并且能够处理来自WebSocket连接的数据。例如，它可以提取出最新价格、交易量等信息，并将其显示在您的应用程序中。为了确保程序的稳定性，建议在 handle_socket_message 函数中添加错误处理机制，以应对可能出现的网络中断或其他异常情况。

保持连接，否则程序会退出

twm.join() 方法至关重要，它负责维持与币安WebSocket服务器的连接。如果该方法未被调用或因某种原因提前退出，程序将无法继续接收实时数据流，最终导致程序终止。

这段代码的主要功能是订阅BTCUSDT（比特币/美元）交易对的实时价格变动，并在接收到新的价格数据时将其打印到控制台。为了实现这一功能，你需要预先定义一个名为 handle_socket_message 的函数。这个函数的作用是解析从WebSocket连接接收到的原始消息，提取出所需的价格信息，并执行后续的处理逻辑，例如打印价格、更新数据库或触发交易信号等。

WebSocket API本质上是一种异步通信机制。这意味着你的程序需要使用多线程或异步协程等并发编程技术来处理WebSocket连接。你需要创建一个独立的线程或协程来专门负责与WebSocket服务器建立连接、接收数据和处理消息。这样可以避免阻塞主线程，确保程序的流畅运行和实时性。在实际应用中，选择线程还是协程取决于你的具体需求和技术栈。线程适用于CPU密集型任务，而协程更适合IO密集型任务，例如处理大量的并发WebSocket连接。