住宅代理账户余额怎么查：下单和续费前先核对

下单或续费前，先用控制台或官方余额接口核对 ZTProxy 账户余额。余额不足时接口会提示用户或目标用户余额不足。这与动态流量剩余不是同一笔账。不支持中国大陆。

要买动态住宅流量，或给静态住宅 IP 下单、续费，先核对的是账户余额，不是某一次代理请求有没有成功。官方余额文档写明：创建订单或续费前，请先确认账户余额。余额不够时，创建或续费接口会返回非 0 code 或 HTTP 错误，提示通常是「用户余额不足」或「目标用户余额不足」。

这不是怎么看动态流量剩余的另一写法。流量额度是已经买下的字节账；余额是用来支付新购买、续费或调整的钱包数字。充值步骤见用 USDT TRC20 充值。计费选型见按 GB 还是按 IP。仅限授权目标。不支持中国大陆使用。

开始前备齐什么

准备项从哪里来
已登录的控制台，或 API 访问令牌控制台可直接看余额；走接口须先登录，见怎么登录 API
余额查询接口官方文档给出仪表盘概览和当前用户余额两条路径
可选的交易记录用来核对某一笔充值或扣费是否已经入账，见消费和充值记录

占位符（非生产）：令牌示例 TOKEN_EXAMPLE_NOT_REAL。不要把文档里的示例余额数字当成你的实账户。本页不需要代理主机名；proxy.example.invalid 等占位符与查余额无关。

控制台与接口分别看什么

多数采购和运维只要在控制台确认当前余额，再决定是否充值或下单。若要用接口核对，官方文档提供两条路径，不要把它们和动态流量接口混用。

接口作用什么时候用
GET /open/app/dashboard/info/v2返回当前用户的仪表盘概览，其中包含余额和资源统计需要一并查看概览时
GET /open/app/user/balance/current只返回当前登录用户余额只想核对钱包数字时
控制台余额展示名称以实际界面为准日常下单前先看一眼

基础地址是 https://backend.ztproxy.net/api。需要认证的请求必须携带有效访问令牌。查询余额本身不会创建订单，也不会扣款。

查询当前余额示例

export ZTPROXY_BASE="https://backend.ztproxy.net/api"
export ZTPROXY_TOKEN="TOKEN_EXAMPLE_NOT_REAL"

curl -X GET "$ZTPROXY_BASE/open/app/user/balance/current" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN"

令牌放在 Authorization 请求头里，不要写进 URL。若返回 401，先按认证文档重新登录，不要把余额查询原样重试到底。文档没有把某一份 JSON 字段清单写成唯一余额字段名，读数时以控制台和接口实际返回为准，并与交易记录交叉核对。

余额不足时先做什么

情况建议
创建订单或续费提示「用户余额不足」或「目标用户余额不足」先充值或降低本次下单金额，再重新提交；不要把同一笔余额不足请求不停重试
刚完成 USDT 转账，余额还没变先按充值页核对订单状态，再查交易记录，最后再查一次余额
余额够，但动态流量已经用尽这是流量额度问题，不是钱包余额；见怎么看剩余流量
只想看消费明细，不需要下单直接查流水，不必先创建新订单

API 总览见住宅代理 API 对接。本页不复制整本接口文档，也不编造到账时效或最低充值额。

合规与范围

只用于授权目标。不要把本页写成绕过限制的教程。价格以控制台与价格方案为准（动态约 $0.40/GB，100 TB 整包约 $0.20/GB；静态共享约 $1.50、独享约 $5 /IP/月）。USDT/USDC 可用；Visa/Mastercard 申请中。不支持中国大陆使用。

FAQ

账户余额和动态流量剩余是一回事吗？

不是。余额用来支付新的购买或续费；动态流量剩余是已购资源按字节计算的额度。两笔账都要看，但不要合成一个数字。

查余额要不要传订单号？

官方余额接口按当前登录用户查询，不靠订单号得到钱包数字。要对某一笔扣费或充值，改查交易记录。

仪表盘接口和当前余额接口怎么选？

只需要钱包数字时，用当前用户余额接口。需要概览（文档写明其中包含余额和资源统计）时，用仪表盘接口。两者都要带有效令牌。

提示余额不足还要不要继续点下单？

不要原样反复提交。先充值或下调本次购买，确认余额后再下单或续费。

刚刚充值为什么余额还没变？

先核对该笔充值状态和交易记录，再查一次余额。不要把延迟当成「接口坏了」而重复创建充值订单。具体链见USDT 充值。

普通用户能不能查别人的余额？

本页只讲当前登录用户自己的余额。文档里「目标用户余额不足」出现在为指定用户创建或续费的场景，不要据此写成可随便查询他人钱包。

可以用余额页判断静态 IP 有没有开通成功吗？

不能单靠余额。扣费只说明可能已受理或已记账；静态资源是否可用，要按订单列表和状态判断，见购买静态住宅 IP。

价格以哪里为准？

以控制台与价格方案为准。文档或示例里的金额不是成交价。

下一步

  1. 在控制台或用当前余额接口核对数字。
  2. 不够就先充值，并在交易记录里确认入账。
  3. 余额足够后再购买动态流量或静态 IP。