API接入

币安API只读权限有什么用?行情查询与资产对账用法

币安API只读权限(Enable Reading)可以查询账户余额、订单与成交记录,但不能下单和提币。本文讲清只读密钥能做什么、如何创建、怎样用于行情查询与资产对账,并附风险提示。

币安 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:资产对账的做法是先固定一个对账时点,再用接口数据与自己的流水逐项核对。 这样可以避免因为数据实时变动而对不上账。

下面的步骤适合个人和小团队参考:

  1. 选定对账时间点,例如每月最后一天的固定时刻,并记录当时的时间戳。
  2. 通过只读接口读取该时刻的各币种可用与冻结余额。
  3. 读取区间内的成交记录、充值记录和提币记录。
  4. 用上期期末余额加本期流入、减去本期流出,计算出理论余额。
  5. 把理论余额与接口返回的实际余额对比,逐币种检查差异。

出现差异时,最常见的原因有手续费以其他币种扣除(例如使用 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 随时查看密钥状态。

继续浏览

对币安使用还有疑问?回到分类页查找同主题的其它教程。

分类导航

相关教程

币安API怎么申请?密钥签名一般要怎么生成 2026-04-14 币安Spot API怎么用?从零到第一单的可运行代码 2026-04-14 币安Futures和Spot API有什么区别?端点参数权重对比 2026-04-14 币安API会被封IP吗?限频策略与权重计算详解 2026-04-14