币安 API 怎么开通?基础下单接口入门
币安 API 开通分 4 步:账户安全设置、API 管理页创建、设置权限、绑定 IP。本文给完整开通流程与基础下单接口示例。
币安 API 怎么开通?**币安 API 开通分 4 步:账户开启 2FA、进入「API 管理」页面创建新 Key、命名并设置权限(读取/交易/提币)、复制 API Key + Secret 并绑定 IP 白名单。整个过程 5 分钟左右完成。**API 是币安提供给程序化交易者的接入口。
API 适合做量化策略、套利机器人、自动化交易的用户。普通手动交易者用 Web 或 App 即可。新手先在 币安官网 完成账号注册和 KYC,配合 币安官方App 接收 API 操作的 2FA 验证,iOS 用户先看 下载页 完成 Apple ID 切区。
API 开通的前置条件
A:币安 API 开通需要满足三个前置条件——账户已 KYC、已开启 2FA(Google Authenticator)、近期无安全告警。
| 前置项 | 不满足会怎样 |
|---|---|
| KYC 已通过 | 不能创建 API |
| 已开 2FA | 创建时被拒 |
| 近 24 小时无登录告警 | 系统会要求等待 |
币安官方帮助文档显示,新账户首次创建 API 后,提币功能默认锁定 24 小时——这是冷却期,期间通过 API 不能提币。
第 1 步:开启账户安全
A:创建 API 前必须先开启 2FA——这是币安的硬性要求。
2FA 选项:
| 类型 | 推荐度 |
|---|---|
| Google Authenticator | 极推荐 |
| 短信验证 | 备选 |
| 邮箱验证 | 备选 |
| YubiKey 硬件 | 最高安全 |
开启路径:账户头像 → 安全设置 → 双重身份验证 → Google Authenticator → 扫描二维码 → 输入 6 位验证码确认绑定。具体步骤详见本站「注册实战」分类。
第 2 步:进入 API 管理页
A:币安 API 管理页在「账户」-「API 管理」——只有 Web 端能创建,App 端只能查看。
进入路径:
| 端 | 路径 |
|---|---|
| Web 端 | 头像 → API 管理 |
| App 端 | 我的 → 账户安全 → API 管理(只读) |
| 桌面客户端 | 顶部菜单 → 账户 → API 管理 |
页面打开后会显示已有 API 列表(首次为空)。右上角「创建 API」按钮即开始创建流程。
第 3 步:创建并命名
A:创建 API 时给一个有意义的名字——便于后续管理多个 Key。
命名建议:
| 用途 | 推荐名字 |
|---|---|
| 网格机器人 | grid-bot-1 |
| 套利策略 | arb-strategy |
| 量化数据 | data-readonly |
| 跟单工具 | copy-trade |
命名后系统会要求输入:邮箱验证码 + Google Authenticator 6 位码 + 短信验证码(如绑定)。三道验证全部通过才能创建。创建成功后会显示 API Key 和 Secret Key——Secret 只显示一次,必须立刻复制保存。
第 4 步:设置权限
A:币安 API 权限分四档:读取、现货交易、合约交易、提币——按需勾选。
权限选项:
| 权限 | 风险等级 | 建议 |
|---|---|---|
| 读取信息 | 低 | 默认开 |
| 现货与杠杆交易 | 中 | 按需开 |
| 合约交易 | 高 | 按需开 |
| 万向钱包转账 | 中 | 谨慎开 |
| 提币 | 极高 | 严控 |
最小权限原则:用什么开什么。看行情数据只开「读取」,做现货机器人只开「现货交易」+「读取」。提币权限强烈建议关闭——除非确有自动提币需求,否则保持关闭可大幅降低被盗损失。
第 5 步:绑定 IP 白名单
A:绑定 IP 白名单后只有指定 IP 能用这个 API 调接口——这是 API 防盗的最关键防线。
| 配置 | 安全级别 |
|---|---|
| 不限 IP | 低(任何 IP 都能用) |
| 单 IP 限定 | 高 |
| 多 IP 列表 | 中(最多 30 个) |
如果你的服务器有固定公网 IP,必须绑定白名单。如果是动态 IP(如家用宽带),可以暂时不绑但要勤换 Key。云服务器(如 AWS、阿里云)一般有弹性 IP 可以绑定。
API 调用基础示例
A:币安 API 调用通过 HTTPS 请求 + HMAC SHA256 签名——支持多种语言(Python、Node.js、Go、Java 等)。
最简单的下单调用流程:
| 步骤 | 操作 |
|---|---|
| 1 | 拼请求参数(symbol、side、type、quantity、price) |
| 2 | 加 timestamp 和 recvWindow |
| 3 | 用 SecretKey 计算 HMAC SHA256 签名 |
| 4 | 把签名加到请求头 X-MBX-APIKEY |
| 5 | POST 到 /api/v3/order 接口 |
币安官方 GitHub 提供 binance-connector-python 等多语言 SDK,封装了签名和接口调用,新手用 SDK 更简单。
限频规则
A:币安 API 有严格的请求限频——超限会被暂时封禁。
主要限制:
| 维度 | 限制 |
|---|---|
| 每分钟请求权重 | 1200 |
| 每 10 秒下单数 | 100 |
| 每 24 小时下单数 | 200000 |
| 每 IP 每分钟连接 | 5 次(WebSocket) |
不同接口消耗权重不同。如 depth 接口 limit=5 消耗 1 权重,limit=1000 消耗 10 权重。下单接口消耗 1 权重。超限后返回 429 错误,反复触发会被封 IP 几分钟到几小时不等。
常见错误码
A:API 返回错误时第一时间检查错误码——币安错误码集中在 -1xxx 和 -2xxx。
| 错误码 | 含义 | 处理 |
|---|---|---|
| -1021 | 时间戳偏移过大 | 同步本地时间 |
| -2010 | 余额不足 | 检查现货钱包 |
| -1013 | 数量精度错 | 调整数量小数位 |
| -1100 | 参数非法 | 检查参数拼写 |
| -2014 | API Key 格式错 | 检查 Key 是否完整复制 |
币安官方文档有完整错误码列表,参考 binance-docs.github.io。
API Key 安全存储
A:API Key 和 Secret 必须严格保密——泄露等于把账户钥匙交给别人。
存储建议:
| 方式 | 安全级别 |
|---|---|
| 环境变量 | 高 |
| 加密配置文件 | 高 |
| 硬编码到代码 | 极低(绝对禁止) |
| GitHub 仓库(公开) | 灾难(立即被扫) |
GitHub 上每天都有爬虫扫描泄露的 API Key。一旦不小心 push 到公开仓库,几分钟内就会被恶意调用——立刻在币安「API 管理」里删除该 Key 并创建新 Key。
操作要点
币安 API 是把双刃剑——用好了是自动化交易的利器,用错了是资金安全的漏洞。新手刚开始用 API 建议三件事:开最小权限、绑定 IP 白名单、定期更换 Key。先在 币安官网 创建一个只读权限的 Key 跑读取行情、查余额这类无风险接口,熟练后再加交易权限做小额测试。币安官方App 上能查看 API 调用记录和告警,定期检查发现异常调用立即禁用。
延伸阅读:本站「现货下单」分类讲限价单的接口参数细节,「合约入门」分类讲 U 本位合约 API 与现货 API 的差异,「交易操作」分类讲订单簿 WebSocket 订阅。
FAQ
Q:币安 API 开通要钱吗? A:免费。开通和使用都不收费,只在实际下单成交时扣手续费(与 Web 端费率一致)。
Q:币安 API 能创建多少个? A:每账户最多 30 个 API Key。建议按用途分开创建——一个 Key 一个用途,便于权限隔离。
Q:币安 API Key 丢了能找回 Secret 吗? A:不能。Secret 只在创建时显示一次,丢了只能删除该 Key 重新创建一个。
Q:币安 API 删除后立刻失效吗? A:是的。点删除后该 Key 立即失效,所有用它的请求都会返回认证失败。
Q:币安 API 支持模拟盘测试吗? A:合约支持——testnet.binancefuture.com 是币安官方测试网。现货也有 testnet.binance.vision 测试环境,免费 API Key 可以做模拟下单。