币安(Binance)API 交易让用户用代码直接连接撮合引擎，常用接口分两类：REST 用于下单、撤单、查询，WebSocket 用于实时行情和订单回报推送。新手用 API 前先在「API 管理」生成 API Key 和 Secret，再用现货测试网练熟，最后才上主网做小额实盘。BatechiX 把 API 入门的关键步骤、限频规则、常见报错整理成清单。
API 适合有编程基础的进阶用户。可以从 币安官网 进入 API 管理生成 Key，移动端用 币安官方App 也能管理 API，苹果用户参考 iOS 安装教程。
API 类型速览
A：REST API、WebSocket、FIX 是三类主要接口，新手只用前两类即可。
| 类型 | 用途 | 适合 |
|---|---|---|
| REST | 下单、撤单、查询 | 大多数用户 |
| WebSocket | 行情推送、订单回报 | 实时策略 |
| FIX | 机构高频 | 机构 |
币安(Binance)的 API 文档非常详尽。新手第一次用 API 建议先看官方文档的 quick start，跑一遍最简单的现货下单示例。
生成 API Key
A：登录后进入「API 管理」点「创建 API」→ 命名 → 完成 2FA 验证 → 拿到 API Key 和 Secret。
| 步骤 | 操作 |
|---|---|
| 1 | 登录账户 |
| 2 | 进入 API 管理 |
| 3 | 点创建 API |
| 4 | 输入 API 名称 |
| 5 | 完成 2FA |
| 6 | 复制 Key 和 Secret |
Secret 只显示一次，关闭页面后无法找回。币安(Binance)建议立即把 Secret 保存到安全的密码管理器中。
API Key 的权限
A：现货读、现货交易、合约交易、提现，是四类权限，按需开启。
| 权限 | 风险 | 推荐 |
|---|---|---|
| 现货读 | 低 | 必开 |
| 现货交易 | 中 | 视需要 |
| 合约交易 | 中 | 视需要 |
| 提现 | 高 | 不建议开 |
| 划转 | 中 | 视需要 |
币安(Binance)的 API Key 提现权限默认关闭。新手不要随便开启提现权限，避免 Key 泄露后资产被转走。
IP 白名单
A：IP 白名单限定只有特定 IP 才能用 API Key，是 API 安全的最重要一环。
| 设置 | 安全等级 |
|---|---|
| 不设白名单 | 低 |
| 单 IP 白名单 | 高 |
| 多 IP 白名单 | 中 |
| 国家段白名单 | 中 |
服务器部署的量化策略一定要绑定服务器 IP。币安(Binance)的白名单可以多 IP，但每多一个就增加一份风险。
REST 现货下单示例
A：POST /api/v3/order，必填 symbol、side、type、quantity 或 quoteOrderQty。
| 参数 | 含义 |
|---|---|
| symbol | 交易对，如 BTCUSDT |
| side | BUY 或 SELL |
| type | LIMIT 或 MARKET |
| quantity | 币种数量 |
| price | 限价单价格 |
| timeInForce | GTC / IOC / FOK |
请求需要按规则签名（HMAC-SHA256）。币安(Binance)的官方 SDK 在 GitHub 提供多种语言示例。
中段提醒：API 入门后建议先在测试网练熟，币安官网 提供 testnet 入口，币安官方App 安卓 APK 直链可以在手机端管理 API，撮合速度 这一篇可以延伸阅读。
WebSocket 行情订阅
A：连接 wss://stream.binance.com:9443/ws/
| 流 | 内容 |
|---|---|
| btcusdt@kline_1m | 1 分钟 K 线 |
| btcusdt@trade | 实时成交 |
| btcusdt@depth | 深度更新 |
| btcusdt@ticker | 24 小时 ticker |
| !ticker@arr | 全部 ticker |
WebSocket 推送是单向的，订阅后服务器主动推送数据。币安(Binance)的连接稳定性很高，断线后客户端要实现自动重连。
限频规则
A：现货下单每秒 100 次、每天 20 万次、API 权重每分钟 1200。
| 限频项 | 配额 |
|---|---|
| 现货下单/秒 | 100 |
| 现货下单/天 | 200,000 |
| API 权重/分钟 | 1200 |
| 撤单/秒 | 100 |
| 行情请求 | 按权重 |
每个 API 接口都有权重值。币安(Binance)的官方文档为每个接口标注了权重，超过限频会返回 429 错误。
错误码常见解读
A：-1003 限频、-2010 余额不足、-1013 数量不合规、-2011 撤单已完成。
| 错误码 | 含义 |
|---|---|
| -1003 | 请求过频 |
| -2010 | 余额不足 |
| -1013 | 价格或数量不合规 |
| -2011 | 撤单失败 |
| -1021 | 时间戳偏差大 |
| -1022 | 签名错 |
错误码 -1021 是常见问题：本地时间和服务器时间偏差超过 1 秒。币安(Binance)建议每次请求前同步服务器时间。
测试网怎么用
A：testnet.binance.vision 是币安(Binance)的现货测试网，提供假币用于测试。
| 测试网 | 地址 |
|---|---|
| 现货测试 | testnet.binance.vision |
| 合约测试 | testnet.binancefuture.com |
| 文档 | binance-docs.github.io |
测试网账户需单独注册。新手在测试网把策略跑通再上主网，能大幅减少实盘错误。
常用编程语言
A：Python、JavaScript、Go、Rust 都有币安(Binance)的官方或社区 SDK。
| 语言 | 推荐库 |
|---|---|
| Python | python-binance |
| JavaScript | node-binance-api |
| Go | go-binance |
| Java | binance-java-api |
| Rust | binance-rs |
新手用 Python 最容易入门。币安(Binance)的 Python SDK 文档完善，社区活跃。
API 安全实践
A：Secret 不上传 Git、Key 限 IP、关闭提现权限、定期轮换、监控异常。
| 实践 | 说明 |
|---|---|
| 不上传 Git | 用环境变量 |
| 限 IP | 强烈推荐 |
| 关提现权限 | 默认关闭 |
| 定期轮换 | 季度一次 |
| 监控异常 | 设异常告警 |
API Key 一旦泄露，黑客可能通过频繁低买高卖把账户余额"消耗"掉。币安(Binance)的 API 监控页面可以看到每个 Key 的使用记录。
常见问题（FAQ）
Q：币安 API 谁能用？ A：所有完成 KYC 的用户都能开 API。新手不必着急用，把 Web/App 玩熟再考虑 API。
Q：API Key 丢了怎么办？ A：立即在「API 管理」删除该 Key 并创建新 Key。币安(Binance)的旧 Key 删除后立即失效。
Q：API 限频触发怎么处理？ A：返回 429 错误时停 1-2 秒再发。币安(Binance)的限频是滚动窗口，等几秒就恢复。
Q：API 能不能下合约单？ A：能。合约 API 是 fapi.binance.com 域名，文档和接口与现货独立。
Q：API 实盘前要做什么？ A：先在 testnet 把策略跑通，确认无错误后用主网小额（如 14 USDT）实盘验证，最后再上正式资金。
Q：API 速度比 Web 快多少？ A：约 30-100 毫秒。币安(Binance)的 API 直连撮合，省了浏览器渲染时间。
写在最后
币安(Binance)API 交易包含 REST 和 WebSocket 两大类，REST 用于下单撤单查询、WebSocket 用于实时推送。新手用 API 前先开 Key、设 IP 白名单、关提现权限、在 testnet 练熟，最后小额实盘。限频每秒 100 次现货下单，对手动用户完全够用。错误码看官方文档对照排查，最常见的 -1021 是时间戳偏差问题。
加密资产价格波动剧烈，本文不构成投资建议。可以从 币安官网 进入 API 管理，币安官方App 安卓 APK 直链支持移动端管理 API，苹果用户先看 iOS 安装教程。
BatechiX 是独立第三方文档站，与 Binance 公司没有任何隶属、代理或商业合作关系。