必须创建并绑定币安官方API密钥才能在量化软件中自动交易、查持仓或读行情；需主账户登录API管理页，完成KYC后创建密钥，勾选读取账户和交易权限（禁提币），妥善保存Secret Key，再在vn.py等平台配置参数并测试连接成功。
币安（binance）官方认证入口：
点击获取官方APP☞☞☞☞☞：
要在量化软件中自动执行币安交易、查询持仓或读取实时行情，必须先创建并绑定币安官方API密钥。这一步不可跳过，否则所有自动化操作都会因权限拒绝而失败。
登录币安官网并进入API管理页面
打开浏览器，访问 https://www.binance.com，使用你的币安账户（非子账户）完成登录。子账户无法创建API，【必须用主账户登录】。
鼠标悬停右上角头像 → 点击「API管理」→ 进入「API管理中心」页面。若未看到该菜单，请先完成KYC实名认证（未认证用户被系统隐藏API入口）。
创建新的API密钥（含Secret Key）
在API管理中心页面，点击「创建API」按钮。
填写API名称（如“vnpy-spot-trading”），勾选所需权限： ✅ 读取账户信息（必选） ✅ 交易（下单/撤单/查订单）→ 若需实盘交易则必须勾选 ❌ 提币 → 【严禁勾选】，此权限一旦泄露将导致资产直接被盗
完成滑块验证后，系统会立即生成一对密钥：API Key（一串字母数字）和 Secret Key（另一串更长的字符）。Secret Key仅显示一次，关闭页面即永久不可见。此时务必用密码管理器（如Bitwarden）或本地加密文档保存，【切勿截图、勿存微信、勿发邮箱】。
量化软件中配置币安API参数
以vn.py为例（其他框架如Freqtrade、Backtrader逻辑类似）：
启动veighna_station → 左侧导航栏点击「连接交易所」→ 选择「Binance」→ 弹出配置窗口。
填入三项关键参数： ① API Key：粘贴刚才复制的Key ② Secret Key：粘贴对应Secret ③ 代理地址（可选）：若国内直连超时，填入可用HTTP代理（格式：http://127.0.0.1:10809）
点击「测试连接」：成功返回“账户资金查询成功”即表示API已通。失败常见原因：时间不同步（币安要求请求时间误差≤5秒）、IP白名单未关（若开启白名单但未添加当前IP，则连接拒绝）。
启用IP白名单（高安全场景必做）
方法一：关闭白名单（适合开发调试） 回到币安API管理页 → 找到刚创建的API → 点击「编辑」→ 关闭「IP白名单」开关 → 保存。此操作允许任意IP调用，便捷但风险略高。
方法二：添加当前公网IP（推荐实盘使用） 在命令行运行 curl ifconfig.me 获取当前出口IP → 返回API管理页 → 编辑该API → 开启IP白名单 → 在输入框粘贴IP（支持单IP或CIDR格式，如112.65.33.128/27）→ 保存。
注意：家庭宽带IP常为动态IP，每月可能变更1–2次，建议搭配DDNS服务或定期检查；企业固定IP可一劳永逸。
在量化策略中调用币安接口
打开策略代码文件（如my_strategy.py），确认初始化部分包含：
engine.connect("BINANCE", {"key": "xxx", "secret": "yyy", "proxy_host": "", "proxy_port": 0})
确保key与secret值与你保存的一致，且未被引号外的空格或换行符污染。若使用环境变量加载（推荐生产环境），则改用 os.getenv("BINANCE_KEY") 方式读取，避免密钥硬编码进Git仓库。
启动策略后，日志中出现「Binance Websocket connected」和「Account balance updated」即表示接入完成，后续可调用order、cancel_order、query_position等方法驱动实盘动作。
