币安 API 的只读权限(界面显示为 Enable Reading)只能读取数据,不能下单、撤单或提币,适合用来做行情查询、资产对账和第三方记账工具授权。创建密钥需要先登录 币安官网 的账户后台,手机端用户也可以在 币安官方APP 中查看已有密钥;iPhone 用户可参考 iOS安装教程。需要注意的是,只读密钥虽然不能动资金,却能看到余额和历史成交,因此仍然属于敏感信息,不可随意交给他人。
只读权限到底能做什么、不能做什么
A:只读权限能查询账户余额、当前挂单、历史订单、成交明细、充值记录和提币记录,不能创建订单、不能取消订单、也不能发起任何提币。 币安创建 API 密钥时,默认只勾选读取权限,交易、提币、合约等权限都需要手动额外开启。
只读权限的价值在于把"看数据"和"动资金"彻底分开。用户把只读密钥交给报表工具、记账软件或自建脚本之后,即使密钥泄露,攻击者也无法直接转走资产或在市场上下单,损失范围被限制在隐私层面。
下面这张表把常见权限的能力做了对比,具体名称和选项以币安 API 管理页面当前显示为准:
| 权限类型 | 能否查询余额与记录 | 能否下单撤单 | 能否提币 | 泄露后的主要风险 |
|---|---|---|---|---|
| 仅读取(Enable Reading) | 可以 | 不可以 | 不可以 | 持仓与交易习惯被看到 |
| 现货与杠杆交易 | 可以 | 可以 | 不可以 | 被恶意下单造成亏损 |
| 合约交易 | 可以 | 可以(合约账户) | 不可以 | 被恶意开仓或爆仓 |
| 允许提币 | 可以 | 视其他勾选而定 | 可以 | 资产被直接转走 |
从表中可以看出,只读密钥是四种配置里风险最低的一种。日常只需要看数据的场景,应当优先选择只读,而不是为了省事勾选全部权限。
公开行情和只读密钥有什么区别
A:公开行情接口不需要任何密钥,只读密钥解决的是"查看自己账户数据"的问题。 币安的行情类接口,例如最新价格、K 线、深度、24 小时统计,属于公开数据,任何人不用登录就能调用。
很多新手误以为查询行情也必须申请 API 密钥,其实只需要一条 HTTP 请求。下面的命令可以直接查询 BTCUSDT 的最新价格:
curl "https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT"
返回结果是一段 JSON,包含交易对名称和最新成交价。只有涉及个人账户的数据,比如余额、挂单、成交历史,才需要带上 API Key 并对请求签名。
| 对比项 | 公开行情接口 | 只读密钥接口 |
|---|---|---|
| 是否需要 API Key | 不需要 | 需要 |
| 是否需要签名 | 不需要 | 需要(HMAC-SHA256) |
| 能获取的内容 | 价格、K线、深度、成交 | 余额、订单、成交、充提记录 |
| 是否涉及个人隐私 | 否 | 是 |
| 典型用途 | 看盘、行情看板、策略回测 | 资产对账、记账、持仓监控 |
只读权限的三类典型用法
A:只读密钥最常见的三类用法是资产对账、持仓监控和第三方工具授权。 三种场景都不要求动用资金,只需要稳定地读取账户数据。
用法一:资产对账
资产对账指的是把币安账户里的实际余额,与自己的账本或记账表格逐项核对。通过只读接口读取账户资产列表,再与自己记录的买入、卖出、充值、提币流水累加,就能发现遗漏的手续费、未记录的划转或自己漏记的交易。
对账时通常关注三个数字:可用余额、冻结余额和估值。冻结余额来自未成交的挂单,这一点容易被忽略,导致账本与接口返回数据对不上。
用法二:持仓监控
持仓监控是指定时拉取账户资产,再与公开行情价格相乘,得到总资产估值。很多个人看板、手机桌面小组件和消息提醒脚本,都属于这种用法。
这类脚本只读取数据,所以使用只读密钥即可。脚本运行在个人电脑、树莓派或云服务器上,都不需要开启交易权限。
用法三:第三方记账与税务工具授权
部分记账、资产汇总和税务整理工具,会要求用户提供只读 API 密钥来同步交易历史。这类工具自身不需要下单,因此只读权限足够;如果某个工具要求开启提币权限,应当立刻停止授权并核实来源。
第一步到第四步:创建一个只读 API 密钥
A:创建只读密钥一般需要四步:登录账号、进入 API 管理、创建并命名密钥、保存 Secret 并确认权限。 币安网页端和 APP 端的菜单位置可能随版本调整,以实际页面为准。
第一步:登录并准备好验证
先登录 币安官网,确认账号已完成必要的身份认证,并已启用两步验证(2FA)。创建 API 密钥时,币安通常会要求通过 2FA、邮箱或手机验证码确认操作。
第二步:进入 API 管理页面
在账户中心找到"API 管理"入口,选择创建新的 API 密钥。币安会让用户选择系统生成的密钥类型,并为密钥填写一个备注名称。备注建议写明用途,例如"只读-记账工具",方便日后区分。
第三步:核对权限并绑定 IP
创建完成后,密钥页面会显示权限列表。只读用途的密钥应当保持"启用读取",并确认交易、提币等其他权限处于关闭状态。同时建议填写 IP 访问限制,只允许自己的服务器或固定出口地址调用。
第四步:保存 Secret Key
API Key 可以随时在页面查看,但 Secret Key 通常只在创建时完整显示一次。立即把 Secret 保存到密码管理器或加密文件中,不要截图发到聊天群,也不要写进公开的代码仓库。具体的存储方案可以参考本站《币安API密钥怎么安全存》一文。
用只读密钥查询账户的基本流程
A:带签名的只读请求由三部分组成:API Key 放在请求头、请求参数中带时间戳、签名附在查询字符串末尾。 签名使用 Secret Key 对参数字符串做 HMAC-SHA256 计算。
下面是一个 Python 示例,演示如何从环境变量读取密钥,再查询现货账户信息:
import os, time, hmac, hashlib, requests
API_KEY = os.environ["BINANCE_API_KEY"]
API_SECRET = os.environ["BINANCE_API_SECRET"]
query = f"timestamp={int(time.time() * 1000)}"
signature = hmac.new(API_SECRET.encode(), query.encode(), hashlib.sha256).hexdigest()
resp = requests.get(
f"https://api.binance.com/api/v3/account?{query}&signature={signature}",
headers={"X-MBX-APIKEY": API_KEY},
)
for item in resp.json()["balances"]:
if float(item["free"]) > 0 or float(item["locked"]) > 0:
print(item["asset"], item["free"], item["locked"])
代码只输出非零余额。如果请求返回 401 或权限错误,应先检查密钥是否勾选了读取权限,以及调用的 IP 是否在白名单内。其余签名细节可以阅读本站《币安API签名怎么生成》一文。
常见的只读类接口包括:账户信息、当前挂单、历史订单、账户成交记录、充值历史和提币历史。具体路径与参数以币安官方 API 文档为准。
资产对账的实际做法
A:资产对账的做法是先固定一个对账时点,再用接口数据与自己的流水逐项核对。 这样可以避免因为数据实时变动而对不上账。
下面的步骤适合个人和小团队参考:
- 选定对账时间点,例如每月最后一天的固定时刻,并记录当时的时间戳。
- 通过只读接口读取该时刻的各币种可用与冻结余额。
- 读取区间内的成交记录、充值记录和提币记录。
- 用上期期末余额加本期流入、减去本期流出,计算出理论余额。
- 把理论余额与接口返回的实际余额对比,逐币种检查差异。
出现差异时,最常见的原因有手续费以其他币种扣除(例如使用 BNB 抵扣)、小额资产转换、活动奖励入账,以及不同账户(现货、资金、合约)之间的划转漏记。排查时应按币种逐项查,不要一次性合并比较。
| 差异来源 | 典型表现 | 排查方法 |
|---|---|---|
| 手续费扣除 | 余额略少于预期 | 查看成交记录中的手续费币种 |
| 账户间划转 | 现货余额突然变化 | 对照划转历史 |
| 活动奖励与空投 | 余额多出一笔 | 查看资金流水与公告 |
| 冻结余额 | 可用余额偏少 | 查询当前挂单 |
| 小额资产兑换 | 多个小币种消失 | 核对兑换记录 |
使用只读密钥的风险与安全提示
A:只读密钥不会让资金被转走,但会暴露持仓和交易行为,所以仍然需要按敏感凭证保管。 持仓信息一旦被他人获得,可能成为社会工程学攻击和钓鱼诈骗的素材。
下面是几条基本的安全规则:
- 只读用途的密钥不要勾选交易、合约和提币权限,权限越少越安全。
- 为密钥设置 IP 访问限制,只允许自己的固定地址调用。
- 每个工具或脚本使用独立的密钥,便于单独撤销。
- 不要把密钥发给自称客服或"代运营"的任何人,币安官方不会索取 Secret Key。
- 发现异常调用或不再使用某工具时,立即在 API 管理页面删除对应密钥。
- 第三方工具要求提币权限时,应视为高风险信号,拒绝授权。
同时需要提醒:本站是独立的第三方教程站,不是币安官方网站。API 的权限名称、页面入口和限制规则以币安官方页面和文档当前显示为准。加密资产价格波动剧烈,投资有风险;中国大陆用户使用相关服务时,请自行了解并遵守当地法律法规。
常见问题
Q:币安API只读权限能不能被人拿去提币? A:不能。只读权限不包含提币能力,提币需要单独开启"允许提币"权限。但只读密钥泄露后,持仓和成交记录会被看到,仍应及时删除并重新创建。
Q:只查看行情需要申请API密钥吗? A:不需要。最新价、K 线、深度等公开行情接口无需密钥和签名,直接发送 HTTP 请求即可获取。
Q:只读密钥可以不设置IP白名单吗? A:可以不设置,但不建议。设置 IP 限制后,即使密钥泄露,其他地址也无法使用。动态 IP 用户可以通过固定出口的云服务器转发请求。
Q:只读密钥能看到合约账户的数据吗? A:合约账户通常需要在密钥权限中额外启用合约相关选项,才能通过接口读取合约数据。具体选项以币安 API 管理页面显示为准。
Q:第三方记账工具要求我提供只读密钥,安全吗? A:权限上只读比较安全,但仍要确认工具来源可信、有明确的隐私说明,并为其单独创建密钥,不用时及时删除。
Q:只读接口调用返回权限错误怎么办? A:先确认密钥勾选了读取权限,再检查调用 IP 是否在白名单内、系统时间是否与币安服务器时间偏差过大,最后核对签名是否正确。
Q:只读密钥需要定期更换吗? A:建议定期轮换,并在人员变动、工具停用或怀疑泄露时立即更换。轮换周期没有统一标准,按自己的风险承受能力安排即可。
如果还没有币安账号,可以先通过 币安官网 完成注册与认证,再按本文步骤创建只读密钥;手机端可安装 币安官方APP 随时查看密钥状态。