> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tronrental.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 配额单位（WU）

> Node API 如何计量一次调用：公式、区块系数和新区块

## 什么是 WU

WU 是 Node API 的用量单位。您套餐的配额及其读取限制都以 WU 计。一次调用消耗的 WU 取决于节点响应的大小：节点返回的数据越多，它做的工作就越多。
大多数调用——账户、账户资源、合约调用、构建或广播交易——消耗 1 WU。

每个已应答的调用都会告诉您它的费用：HTTP 下为 `X-Node-API-WU` 响应头，gRPC 下为 `x-node-api-wu` 尾部元数据。控制台按天显示您的用量。

## 公式

```
WU = max(1, round((1.5 + 0.11 × KB) / 3.5 × factor))
```

* **KB**——节点响应的大小，以千字节计（字节数 ÷ 1024），按压缩前计算。gzip 节省的是流量，而不是 WU。
* **round**——四舍五入到最接近的整数；正好一半时向上取整。
* **factor**——系数，取决于调用的类型：

| 调用 | 系数 |
| - | - |
| 完整区块：`getnowblock`、`getblockbynum`、`getblockbyid`、带 `"detail": true` 的 `getblock`，以及区间方法 `getblockbylimitnext` 和 `getblockbylatestnum` | `0.65` |
| 整个区块的回执：`gettransactioninfobyblocknum` | `1.6` |
| 其他所有调用，包括带 `"detail": false` 的 `getblock`（仅区块头） | `1` |

同样的规则适用于 `/walletsolidity/*` 和 gRPC；在 gRPC 中，响应按 protobuf 大小计量，这些方法对应的 gRPC 方法（`GetNowBlock2`、`GetBlockByNum2`、`GetBlock`……）算作同类调用。

| 响应大小 | 系数 `1` | 区块，`0.65` | 回执，`1.6` |
| - | - | - | - |
| 10 KB | 1 | 1 | 1 |
| 50 KB | 2 | 1 | 3 |
| 100 KB | 4 | 2 | 6 |
| 200 KB | 7 | 4 | 11 |
| 500 KB | 16 | 10 | 26 |
| 800 KB | 26 | 17 | 41 |

系数为 `1` 时，约 34 KB 以内的响应消耗 1 WU。

## 新区块

距网络链头 **20 个以内**的区块——大约最近一分钟内的区块——固定收费 **3 WU**，其回执 **2 WU**，无论大小。尚未产生的区块按其（空）响应计费：1 WU。更早的区块及其回执按公式计费。

区间方法（`getblockbylimitnext`、`getblockbylatestnum`）始终按公式对整个响应计费，每次调用最多返回 10 个区块。

## 实测示例

| 调用 | 响应 | WU |
| - | - | - |
| `getaccount`、`triggerconstantcontract`、`getnodeinfo` | 几 KB | 1 |
| 带 `"detail": false` 的 `getblock` | 0.5 KB | 1 |
| `getnowblock` | 600–800 KB | 3 |
| `gettransactioninfobyblocknum`，新区块 | 230–290 KB | 2 |
| `getblockbynum`，旧区块 | 236 KB | 5 |
| `getblockbynum`，旧区块 | 783 KB | 16 |
| `gettransactioninfobyblocknum`，旧区块 | 110 KB | 6 |
| `gettransactioninfobyblocknum`，旧区块 | 179 KB | 10 |
| 带 `"num": 3` 的 `getblockbylatestnum` | 1.6 MB | 34 |

## 不计费的情况

* **拒绝。** 以错误 `code` 拒绝的请求（参见[限制与错误](/zh/node-api/errors)）不计费，也不带 `X-Node-API-WU`。
* **节点没有的方法**——`404 method_not_found`，带 `X-Node-API-WU: 0`。它仍会作为一次调用计入您的每秒限制，因此循环中的拼写错误只会被限速，而不会被计费。
* **节点无响应**——`502 node_error`。

节点自身返回的错误也是一种响应：java-tron 以 JSON（`{"Error": "…"}`）报告大多数错误，状态码通常为 `200`，这些错误与其他响应一样按大小计费——至少 1 WU。

## 估算您的用量

* 跟踪链上的每个区块——区块头（1 WU）加上新区块的回执（2 WU）——每个区块 3 WU：每天约 86,400 WU，30 天约 2.6M WU。
* 通过节点构建并广播一笔 USDT 转账为 2 WU。
* 读取旧区块是开销较大的部分：一个 600–800 KB 的旧区块为 13–17 WU。

配额按 WU 消耗；每秒限制按调用类别分别计数——每秒读取 WU、每秒区块请求数、每秒广播数。参见[限制与错误](/zh/node-api/errors)，以及[套餐与计费](/zh/node-api/plans)中各套餐的具体数值。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.