01 / CAPABILITIES
开放功能
公共现货行情
读取盘口、K 线、近期成交及价格统计,构建现货行情工具。
接入要求普通公共端点无需私有账户授权;注意每个端点的安全类型和请求权重。
私有账户只读查询
查询现货余额、当前及历史订单、成交记录与账户佣金。
接入要求需有效密钥、相应读取权限与签名,不需要为读取任务启用交易或提现权限。
现货交易与订单管理
提交、取消和管理现货订单,具体订单类型以当前交易对规则为准。
接入要求需 TRADE 权限及现货资格,遵守数量、价格、名义金额和未成交订单等限制;默认系统生成 HMAC 密钥开启非只读权限时,需按官方要求设置 IPv4 IP 限制。
账户划转权限
Wallet 文档另列账户间资金划转能力,需与现货下单分别配置。
接入要求核对 enableInternalTransfer、permitsUniversalTransfer 等实际权限,以及具体方向的账号要求。
充提记录与提现
Wallet 接口提供充提记录、地址、额度与提现申请能力。
接入要求提现需开启相应权限并配置 IPv4 IP 限制,另受网络、额度及适用 Travel Rule 要求约束。
实时行情与账户事件
行情 Streams 推送市场数据,User Data Stream 推送余额和订单事件;WebSocket API 用于请求响应。
接入要求账户事件需授权;行情流、请求接口与用户事件分别使用对应连接和订阅方式。
现货测试网
使用测试资产验证现货接口,数据可能定期重置。
接入要求单独申请测试网密钥并使用测试端点;仅支持 /api,不支持 Wallet 等 /sapi 接口。
02 / REQUIREMENTS
接入条件
- 适用主体
- 行情与数据工具开发者、个人账户报表开发者、具备相应资格的现货工具开发者
- 接入方式
- 公共行情按端点安全类型接入 / API Key,REST 使用 X-MBX-APIKEY 请求头 / SIGNED 请求增加签名与时间戳 / 支持 HMAC、RSA 和 Ed25519 密钥类型
- 申请概况
- 公开行情部分免密钥;私有接口需合资格账户、API Key 与对应权限。
- 先核对所属地区与账号的服务资格,开户和具体产品均有独立限制。
- 正式账户创建 API Key 时,官方密钥指引要求身份验证、2FA 和现货钱包激活等条件,实际以账号页面为准;现货测试网使用独立入口和测试密钥,官方指引为通过 GitHub 登录申请。
- SIGNED 请求按密钥类型签名并带 timestamp,核对 recvWindow 与时钟。
- 现货读取、现货交易、划转和提现分别授权;默认 API Key 不具备 TRADE 权限。
- 默认安全控制下,未配置 IP 限制的系统生成 HMAC 密钥仅限读取;开启交易等非只读权限时,需设置 IPv4 IP 限制,或按官方说明采用满足要求的其他密钥方式。
03 / GET STARTED
开通步骤
- 01
确定现货任务
先区分公共行情、个人账户读取、订单操作或 Wallet 资金业务。
- 02
核对账号与地区
阅读适用条款并确认当前账号能否创建密钥及使用目标能力。
- 03
选择生产或测试网
现货开发验证使用对应测试网密钥和端点,保持配置独立。
- 04
按权限验证接入
核对签名、交易对规则、限频和回执查询,再完善实时事件与断线处理。
04 / COSTS & LIMITS
费用、边界与测试方式
费用概况接口开放条件与实际业务费用分开核对,金额以官方与账户结果为准。
- 已核对资料未确认覆盖全部 API 产品的统一调用套餐,不作全部免费承诺。
- 现货费率随账户等级、交易对及适用优惠等条件变化,可核对账户佣金接口与官方费率页。
- 提现费用、最低数量和网络状态按币种及网络查询,不套用固定费用。
使用范围与限制
- 本条目以 Binance.com 现货为主,不代表其他地区实体提供相同产品或资格。
- 合约、杠杆、期权、Wallet 等有独立文档和权限;现货测试网不能替代其他产品测试环境。
- Wallet 的 USER_DATA 标签也可能出现在提现等写操作上,不能仅凭该标签判断只读,应检查实际端点与密钥权限。
- REST 按 IP 请求权重及账户订单等规则限流;触发 429 后应退避,持续超限可能导致 418 封禁。
- WebSocket 有连接、消息和订阅限制;行情连接需处理心跳与重新连接。
- 请求超时或服务端异常可能留下未知执行状态,应查询订单或事件回执,避免直接重复提交。
- 公开文档和测试网可访问不构成任何特定地区或账号的生产接入资格证明。
如何进行开发测试
- Binance.com 现货生产环境
- Spot Test Network,专用密钥、测试资产与测试端点
- 其他产品环境按独立文档核对
接入前再确认
- 先确认服务实体、所属地区和账户的产品资格,再申请正式 API Key。现货测试网需独立配置。
- Wallet 的端点安全类型不能直接等同只读;请逐项检查密钥的实际授权。
05 / OFFICIAL SOURCES
官方资料
以下资料用于核对本页内容。申请与使用时,请以对应接口的最新规则为准。
- 01
- 02
- 03
- 04
- 05
- 06
- 07
- 08
- 09
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
官方文档核对,未进行接口实测
最近核验 2026-10-15 · 查看核验说明