SDK 与工具

Python

Copy page

Binance API 官方 Python 连接器，专为运行在 Python 上的后端应用程序而设计。

该连接器采用完全模块化设计：每个 Binance 产品均以独立的 Python 包形式发布（例如 binance-spot），您可以按需安装和使用所需的 API。它支持 REST API、WebSocket API 和 WebSocket 数据流，并提供内置的请求签名、连接管理以及强类型的请求/响应模型，带来一致的开发体验。

如需查看源代码、问题反馈及版本说明，请访问 GitHub 上的 binance-connector-python 仓库。

支持的环境

• Python 3.9 或更高版本
• 后端 Python 应用程序及服务

本连接器仅适用于服务端使用。不支持交互式或客户端 Python 环境。

包结构

每个 Binance 产品均以独立的 Python 包形式发布。

常用包包括：

• binance-sdk-spot
• binance-sdk-derivatives-trading-usds-futures
• binance-sdk-derivatives-trading-coin-futures
• binance-sdk-wallet
• （其他产品遵循相同的结构）

这种模块化方式将依赖项保持在最低限度，同时使升级和集成管理更加便捷。

典型使用场景

• 交易与执行服务
• 实时及历史行情数据采集
• 管理账户、余额和订单的后端服务
• 通过 WebSocket API 或 WebSocket 数据流获取低延迟更新的应用程序

主要特性

• 支持 Binance REST API、WebSocket API 和 WebSocket 数据流
• 内置针对需要身份验证接口的请求签名
• WebSocket 连接管理，支持自动重连和会话续期
• 强类型的请求与响应模型
• 同时支持正式环境和测试网环境
• 跨产品一致的 API 设计

快速开始

安装您需要集成的产品对应的包：

Code
pip install binance-sdk-spot

创建客户端并发送请求：

Code
from binance_sdk_spot.spot import Spot, ConfigurationRestAPI

configuration_rest_api = ConfigurationRestAPI(
    api_key=os.environ["BINANCE_API_KEY"],
    private_key=os.environ["BINANCE_PRIVATE_KEY"],
)
spot_client = Spot(config_rest_api=configuration_rest_api)

account_info = spot_client.rest_api.get_account()

上述示例使用非对称密钥进行身份验证。同样支持基于 API Secret 的 HMAC 身份验证方式。

如需各产品的 REST、WebSocket API 和 WebSocket 数据流示例，请参阅各包的文档。

注意事项与最佳实践

• 使用环境变量或密钥管理工具安全存储 API 密钥
• 获取实时数据时，优先使用 WebSocket API 或数据流，而非轮询 REST 接口
• 构建高吞吐量服务时，注意监控频率限制和接口权重
• 开发和验证集成方案时，请使用测试网环境