安装币安官方Python SDK

• 下单：创建新的限价单、市价单、止盈止损单等。
• 查询订单：根据订单ID或客户自定义ID查询特定订单状态。
• 撤销订单：取消未成交的订单。
• 查询当前所有挂单：获取账户下所有未成交的订单。
• 查询所有订单（历史）：获取账户下已成交或已取消的历史订单。

钱包接口（私有数据，需要API Key）

这类接口主要用于资金管理，同样需要API Key。

• 系统状态： 查询币安系统当前的状态（如维护、正常等）。
• 币种信息： 查询所有币种的网络信息（如提币手续费、是否暂停等）。
• 资金划转： 在现货、杠杆、合约、C2C等不同账户类型之间进行资金划转。
• 提币： （极度危险，通常不开启）将资产从币安提现到外部地址。

如何创建和管理你的币安API Key？

安全是使用API的第一要务，以下是创建和管理API Key的标准步骤：

1. 登录币安账户： 访问币安官网并登录你的账户。
2. 进入API管理页面： 点击右上角头像 -> 【API管理】。
3. 创建API： 点击【创建API】按钮，系统会要求你进行二次验证（如谷歌验证器、短信验证等）。
4. 设置API标签（必填）： 为你的API Key起一个易于识别的名称，Python交易机器人”、“我的量化策略”等,这有助于你日后管理多个Key。
5. 设置API权限（关键安全步骤）：
   • 启用交易： 允许程序进行买卖操作，如果你只做数据监控,则无需勾选。
   • 启用提现： 强烈建议不要勾选此项！ 除非你完全清楚风险，并且程序逻辑绝对安全,绝大多数自动化交易场景都不需要此权限。
6. IP白名单（强烈建议设置）： 为了防止API Key泄露后被他人滥用，你可以设置一个或多个IP地址，只有来自这些IP的请求才会被币安服务器接受，如果你使用云服务器（如AWS, Google Cloud）,请填写服务器的公网IP。
7. 保存你的Key： 创建成功后，系统会显示 API Key 和 Secret Key。
   • API Key 是公开的,相当于你的用户名。
   • Secret Key 是私密的，相当于你的密码，绝对不能泄露给任何人！
   • 这是唯一一次显示Secret Key的机会，请务必立即、安全地复制并保存下来。 丢失后无法找回,只能重新创建。

实战演练：用Python调用币安API（简单示例）

币安官方提供了多种语言的SDK（软件开发工具包），其中Python社区最活跃，这里我们以Python为例,展示如何获取账户余额和下一个市价单。

准备工作：

示例代码：

from binance import Client, ThreadedWebsocketManager, ThreadedDepthCacheManager
import os
# --- 安全提示：不要将Key直接写在代码中，建议使用环境变量 ---
# 在你的终端中设置环境变量：
# export BINANCE_API_KEY='你的API_Key'
# export BINANCE_API_SECRET='你的Secret_Key'
api_key = os.environ.get('BINANCE_API_KEY')
api_secret = os.environ.get('BINANCE_API_SECRET')
# 初始化客户端
client = Client(api_key, api_secret)
# 示例1：获取现货账户余额
def get_account_balance():
    print("--- 查询账户余额 ---")
    try:
        # 获取账户信息
        account_info = client.get_account()
        # 遍历资产列表，只显示余额不为0的资产
        balances = account_info['balances']
        for asset in balances:
            if float(asset['free']) > 0 or float(asset['locked']) > 0:
                print(f"资产: {asset['asset']}, 可用: {asset['free']}, 锁定: {asset['locked']}")
    except Exception as e:
        print(f"获取余额失败: {e}")
# 示例2：下一个市价买单（谨慎操作！）
def place_market_buy_order():
    print("\n--- 下市价买单 (示例: 购买价值10 USDT的BTC) ---")
    try:
        # 交易对
        symbol = 'BTCUSDT'
        # 购买数量（以USDT计价）
        quoteOrderQty = 10
        # 下单
        order = client.create_order(
            symbol=symbol,
            side=Client.SIDE_BUY,
            type=Client.ORDER_TYPE_MARKET,
            quoteOrderQty=quoteOrderQty  # 市价单使用quoteOrderQty指定总价值
        )
        print(f"订单成功！订单ID: {order['orderId']}")
        print(f"成交详情: {order['fills']}")
    except Exception as e:
        print(f"下单失败: {e}")
# --- 执行函数 ---
if __name__ == '__main__':
    get_account_balance()
    # !!! 警告: 下面的函数会执行真实交易，请确保参数正确并充分理解风险后再运行 !!!
    # place_market_buy_order()