---
title: "Get block statistics"
method: GET
path: "/v1/blocks/{blockNum}/stats"
---

# Get block statistics

`GET /v1/blocks/{blockNum}/stats`

Retrieves detailed statistical information for a specific block, including transaction counts and resource consumption.

## Path parameters

- `blockNum` integer, required

## Query parameters

- `get_tx_detail` boolean

## Response `200`

200

- object
  - `data` object[]
    - `txStat` object — An object containing transaction statistics. Only returned if `get_tx_detail` is set to `true`.
      - `trxAnd10TransferCount` integer — The number of TRX and TRC-10 transfer transactions.
      - `trc20And721TransferCount` integer — The number of TRC-20 and TRC-721 transfer transactions.
      - `trc1155TransferCount` integer — The number of TRC-1155 transfer transactions.
      - `transferCount` integer — The number of all transfer-type transactions.
      - `failTxCount` integer — The number of failed transactions.
      - `internalTxCount` integer — The number of all internal transactions generated within the block.
      - `containInternalTxCount` integer — The number of transactions that contain at least one internal transaction.
      - `contractTypeDistribute` object — The total count for each transaction type in the block, keyed by enum ID (see [here](https://github.com/tronprotocol/java-tron/blob/develop/protocol/src/main/protos/core/Tron.proto#L338) for details).
    - `feeStat` object — An object containing fee and resource consumption statistics.
      - `netUsage` integer — The total Bandwidth used in the block.
      - `energyUsage` integer — The total Energy consumed in the block.
      - `otherFee` number — Total fee (excluding Bandwidth and Energy) for all other operations. (Unit: TRX)
      - `srCandidateRegistrationFee` number — Total fee for Super Representative (SR) candidate registration. (Unit: TRX)
      - `accountActivationFee` number — Total fee for account activations. (Unit: TRX)
      - `permissionUpdateFee` number — Total fee for updating account permissions. (Unit: TRX)
      - `multiSignatureFee` number — Total fee for a multi-signature transaction. (Unit: TRX)
      - `memoFee` number — Total fee for including a memo in a transaction. (Unit: TRX)
      - `trc10AssetIssueFee` number — Total fee for issuing a TRC-10 token. (Unit: TRX)
      - `dexPairCreateFee` number — Total fee for creating a DEX trading pair. (Unit: TRX)
      - `dexOrderSellFee` number — Total fee for creating a DEX sell order. (Unit: TRX)
      - `dexOrderCancelFee` number — Total fee for cancelling a DEX order. (Unit: TRX)
      - `energyBurnFeeSunAmt` number — The total amount of TRX burned for Energy. (Unit: TRX) Note: the field name contains `Sun`, but the value is already TRX (divided by 1e6), e.g. `19.672` = 19.672 TRX.
      - `bandwidthConsumedFromBurnCnt` integer — The Bandwidth obtained by burning TRX.
      - `freeBandwidthUsageCnt` integer — The total usage of staked and free Bandwidth.
      - `bandwidthBurnFeeSunAmt` number — The total amount of TRX burned for Bandwidth. (Unit: TRX) Note: the field name contains `Sun`, but the value is already TRX (divided by 1e6), e.g. `19.672` = 19.672 TRX.
      - `energyConsumedFromOwnerBurnCnt` integer — The total Energy usage obtained by the transaction owner burning TRX.
      - `freeEnergyUsageCnt` integer — The total usage of staked Energy.
  - `success` boolean — Whether the request succeeded. `true` on success.
  - `meta` Meta — TronGrid response envelope — pagination + timing metadata. Present on every successful TronGrid v1 response.
    - `at` integer — Server timestamp when the response was generated. (Unit: millisecond)
    - `page_size` integer — Number of items returned in this page.
    - `fingerprint` string — Opaque pagination cursor. Pass back as the `fingerprint` query parameter to fetch the next page.
    - `links` object — Pagination links.
      - `next` string — URL for the next page (empty if this is the last page).

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/trongrid/apis/trongrid-v1-api.md) · [All operations](https://skmtc.dev/trongrid/apis/trongrid-v1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trongrid/trongrid-v1-api/revisions/22cc4dd60c4c/schema)