币安是全球成交量和流动性长期领先的中心化交易所之一，Binance API 是其对外开放的程序化接口，覆盖行情订阅、账户查询、自动下单、统一账户管理等核心交易动作。无论你是想跑一个简单的网格机器人，还是搭建跨交易所套利系统，绕不开的第一步都是申请币安 API Key、读懂币安 API 文档、把签名机制接通。
这篇教程把官方文档里散落的细节、社区里反复踩过的坑、以及大陆用户常见的网络访问与权限配置问题整理成了一条清晰路径——从 0 到拿到能下单的 API Key，再到写出第一行可运行的 Python 量化代码。
币安API核心要点速览
- 币安 API 申请前置条件：账户已完成身份认证 / 进阶 KYC、现货钱包已激活（任意金额充值即可）、已开启 2FA。
- 密钥类型：系统生成（HMAC 对称加密）适合新手理解签名流程；自行生成（Ed25519 或 RSA 非对称加密）更适合长期生产环境，币安官方推荐 Ed25519。
- 权限默认值：新建 API Key 默认仅开启「读取」，提现权限永远不要为普通量化场景开启。
- IP 白名单：未绑定 IP 的 API Key 在长期未使用后可能被系统自动删除；生产环境应绑定固定公网 IP。
- 签名机制：SIGNED 请求都需要携带 signature；HMAC Key 使用 HMAC-SHA256，RSA / Ed25519 Key 使用对应私钥签名，请求头 X-MBX-APIKEY 传递的是 API Key，不是公钥。
- 限频：币安采用权重制（Weight-based），超限返回 429，连续违规触发 IP 封禁（HTTP 418），封禁时间可从 2 分钟延长到 3 天。
- 量化首选：Python + ccxt 是最低成本起步方案，10 行代码可拿到 K 线，30 行可下单。
什么是币安 Binance API
API 是 Application Programming Interface 的缩写，本质上就是币安服务器对外暴露的一组「机器读写接口」。手动交易者点鼠标、拖滑块下单的所有动作，背后都是这组接口在工作。当你拿到 API Key 之后，可以用代码代替鼠标，把以下能力变成一行行函数调用：
- 读取实时行情、K 线、订单簿深度、最近成交
- 查询账户余额、持仓、订单状态、历史成交
- 下单、撤单、改单（含止盈止损、OCO、ICEBERG 等高级单类型）
- 申请杠杆借贷、合约划转、统一账户资金调度
- 订阅 WebSocket 用户数据流，毫秒级感知账户变化
币安 API 主要分为三类接口形态：REST API（HTTP 请求/响应，适合一次性查询、下单与账户操作）、WebSocket API（长连接下的请求式交易/查询能力）和 WebSocket Streams（实时行情与账户事件推送）。三者功能有重叠，但不能简单等同；做实时策略时，行情与账户事件优先用 WebSocket Streams，REST 更多用于初始化、补充查询和低频操作。
申请币安 API 的前置条件
币安在 2021 年 8 月之后收紧了 API 创建规则：只有完成进阶认证 / 身份认证的用户才能创建新 API 密钥。对于未完成对应认证的账户，既有 API Key 可能被调整为只读，交易功能无法使用；完成认证后才能恢复完整 API 访问。如果你还没有币安账户，可以参考这篇 币安注册与 KYC 实名认证图文教程，按步骤完成认证。
除了 KYC 之外，创建 API Key 前还必须满足两个隐性条件：
1. 现货钱包激活。币安要求你向现货账户充入任意金额来「激活」账户。如果你还没有 USDT，可以走 C2C 通道，详见 人民币 C2C 购买 USDT 完整流程。
2. 已开启 2FA 二次验证。建议同时启用谷歌验证器 + 邮箱验证，单点失效不会影响 API 操作。
移动端用户需要先把 App 装好：iOS 用户参考 币安 iOS 下载与 Apple ID 切换教程，安卓用户参考 币安 Android App 下载安装指南，App 端虽然也能创建 API，但权限编辑界面建议在 PC 网页端操作，按钮密度和提示信息更完整。
币安 API Key 创建：6 步图文教程
下图把整个申请流程拆成 6 个关键节点，对照着做基本不会卡住：
第 1 步：登录币安账户
用浏览器打开币安官网（防止钓鱼网站，认准 binance.com 主域名），登录后点击右上角头像 → 【账户】，进入个人中心。
第 2 步：进入 API 管理页面
在账户左侧菜单找到【API 管理】，或者直接访问 binance.com/zh-CN/my/settings/api-management。如果这是你第一次创建 API，页面会是空的。
第 3 步：点击「创建 API」并选择密钥类型
币安提供两种密钥生成方式：
- 系统生成（推荐新手理解流程）：采用 HMAC-SHA256 对称加密。币安会同时给你 API Key（访问标识）和 Secret Key（签名密钥），后续请求用 Secret Key 生成签名。
- 自行生成（推荐进阶/机构）：采用 Ed25519 或 RSA 非对称加密。你在本地用工具生成密钥对，只把公钥上传给币安，私钥永远不离开你的机器。币安官方文档明确推荐 Ed25519，因为它在签名体积、计算速度和安全性之间更均衡。
HMAC 适合快速上手，但官方文档已提示 HMAC Key 属于逐步迁移方向；正式生产环境建议优先考虑 Ed25519。
第 4 步：填写标签并完成安全验证
给这个 API Key 起一个能识别用途的名字，比如「grid-bot-spot」「monitor-only」「futures-arbitrage」。命名后系统会要求你完成手机/邮箱验证码 + 谷歌验证器 + 滑块拼图等安全验证。
第 5 步：保存 Secret Key
这一步是整个流程里最容易丢东西的环节。系统生成模式下，Secret Key 只会显示一次。一旦关闭这个页面或刷新，你将再也无法看到这个 Secret——只能删掉 API 重新创建。
建议立刻把 API Key 和 Secret Key 一起存进密码管理器（Bitwarden、1Password 等），不要存到云笔记的明文里，更不要发到任何聊天软件。
第 6 步：编辑权限与 IP 白名单
新建 API 默认只开启读取权限。如果你的程序需要下单、合约、划转，必须手动勾选对应权限，并通过安全验证保存。下一节我们专门讲权限矩阵和 IP 白名单。
API 权限设置与 IP 白名单
权限不是越多越好，相反——最小权限原则是 API 安全的第一条铁律。币安的权限选项可以按业务场景这样勾选：
常见权限组合
- 纯行情/监控：只勾「允许读取」。即使密钥泄露，攻击者也只能看你的数据，无法动你一分钱。
- 现货量化：勾「允许读取」+「允许现货及杠杆交易」。需要划转时再补勾「允许杠杆借贷和划转」「允许万向划转」。
- 合约量化：勾「允许读取」+「允许合约」。注意：必须先开通合约账户，才能勾选合约权限，否则该选项会灰显并提示「开通合约账户之前创建的 API Key 不支持合约 API 功能」。
- 跨账户搬砖：在合约/现货权限基础上加勾「允许万向划转」。
关于「允许提现」
这是币安风险最高的权限。币安默认禁用此权限，开启提现权限必须设置 IPv4 访问限制。普通现货量化、合约量化、网格机器人、套利监控都不需要提现权限；除非你在做交易所之间的自动充提对接，否则永远不要勾选。
历史上的 API 安全事件说明，API Key 泄露可能导致异常交易、账户风险甚至配合其他凭证造成资金损失。2018 年 SYS 异常交易事件后，币安曾删除全部现有 API Key 并要求 API 用户重建；2019 年安全事件中，攻击者获取了大量用户 API Key、2FA 码等信息，并从热钱包提走 7000 BTC。因此，量化场景应始终避免提现权限，并尽量绑定 IP 白名单。
IP 白名单：不仅是安全，也关系到权限稳定性
币安已经实施过「无 IP 白名单且 30 天未使用的 API Key 自动删除」策略。也就是说，如果你的 API Key 没有绑定 IP，又恰好放了一个月没用，下次想用时可能会发现它已经被系统清掉，必须重新创建并重新配置所有下游程序。
更重要的安全意义是：绑定 IP 之后，即使 Secret Key 泄露，攻击者也无法从其他 IP 发起请求。配置步骤：
1. 在 API 编辑页面找到「限制访问 IP」
2. 查到你服务器的公网 IP（命令行执行 curl ifconfig.me 或浏览器搜「what is my IP」）
3. 填入 IPv4 地址，多个 IP 按页面提示分隔
4. 保存并完成安全验证
需要提醒的是，自 2023 年 1 月 30 日起，如果系统生成的 HMAC API Key 未设置 IP 访问限制，其权限通常只能设为「允许读取」。这不是「大陆 IP 被官方限制为只读」的规则，而是「未限制 IP 的系统生成 HMAC Key」的权限规则。大陆用户做生产环境量化时，仍然建议使用海外 VPS（如 AWS 东京、Vultr 新加坡等）部署程序，并把 VPS 的固定公网 IP 加入白名单，原因主要是网络稳定性、延迟和合规访问风险。
币安 API 文档导航：3 大核心入口
币安官方文档体系经过多次迁移，目前的权威入口是 developers.binance.com。把以下三个地址加进书签可以省下大量翻找时间：
- Spot REST API 文档：所有现货端点、参数定义、错误码、限频规则。
- WebSocket Streams 文档：行情推送、用户数据流、深度增量。
- GitHub 仓库 binance/binance-spot-api-docs：Markdown 源文件，可以本地搜索，更新较及时。
合约部分（U 本位 fapi、币本位 dapi、欧式期权 eapi、统一账户 papi）有独立的文档集，结构与现货类似但端点路径不同。新手只需要现货 + U 本位合约这两份就能覆盖大多数策略需求。
币安 API 调用：签名机制详解
币安把所有端点分为两类：
- NONE / MARKET_DATA：公开行情端点，通常无需签名；部分接口可能要求 API Key，但不涉及账户交易签名。
- SIGNED（TRADE / MARGIN / USER_DATA）：涉及账户与交易的私有端点，必须携带 signature 参数。
SIGNED 请求都需要签名，但签名算法取决于 API Key 类型：HMAC Key 使用 HMAC-SHA256；RSA Key 使用 RSA 私钥签名；Ed25519 Key 使用 Ed25519 私钥签名。请求头里的 X-MBX-APIKEY 传递的是 API Key / Key ID，不是公钥；如果使用 Ed25519/RSA，公钥是在创建 API Key 时上传给币安，后续请求用本地私钥签名。
HMAC-SHA256 签名流程
系统生成的 HMAC Key 使用业界标准的 HMAC-SHA256 算法来验证请求来源。签名过程可以拆成 5 步：
1. 把所有参数（包括 timestamp）按 key=value&key=value 格式拼接成 totalParams 字符串。
2. 用你的 Secret Key 作为密钥，对 totalParams 做 HMAC-SHA256 计算。
3. 把输出编码为 hex 字符串，得到 signature。
4. 把 signature 拼回 URL 参数末尾，并在请求 Header 中加入 X-MBX-APIKEY: 你的API Key。
5. 币安服务器收到请求后用同样的 Secret Key 重新计算签名，比对一致才执行。
必须注意三点：
- timestamp 必填，通常使用毫秒时间戳；现货 API 也支持微秒时间戳。recvWindow 以毫秒计，默认 5000ms，最大 60000ms。本机时间如果和币安服务器偏差超过 recvWindow，请求会被拒绝（错误码 -1021）。
- signature 字符串大小写规则取决于密钥类型：HMAC 模式下 signature 大小写不敏感；RSA / Ed25519 模式下 signature 大小写敏感。secretKey 和参数本身始终大小写敏感。
- 非 ASCII 字符必须 percent-encode 后再参与签名，否则签名会失败。
Python 代码示例：原生 requests 调用
下面这段代码不依赖任何第三方封装库，直接用标准库 + requests 调通账户查询接口：
import time
import hmac
import hashlib
import requests
from urllib.parse import urlencode
API_KEY = ‘你的API Key’
API_SECRET = ‘你的Secret Key’
BASE_URL = ‘https://api.binance.com’
def sign(params, secret):
query = urlencode(params)
return hmac.new(
secret.encode(‘utf-8’),
query.encode(‘utf-8’),
hashlib.sha256
).hexdigest()
def get_account_info():
path = ‘/api/v3/account’
params = {
‘timestamp’: int(time.time() * 1000),
‘recvWindow’: 5000
}
params[‘signature’] = sign(params, API_SECRET)
headers = {‘X-MBX-APIKEY’: API_KEY}
resp = requests.get(BASE_URL + path, params=params, headers=headers)
return resp.json()
if __name__ == ‘__main__’:
print(get_account_info())
跑通这段代码意味着你的 API Key、Secret、IP、权限、时间同步全部就绪。如果返回 -1022 Signature for this request is not valid，常见原因是 Secret Key 复制错、签名字符串和实际请求参数不一致、URL 编码不一致；如果返回 -2015 Invalid API-key, IP, or permissions，通常说明你的 IP 不在白名单、权限没开，或 API Key 本身无效。
币安 API 量化实战：ccxt 库快速上手
手写签名虽然可以理解原理，但写多了之后会发现：每个交易所的端点命名、参数风格、错误码体系都不一样。一旦你想做跨交易所策略，维护成本会指数级上升。这时候就该上 ccxt 这个库——它把大量交易所的 API 抽象成统一接口，币安、Bybit、Bitget 都在支持列表里。
安装：
pip install ccxt
初始化币安客户端 + 获取 K 线 + 查询账户 + 下限价单，一段代码全搞定：
import ccxt
binance = ccxt.binance({
‘apiKey’: ‘你的API Key’,
‘secret’: ‘你的Secret Key’,
‘enableRateLimit’: True, # 自动遵守币安限频
‘options’: {
‘defaultType’: ‘spot’, # spot / future / delivery / option
‘adjustForTimeDifference’: True # 自动校准时间戳
}
})
# 1. 加载市场
binance.load_markets()
# 2. 获取 BTC/USDT 最近 100 根 1 小时 K 线
ohlcv = binance.fetch_ohlcv(‘BTC/USDT’, timeframe=’1h’, limit=100)
# 3. 查询账户余额
balance = binance.fetch_balance()
print(balance[‘USDT’]) # {‘free’: xxx, ‘used’: xxx, ‘total’: xxx}
# 4. 下一个 BTC/USDT 限价买单
order = binance.create_limit_buy_order(
symbol=’BTC/USDT’,
amount=0.001,
price=50000
)
print(order)
切换到 U 本位合约通常只需要把 defaultType 改成 ‘future’，但实盘前必须确认账户模式、保证金模式、持仓模式、杠杆倍数和交易对命名是否与策略一致。enableRateLimit=True 这个参数非常重要，它会让 ccxt 在本地按限频规则自动 sleep，降低触发 429 的概率。
币安 API 限频规则（Rate Limit）
币安的限频系统在主流交易所里属于相对复杂的一类。理解它的运行方式，直接决定你的策略能不能扛得住高频请求。
权重制（Weight-based）
币安不是简单地数「每分钟请求数」，而是给每个端点定义了一个 weight（权重）。以现货 24hr ticker 为例，查询单个交易对的权重是 2，不传 symbol 查询全部交易对的权重是 80。现货的常见 REQUEST_WEIGHT 限制为每分钟 6000 权重，实际以 /api/v3/exchangeInfo 和接口响应头为准。
每次请求的响应头里都会带回当前已用权重：X-MBX-USED-WEIGHT-1M。你的程序应该在每个请求后读这个值，做本地的滑动窗口控制。
错误码与封禁阶梯
- HTTP 429：触发了限频，必须立即退避。响应头 Retry-After 告诉你需要等几秒。
- HTTP 418：连续违反 429 后被自动封禁 IP。封禁时间从 2 分钟起步，重复违规可延长到 3 天。
- HTTP 403：被 WAF（Web 应用防火墙）拦截，通常是请求模式被认定为异常或违反 WAF 规则。
实战建议
- 能用 WebSocket 解决的，尽量不要用 REST 高频轮询。行情流推送能显著降低 REST 权重压力。
- 使用 ccxt 时务必保留 enableRateLimit=True。
- 多账户/多策略共用同一 IP 时，权重池是共享的，要全局协调。
- 遇到 429 千万不要立即重试，至少按 Retry-After 退避，防止滑入 418。
API 安全使用 7 条军规
1. 一个业务一把 Key：现货、合约、监控、报税分别用独立 API Key，限制爆炸半径。
2. 永远绑定 IP 白名单：哪怕只是本地测试，也尽量用本机公网 IP 或固定服务器 IP 绑定。
3. Secret 离线存储：用密码管理器或密钥管理服务，绝不写进代码、git、云笔记。
4. 用环境变量加载：代码里写 os.environ[‘BINANCE_SECRET’]，配合 .env 文件 + .gitignore。
5. 定期轮换：每 30~90 天创建新 Key 替换旧 Key，类似强制改密码。
6. 优先考虑 Ed25519：进阶用户建议从 HMAC 迁移到 Ed25519，私钥不上传，长期安全性更好。
7. 监控异常调用：在 API 管理页面定期查看活跃 Key 列表与最近调用情况，发现陌生 IP 立即删除。
币安 vs Bybit vs Bitget：量化 API 怎么选
很多量化策略最终会跨交易所运行——主仓在币安，做市/对冲在 Bybit 或 Bitget。一张表看清三家的 API 差异：
选 Binance：流动性与产品广度的天花板
币安是全球成交量长期排名靠前的交易所之一，BTC/USDT、ETH/USDT 等主流交易对的盘口深度通常处于行业头部。如果你的策略对滑点敏感（高频做市、套利），币安通常是最重要的主交易所之一。注册可以用大白渠道，享受手续费返佣，具体比例以注册页面显示为准：
币安注册链接｜邀请码 DABAI｜20% 返佣｜注册图文教程
选 Bybit：适合合约执行与统一账户需求
Bybit 在永续合约和统一交易账户方面对量化用户较友好，现货 + 合约共享保证金的账户结构适合部分多品种策略。中文资料、社区资料和 API 使用案例也较多，适合以合约执行为核心的新手量化用户。
Bybit：邀请码 DABAI｜33% 自动 + 7% 手动返佣｜具体比例以后台实际结算为准
选 Bitget：复制交易生态突出，推广合作弹性较高
Bitget 在跟单交易（Copy Trading）领域有较强存在感，也比较重视内容创作者和代理合作。公开 Affiliate 资料通常写作最高 50% RevShare，覆盖现货、合约和 TradFi 等产品；如果大白渠道后台显示有专属比例（如现货 50%、合约 60%、链上 40%、TradFi 50%），应以注册页、代理后台或官方对接确认结果为准。
Bitget 注册链接｜邀请码 DABAI50｜专属返佣以注册页/后台显示为准｜注册图文教程
注册币安账户开始使用 API
到这里你应该已经理解了币安 API 从申请到调用的完整链路。最后一步是动手注册一个币安账户、开通 API。如果你还没有币安账户，建议直接走大白渠道，注册后可享受手续费返佣，量化高频跑起来一年能省下不少钱，具体比例以注册页面显示为准：
币安注册链接｜邀请码 DABAI｜20% 返佣｜注册图文教程
注册完成后按以下顺序操作：
1. 完成 进阶 KYC 实名认证
2. 通过 C2C 法币购买 USDT 激活现货账户
3. 下载 App（iOS 教程 / Android 教程）开启 2FA
4. 按本文流程创建 API Key、配置权限、绑定 IP 白名单
5. 跑通文中的 Python 代码示例，确认账户余额能正确返回
常见问题 FAQ
币安 API 是免费的吗？
币安 API 本身完全免费，没有调用费或订阅费。你只需要支付正常的交易手续费。任何号称要付费才能开通的「币安 API 服务」都要谨慎核实，避免钓鱼和代开骗局。
大陆 IP 能直接调用币安 API 吗？
不建议把大陆网络直连作为生产环境依赖。这里要区分两个问题：第一，币安的 API 权限规则主要看身份认证、API Key 类型、权限开关和 IP 白名单，不应简单写成「大陆 IP 创建 API 一律只读」；第二，大陆网络直连在稳定性、延迟和合规访问上存在不确定性。生产环境量化通常使用海外 VPS（如 AWS 东京、Vultr 新加坡、DigitalOcean 新加坡等），并把 VPS 固定公网 IP 加入白名单。
Secret Key 忘记了怎么办？
无法找回。Secret Key 在系统生成模式下仅在创建那一刻显示一次，币安后台不再展示明文。唯一的解决方案是删除该 API Key 重新创建一个新的，并把所有下游程序的配置同步更新。
API Key 被自动删除了是什么原因？
常见原因是：未绑定 IP 白名单 + 连续 30 天未发起任何请求，触发自动清理策略。解决办法是创建新 Key 后立即绑定 IP；即使暂时不用，也可以定期做一次低风险查询请求确认 Key 仍然可用。
币安 API 测试网怎么用？
币安测试网需要按产品区分。Spot Testnet REST 使用 https://testnet.binance.vision/api；USDⓈ-M Futures REST Testnet 使用 https://demo-fapi.binance.com；WebSocket Streams / WebSocket API 端点要按现货、U 本位合约等具体文档分别配置。测试网账户、密钥、资金都与主网隔离，可以放心试错。ccxt 里通常通过 binance.set_sandbox_mode(True) 切换测试环境，但仍要确认交易类型和 endpoint 是否匹配。
HMAC、RSA、Ed25519 三种密钥怎么选？
新手可以用 HMAC 起步（系统生成），上手最快，适合理解签名流程；长期运行的程序应优先考虑 Ed25519（自行生成），私钥永远不出本机，性能和安全性都更适合生产环境。RSA 可以作为非对称签名方案使用，但新项目通常优先考虑 Ed25519。
币安 API 报错 -1021 Timestamp 是什么意思？
本机时间与币安服务器时间偏差超过 recvWindow（默认 5000 毫秒）。常见原因是服务器时钟漂移，解决办法是开启 NTP 同步（Linux：sudo apt install chrony），或者在客户端代码里把 adjustForTimeDifference 打开（ccxt）/ 手动调用 /api/v3/time 校准。
Bybit、Bitget 的 API 流程和币安一样吗？
整体框架类似（创建 Key → 配置权限 → 绑定 IP → 签名请求），但端点路径、签名参数、passphrase 要求、错误码和限频规则各家不同。推荐用 ccxt 库统一封装，避免重复造轮子。三家的开户邀请信息见上文「币安 vs Bybit vs Bitget」一节。