GET /apiv2/billing/account

一览您的后付费账户：Netts 设置的信用额度、您自己设置的总体限额、您的欠款金额以及当前仍可消费的额度。属于后付费计费的一部分。

接口 URL

GET https://netts.io/apiv2/billing/account

请求头

请求头	必填	描述
X-API-KEY	是	具有 billing.read 权限的 API 密钥
X-Real-IP	是	密钥白名单中的地址

该请求无参数。

示例

curl -s 'https://netts.io/apiv2/billing/account' \
  -H 'X-API-KEY: your-api-key' \
  -H 'X-Real-IP: 203.0.113.10'

{
  "success": true,
  "data": {
    "mode": "postpaid",
    "adminLimit": {
      "id": 1,
      "origin": "netts",
      "limit": { "unit": "USD", "value": "30000.000000" },
      "used": { "unit": "USD", "value": "1250.400000" },
      "available": { "unit": "USD", "value": "28749.600000" },
      "creditApplied": { "unit": "USD", "value": "0" },
      "status": "ok",
      "revision": 3,
      "editable": false
    },
    "clientLimit": {
      "id": 4,
      "origin": "client",
      "limit": { "unit": "USD", "value": "5000.000000" },
      "used": { "unit": "USD", "value": "1250.400000" },
      "available": { "unit": "USD", "value": "3749.600000" },
      "creditApplied": { "unit": "USD", "value": "0" },
      "status": "ok",
      "revision": 2,
      "editable": true
    },
    "effectiveAvailable": { "unit": "USD", "value": "3749.600000" },
    "pendingUnbilled": { "trx": "0", "count": 0 },
    "asOf": "2026-10-19T20:24:26.474237+00:00",
    "settlement": { "asset": "USDC", "network": "ethereum", "paymentTermsDays": 5 },
    "limit": { "unit": "USD", "value": "30000.000000" },
    "unpaid": { "TRX": "3778.500000", "USDC": "1250.400000" },
    "creditUsdc": "0",
    "available": "28749.600000",
    "availableTrxEquiv": "86897.437285",
    "availableUsdEquiv": "28749.600000",
    "fx": { "usdPerTrx": "0.33084276", "at": "2026-10-19T20:24:23.449930+00:00" },
    "fxStatus": "ok"
  },
  "timestamp": "2026-10-19T20:24:26+00:00"
}

响应字段

字段	描述
mode	postpaid，或在该账户的后付费计费暂停时为 prepaid
adminLimit	Netts 设置的信用额度。editable 始终为 false
clientLimit	您自己设置的总体限额；如果您尚未设置，则为 null
adminLimit.used / clientLimit.used	已占用的额度
adminLimit.available / clientLimit.available	剩余的额度
creditApplied	来自多付金额的信用额，已在此限额中抵扣欠款
status	ok、limit_reached，或在当前无法计算时为 unavailable
effectiveAvailable	您当前可消费的额度：两个 available 值中的较小者
pendingUnbilled	已接受但费用仍在记录中的订单：其 TRX 总额及订单数量
asOf	数据计算的时间点
settlement	您根据合同支付账单的方式：币种、网络以及支付账单的期限天数
limit, unpaid, creditUsdc, available	Netts 限额、以 TRX 和合同币种表示的未支付金额、您的信用额，以及 Netts 限额的剩余部分
availableTrxEquiv, availableUsdEquiv	按 fx 中的汇率换算的 available；无可用汇率时为 null
fx	TRX 兑换您合同币种的当前汇率以及获取时间。此为用于比较的预估值，并非未来订单的汇率 — 参见记录的汇率
fxStatus	ok，或 unavailable（此时等值金额为 null，但金额仍会显示）

used 和 available 的计算方式与订单检查相同，因此 effectiveAvailable 即为下一笔订单可使用的金额。产品限额请见限额。

错误响应

HTTP	code	含义
401	-1, -2	密钥缺失或无效，或者 IP 不在白名单中 — 由 API 网关返回，参见响应格式
403	billing_read_required	密钥缺少 billing.read 权限
403	postpaid_required	该账户未开通后付费计费

所有错误代码均列在后付费计费中。