币安官网对普通用户而言就是 www.binance.com，但对开发者来说情况要复杂得多：真正写代码要连的不是前台页面，而是 api.binance.com、stream.binance.com、fapi.binance.com 这一串主机名。很多新接入的程序员被钓鱼文档和山寨 SDK 坑过，核心原因就是没把"面向用户的官网"和"面向开发者的官网"分开看。先从币安官网完成账户与 API Key 的准备，再把币安官方APP装上用于二次验证推送，iPhone 端的配置可以参考 iOS 安装教程。
下面完全从开发者视角把币安官网的入口结构讲清楚，包含文档入口识别、生产环境与 Testnet 区分、SDK 下载源校验、WebSocket 主机列表以及 changelog 订阅方式。
币安开发者官网的几个正确入口
面向开发者的文档不挂在 www.binance.com 的一级导航里，而是分散在几个独立子域名和 GitHub 组织下。只认这几个入口就不会走错。
主文档站 developers.binance.com
developers.binance.com 是币安开发者门户的统一入口，下面聚合了 Spot、Futures、Margin、Wallet、Staking 各条接口的参考手册。页面右上角可以切换 Change Log，每次 API 更新会有精确到分钟的时间戳。
这个域名的 TLS 证书签发主体是 Binance Holdings Ltd，和主站 binance.com 走同一套证书链。如果你打开之后证书主体对不上，基本就是被劫持了。
GitHub 组织 binance
官方代码仓库集中在 github.com/binance 组织下，这是验证 SDK 和示例代码真伪的最高权威来源。几个常用的仓库：
- binance-spot-api-docs：现货 REST/WebSocket 协议规范
- binance-futures-connector-python：U 本位合约 Python 连接器
- binance-connector-node：Node.js 官方 SDK
- binance-api-postman：Postman 调试集合
GitHub 组织页下方可以看到 Verified 徽章，这个徽章要通过 DNS TXT 记录绑定到 binance.com 才能获得，山寨组织仿不出来。
币安学院的技术文章入口
academy.binance.com 是内容站，不是接口站，但它下面的 "Developer" 标签会发布协议设计解读、费率结构变更、撮合引擎行为说明这类深度内容，对理解接口背后的业务逻辑很有帮助。
生产环境和 Testnet 主机名的区分方式
币安给开发者准备了完整的 Testnet 环境，但 Testnet 和生产环境的主机名非常容易混淆。接错主机会导致两种灾难性后果：用真钱去测试，或者用测试钱去实盘。
现货接口主机清单
| 用途 | 生产环境 | Testnet |
|---|---|---|
| REST API | api.binance.com | testnet.binance.vision |
| WebSocket Stream | stream.binance.com:9443 | stream.testnet.binance.vision:9443 |
| WebSocket API | ws-api.binance.com:443 | ws-api.testnet.binance.vision:443 |
特别注意 Testnet 用的是 binance.vision 这个独立域名，不是 binance.com 的子域名。这是币安故意为之，避免生产密钥和测试密钥因为域名接近而误用。
合约接口主机清单
| 用途 | 生产环境 | Testnet |
|---|---|---|
| U 本位 REST | fapi.binance.com | testnet.binancefuture.com |
| U 本位 WS | fstream.binance.com | stream.binancefuture.com |
| 币本位 REST | dapi.binance.com | testnet.binancefuture.com |
| 币本位 WS | dstream.binance.com | dstream.binancefuture.com |
合约 Testnet 走的是 binancefuture.com，又是一个独立域名。看到代码里 host 写着 binance.com 但 path 里带 /fapi，大概率是老版本 SDK 用了统一域名转发，新版本都拆开了。
API Key 在两个环境不通用
生产环境的 API Key 无法用于 Testnet，反之亦然。Testnet 的 Key 在 testnet.binance.vision 页面用 GitHub 账号登录生成；生产 Key 则在币安官网账户安全页面创建。两套体系完全隔离，泄露 Testnet Key 不会影响真实资金。
SDK 下载源的真伪校验
开发者生态里最常见的攻击是 pip 仿冒包和 npm 仿冒包，仿冒的命名极具迷惑性。下载 SDK 一定要走以下几个正规源。
Python 包的正确名称
币安没有一个叫 "binance" 的官方 Python 包，想连接口要用下面这两个之一：
- binance-connector：官方维护，PyPI 上发布者是 Binance
- python-binance：社区老牌库，作者 Sam McHardy，被官方引用
下面这些名字都是仿冒：binance-api、binancepy、pybinance、binance-sdk（注意带连字符的早期伪装版本）。PyPI 上可以查发布者邮箱域名，官方包的发布者邮箱一定是 @binance.com。
包完整性校验
pip 从 2023 年开始支持 hash 校验，在 requirements.txt 里锁死哈希可以防止中间人替换：
binance-connector==3.7.0 \
--hash=sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
哈希值可以在 PyPI 页面的 "Download files" 下找到，对比无误再安装。
Node.js 包的命名
npm 上官方包的 scope 是 @binance/connector，带 @binance 这个 scope 是 npm 层面做了组织验证的，仿冒者无法注册。不带 scope 的 node-binance-api 是社区老库，也相对可信，但不是官方。
Go 与 Rust 的情况
Go 官方没有发布 SDK，现在主流的是社区维护的 adshao/go-binance，作者 adshao 是币安早期的合作开发者，代码质量较高。Rust 方面官方也没覆盖，ccxt-rust 和 binance-rs 是两个社区实现，使用前自行审计。
WebSocket 长连接的运维细节
REST 接口用一次算一次，WebSocket 连上去要跑很久，运维层面的坑比 REST 多得多。
24 小时强制断开
币安现货 WebSocket 有一条硬性规则：单条连接最多保持 24 小时，到点服务端会主动断开。开发者要实现断线重连逻辑，最好在 23 小时左右主动重连，而不是等到被踢。
PING/PONG 心跳
服务端每 3 分钟发一次 PING 帧，客户端必须在 10 分钟内回 PONG，否则会被断开。大部分 WebSocket 库会自动处理，但有些底层实现不会，这种情况要手动 hook 心跳帧。
订阅数量上限
单条连接最多订阅 1024 个流，超过会收到错误码 -1013。对于要同时监控大量交易对的系统，需要在客户端做多连接分组。
组合流的写法
组合流的 URL 格式是 stream.binance.com:9443/stream?streams=btcusdt@trade/ethusdt@kline_1m，多个流用斜杠分隔。单流则是 stream.binance.com:9443/ws/btcusdt@trade，path 不一样。
API 变更的追踪方式
币安 API 的变更频率比多数交易所高，不订阅变更日志很容易踩到接口下线或者字段含义变化。
官方 Change Log 位置
Change Log 在 binance-docs.github.io 和 developers.binance.com 两处同步发布，历史条目可以翻到 2017 年。每条变更都会注明 UPDATE、NEW、DEPRECATED 三种标签。
GitHub Release 订阅
github.com/binance/binance-spot-api-docs 仓库可以 Watch → Releases only，每次协议文档提交会触发邮件通知，比网页轮询更可靠。
预警邮件列表
API 重大变更会提前 2 周到 2 个月在账户注册邮箱发通知。所以绑定 API Key 的账户一定要用常用邮箱，不要用临时邮箱。
限频策略调整
频率限制属于最容易静默变更的部分。币安在 HTTP 响应头里会实时返回 X-MBX-USED-WEIGHT-1M，监控这个值的变化趋势比翻文档更能及时感知策略调整。
安全接入清单
接入前检查这几条能避开 95% 的安全坑：
- IP 白名单必须开：API 管理页面勾选 "Restrict access to trusted IPs only"，不开等于在公网裸奔
- 权限最小化：只读密钥和交易密钥分开创建，提现权限默认不要勾选
- 密钥不入代码库：用环境变量或 Vault，在 CI 里用 gitleaks 扫一遍避免误提交
- 强制走 HTTPS：任何 HTTP 版本的 API 调用都要拒绝，防中间人
- 签名用 HMAC-SHA256：参数按字典序拼接，timestamp 和 signature 顺序别搞反
- recvWindow 不超过 5 秒：默认 5000ms，设太大等于给攻击者更长的重放窗口
FAQ 常见问题
Q1：官网文档页和 binance-docs.github.io 内容一样吗？
两边会短时间不同步。binance-docs.github.io 是 GitHub Pages，更新由代码提交触发；developers.binance.com 是由官网 CDN 分发的静态资源，两者之间一般会差几分钟到几小时。追最新协议看 GitHub Pages 更靠谱。
Q2：Testnet 上的订单会影响真实账户吗？
完全不会。Testnet 是独立的撮合系统，资金是领取的测试币，订单簿也和主网隔离。唯一的相关性是行情数据来源于主网快照，所以价格走势看起来和真实市场类似。
Q3：Python 包 python-binance 和 binance-connector 选哪个？
看需求。binance-connector 是官方维护，接口覆盖最新但 API 风格偏函数式；python-binance 是社区版本，封装更抽象，同步异步都支持，文档示例更丰富。生产环境建议 connector，快速原型用 python-binance。
Q4：WebSocket 断线重连要做指数退避吗？
要做。币安在异常流量时会临时封 IP，不做退避会反复触发封禁。推荐策略：首次 1 秒，之后每次 ×2，上限 60 秒，成功后重置计数。
Q5：币安有类似 OKX 的 Demo Trading 吗？
有但叫法不同。现货叫 Testnet（testnet.binance.vision），合约叫 Binance Futures Testnet（testnet.binancefuture.com）。两者入口和 API Key 体系都独立，不像 OKX 是通过同一个账户切换模拟盘。