一、币安API是什么，接入前要准备什么

1.1 API能做什么

API可以让程序按规则访问行情、账户和交易功能。公开行情接口通常用于读取交易对、价格、深度和K线；账户接口用于读取余额、订单和成交；交易接口则可能创建、查询或取消订单。不同接口的安全类型和所需权限并不相同，不能用“一把钥匙开所有功能”的思路配置。

当前开发者文档会把接口按公开数据、用户数据和交易能力区分，并在接口名称旁标注相应的安全类型。正式接入前，应以当前文档中的接口路径、参数、权限和限频说明为准。

1.2 开始前的准备清单

• 一个已经完成必要安全设置的币安账户，以及能接收验证信息的邮箱或手机号。
• 一台用于运行脚本的电脑、服务器或云主机，并尽量使用固定出口IP。
• 明确的接入目标：只读行情、读取账户、下单，还是连接WebSocket实时数据。
• 能够安全保存环境变量、日志和密钥的部署方式。
• 先在小范围或测试环境验证，不把首个脚本直接连接到生产交易账户。

二、创建API密钥和设置权限

2.1 创建流程

1. 登录币安账户，从账户设置或API管理入口进入API创建页面。页面名称和菜单位置可能随版本、地区及账户类型变化。
2. 为密钥填写能够识别用途的标签，例如“行情读取脚本”或“策略服务器”，不要使用“全部权限”这类模糊名称。
3. 按页面提示完成安全验证，创建后分别保存API Key和Secret Key。
4. 在任何代码运行前，先回到权限页确认默认权限、IP限制和产品范围。
5. 保存后不要把Secret Key再次粘贴到聊天工具、工单、截图或公开仓库。

2.2 权限怎么设置

2.3 IP白名单怎么用

如果程序运行在固定服务器上，应把API密钥限制到该服务器的出口IP。使用家庭宽带、动态云主机或多地部署时，先确认实际出口地址，再决定是否采用固定IP、独立密钥或分环境配置。

IP白名单不是万能防护：密钥被盗且攻击者能够从白名单服务器执行代码时，仍然可能产生风险。因此还要限制权限、隔离运行环境、监控日志并准备快速撤销密钥的流程。

三、API请求安全与签名规则

3.1 先认识请求类型

官方文档会在接口名称旁标注安全类型。没有明确说明时，不要自行假设接口可以匿名调用，也不要因为某个请求成功就给同一把密钥增加更多权限。

3.2 API Key和Secret Key如何放进程序

推荐使用环境变量或部署平台的密钥管理功能，程序启动时读取变量。Secret Key只用于本地签名，不应发送到浏览器、移动端、前端JavaScript或第三方日志服务。

export BINANCE_API_KEY="只填自己的API Key"
export BINANCE_API_SECRET="只填自己的Secret Key"
export BINANCE_API_BASE="https://api.binance.com"

生产环境不要把上面的值直接写进Git仓库。日志中也不要输出完整请求参数、签名、API Key或响应中的敏感账户信息。

3.3 时间戳、签名和服务器时间

签名接口通常需要时间戳，客户端时间偏差过大时会被拒绝。程序启动和定时运行时应读取服务器时间或使用系统时间同步服务，并设置合理的接收窗口。签名字符串必须严格按照当前官方文档要求生成，参数排序、编码和签名算法有任何差异都可能导致认证失败。

四、用Python接入公开和账户接口

4.1 先用公开接口测试网络

第一步不要下单，先调用公开接口确认网络、域名、JSON解析和超时处理正常。下面示例只读取服务器时间，不需要密钥，也不会产生交易。

import os
import requests

BASE_URL = os.getenv("BINANCE_API_BASE", "https://api.binance.com")

response = requests.get(
    f"{BASE_URL}/api/v3/time",
    timeout=10,
)
response.raise_for_status()
print(response.json())

如果这一步失败，先检查网络、DNS、地区可用性、代理设置和接口当前状态，不要急着创建更多API密钥。

4.2 再验证带签名的账户请求

账户接口通常需要API Key、Secret Key、时间戳和HMAC签名。示例只读取账户信息，不提交订单；运行前应确保密钥已经限制权限和IP。

import hashlib
import hmac
import os
import time
from urllib.parse import urlencode

import requests

BASE_URL = os.getenv("BINANCE_API_BASE", "https://api.binance.com")
API_KEY = os.environ["BINANCE_API_KEY"]
API_SECRET = os.environ["BINANCE_API_SECRET"]

params = {
    "timestamp": int(time.time() * 1000),
    "recvWindow": 5000,
}
query = urlencode(params)
signature = hmac.new(
    API_SECRET.encode("utf-8"),
    query.encode("utf-8"),
    hashlib.sha256,
).hexdigest()

response = requests.get(
    f"{BASE_URL}/api/v3/account?{query}&signature={signature}",
    headers={"X-MBX-APIKEY": API_KEY},
    timeout=10,
)
response.raise_for_status()
account = response.json()
print(account.keys())

五、程序化交易接入与上线前检查

5.1 从只读到交易权限的分阶段流程

1. 阶段一：使用公开接口读取行情，验证网络和数据解析。
2. 阶段二：使用只读API读取账户信息，验证签名、时间戳和权限。
3. 阶段三：在测试或模拟环境验证订单参数、撤单逻辑和异常处理。
4. 阶段四：只为专用策略密钥开启必要的交易权限，继续保留IP白名单。
5. 阶段五：小规模运行，监控订单、余额、错误码、请求权重和服务器状态。

5.2 下单前必须检查什么

5.3 适合的程序结构

配置层：读取环境变量和运行模式
数据层：行情、账户和订单状态
策略层：只输出经过校验的意图
风控层：额度、频率、仓位和停止条件
执行层：签名、发送、查询和撤单
监控层：日志脱敏、告警、指标和密钥撤销

策略层不应直接持有Secret Key，交易执行层也不应绕过风控层。把密钥、策略、风控和监控拆开，出现异常时更容易停掉交易而不影响其他服务。

六、常见报错、安全提醒与执行清单

6.1 常见失败原因

6.2 发现密钥泄露后的处理

1. 立即在API管理页面撤销泄露的密钥，不要只修改代码里的变量名。
2. 检查账户登录记录、订单、资产、API权限和白名单。
3. 修改账户密码并确认双重验证仍由本人控制。
4. 查看程序仓库、日志、CI变量、备份和聊天记录，清除残留密钥。
5. 重新创建权限更小、IP受限的新密钥，并观察运行日志。

6.3 上线前执行清单

1. 我明确了程序只需要行情、账户读取还是交易能力。
2. 我为不同环境和不同策略使用独立API密钥。
3. 我关闭了不需要的交易、提币和产品权限。
4. 我已配置固定IP白名单或明确了运行出口地址。
5. Secret Key只在服务端环境变量或密钥管理器中保存。
6. 我先验证了公开接口、签名接口和异常处理，再考虑真实交易。
7. 我实现了限频、撤单、停止条件、日志脱敏和密钥撤销流程。
8. 我已人工核对当前API文档、权限名称、交易规则和地区可用性。

6.4 最终结论

币安API的正确用法不是创建一把“全能钥匙”，而是根据程序目标拆分权限：先用公开接口测试，再用只读权限验证签名和账户请求，最后在IP白名单、风控和监控都准备好后，才考虑开放必要的交易权限。API更适合按工程流程管理，不适合把密钥交给陌生软件或未经审核的自动化服务。

API接口、权限名称、限频、交易规则和地区服务范围可能变化，实际开发时以当前官方开发者文档和账户页面为准。本文不构成投资、法律或合规建议。