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

# getchaintxstats

Compute statistics about the total number and rate of transactions in the chain.

This method will use `10` [Compute Units](/nodeapi/about/billing).

***

## **Reference:** [**Here**](https://developer.bitcoin.org/reference/rpc/getchaintxstats.html)

## **Parameters**

**`nblocks`** - numeric, optional, default=one month

Size of the window in number of blocks

**`blockhash`** - string, optional, default=chain tip

The hash of the block that ends the window.

## Returns

```json theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
{                                       (json object)
  "time" : xxx,                         (numeric) The timestamp for the final block in the window, expressed in UNIX epoch time
  "txcount" : n,                        (numeric) The total number of transactions in the chain up to that point
  "window_final_block_hash" : "hex",    (string) The hash of the final block in the window
  "window_final_block_height" : n,      (numeric) The height of the final block in the window.
  "window_block_count" : n,             (numeric) Size of the window in number of blocks
  "window_tx_count" : n,                (numeric) The number of transactions in the window. Only returned if "window_block_count" is > 0
  "window_interval" : n,                (numeric) The elapsed time in the window in seconds. Only returned if "window_block_count" is > 0
  "txrate" : n                          (numeric) The average rate of transactions per second in the window. Only returned if "window_interval" is > 0
}
```

<CodeGroup>
  ```bash title="mainnet" theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
  curl https://mainnet.bitcoin.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
   -X POST \
   -H "Content-Type: application/json" \
   -d '{
  	"jsonrpc": "1.0",
  	"id": "curltest",
  	"method": "getchaintxstats",
  	"params": []
  }'
  ```

  ```bash title="testnet" theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
  curl https://testnet.bitcoin.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
   -X POST \
   -H "Content-Type: application/json" \
   -d '{
  	"jsonrpc": "1.0",
  	"id": "curltest",
  	"method": "getchaintxstats",
  	"params": []
  }'
  ```
</CodeGroup>


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