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

# eth_getBlockTransactionCountByNumber | Hyperliquid EVM

> The eth_getBlockTransactionCountByNumber JSON-RPC method returns the number of transactions in a block by its number. On Hyperliquid EVM.

<Info>
  This method is available on Chainstack. Not all Hyperliquid methods are available on Chainstack, as the open-source node implementation does not support them yet — see [Hyperliquid methods](/docs/hyperliquid-methods) for the full availability breakdown.
</Info>

The `eth_getBlockTransactionCountByNumber` JSON-RPC method returns the number of transactions in a block by its number. This method provides a lightweight way to get transaction count information for sequential block analysis, making it efficient for building statistics and monitoring network activity over time.

## Parameters

The method takes one parameter:

1. **Block number** - The number of the block to get the transaction count for

### Parameter details

* `blockNumber` (string, required) — Block identifier: `"latest"`, `"earliest"`, `"pending"`, or a specific block number in hexadecimal

## Response

The method returns the number of transactions in the specified block as a hexadecimal string, or `null` if the block is not found.

### Response structure

**Transaction count:**

* `result` — The number of transactions in the block as a hexadecimal string

### Data interpretation

**Count format:**

* Returned as hexadecimal string with `0x` prefix
* Convert to decimal for numerical operations
* `0x0` indicates an empty block (no transactions)
* `null` indicates the block number doesn't exist

**Block number formats:**

* `"latest"` — Most recent block transaction count
* `"earliest"` — Genesis block transaction count (usually 0)
* `"pending"` — Pending block transaction count
* `"0x9d0c37"` — Specific block number (10,291,255 in decimal)

## Usage example

### Basic implementation

```javascript theme={"system"}
// Get transaction count for a block by number on Hyperliquid
const getBlockTransactionCountByNumber = async (blockNumber) => {
  const response = await fetch('https://hyperliquid-mainnet.core.chainstack.com/YOUR_ENDPOINT/evm', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      method: 'eth_getBlockTransactionCountByNumber',
      params: [blockNumber],
      id: 1
    })
  });
  
  const data = await response.json();
  
  if (data.result === null) {
    throw new Error('Block not found');
  }
  
  return {
    hex: data.result,
    decimal: parseInt(data.result, 16)
  };
};

// Analyze a range of blocks for activity patterns
const analyzeBlockRange = async (startBlock, endBlock) => {
  const results = [];
  
  for (let i = startBlock; i <= endBlock; i++) {
    const hexBlock = "0x" + i.toString(16);
    try {
      const count = await getBlockTransactionCountByNumber(hexBlock);
      results.push({
        blockNumber: i,
        hexBlockNumber: hexBlock,
        transactionCount: count.decimal
      });
    } catch (error) {
      console.error(`Error processing block ${i}:`, error);
      results.push({
        blockNumber: i,
        hexBlockNumber: hexBlock,
        transactionCount: null,
        error: error.message
      });
    }
  }
  
  // Calculate statistics
  const validCounts = results
    .filter(r => r.transactionCount !== null)
    .map(r => r.transactionCount);
  
  if (validCounts.length === 0) {
    return { results, statistics: null };
  }
  
  const statistics = {
    totalBlocks: validCounts.length,
    totalTransactions: validCounts.reduce((sum, count) => sum + count, 0),
    averageTransactions: validCounts.reduce((sum, count) => sum + count, 0) / validCounts.length,
    maxTransactions: Math.max(...validCounts),
    minTransactions: Math.min(...validCounts),
    emptyBlocks: validCounts.filter(count => count === 0).length
  };
  
  return { results, statistics };
};

// Get latest block transaction count
const getLatestBlockTransactionCount = async () => {
  return await getBlockTransactionCountByNumber('latest');
};

// Usage examples
getLatestBlockTransactionCount()
  .then(count => console.log(`Latest block has ${count.decimal} transactions`))
  .catch(error => console.error('Error:', error));

// Analyze blocks 100-110
analyzeBlockRange(100, 110)
  .then(analysis => {
    console.log('Block Range Analysis:', analysis.statistics);
    console.log('Detailed Results:', analysis.results);
  })
  .catch(error => console.error('Error:', error));
```

## Sequential analysis benefits

### Range processing

**Efficient bulk analysis:**

* Query transaction counts across block ranges efficiently
* Build activity timelines and trend analysis
* Generate network utilization statistics
* Identify periods of high and low activity

### Block number formats

**Special identifiers:**

* `"latest"` — Most recent block transaction count
* `"earliest"` — Genesis block transaction count (usually 0)
* `"0x9d0c37"` — Specific block number (10,291,255 in decimal)

## Example request

<CodeGroup>
  ```shell Shell theme={"system"}
  curl -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0x9d0c37"],"id":1}' \
    https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm
  ```

  ```python web3.py theme={"system"}
  from web3 import Web3

  w3 = Web3(Web3.HTTPProvider("YOUR_CHAINSTACK_ENDPOINT"))

  # Block 0x9d0c37 (10,291,255). Pass an int for by-number, or "latest" for the tip.
  count = w3.eth.get_block_transaction_count(10291255)
  print(count)
  ```

  ```javascript ethers.js theme={"system"}
  import { JsonRpcProvider } from "ethers";

  const provider = new JsonRpcProvider("YOUR_CHAINSTACK_ENDPOINT");

  // ethers v6 has no high-level wrapper for this RPC, so call it directly.
  const count = await provider.send("eth_getBlockTransactionCountByNumber", ["0x9d0c37"]);
  console.log(parseInt(count, 16));
  ```

  ```typescript viem theme={"system"}
  import { createPublicClient, http } from "viem";

  const client = createPublicClient({
    transport: http("YOUR_CHAINSTACK_ENDPOINT"),
  });

  // blockNumber is a bigint; omit it (or use blockTag: "latest") for the tip.
  const count = await client.getBlockTransactionCount({ blockNumber: 10291255n });
  console.log(count);
  ```
</CodeGroup>

<Note>
  **Use your own endpoint in your code.** The code examples use a placeholder Chainstack endpoint (YOUR\_CHAINSTACK\_ENDPOINT) — replace it with your own Hyperliquid node endpoint from the [Chainstack console](https://console.chainstack.com/). The curl above uses a shared public endpoint for quick checks only; do not use it in production.
</Note>

## Use cases

The `eth_getBlockTransactionCountByNumber` method is essential for applications that need to:

* **Sequential analysis**: Analyze transaction counts across block ranges efficiently
* **Network monitoring**: Track blockchain activity and usage patterns over time
* **Statistics generation**: Build comprehensive network activity statistics
* **Block explorers**: Display transaction counts in sequential block listings
* **Analytics platforms**: Collect activity data for network analysis and trends
* **Real-time monitoring**: Track current network activity using "latest" block
* **Development tools**: Optimize applications based on network activity levels
* **Data visualization**: Create time-series charts of block activity patterns

<Note>
  This method supports special block identifiers like `"latest"` and `"earliest"`, making it suitable for both historical analysis and real-time monitoring. The count includes both regular transactions and system transactions from HyperCore.
</Note>


## OpenAPI

````yaml openapi/hyperliquid_node_api/hyperevm/evm_eth_get_block_transaction_count_by_number.json post /evm
openapi: 3.0.0
info:
  title: Hyperliquid EVM API - eth_getBlockTransactionCountByNumber
  version: 1.0.0
servers:
  - url: >-
      https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274
security: []
paths:
  /evm:
    post:
      summary: eth_getBlockTransactionCountByNumber
      description: Returns the number of transactions in a block by its number.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - method
                - params
                - id
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  default: '2.0'
                  description: JSON-RPC version
                method:
                  type: string
                  enum:
                    - eth_getBlockTransactionCountByNumber
                  default: eth_getBlockTransactionCountByNumber
                  description: The RPC method name
                params:
                  type: array
                  description: 'Parameters: [blockNumber]'
                  default:
                    - '0x9d0c37'
                id:
                  type: integer
                  default: 1
                  description: Request identifier
            example:
              jsonrpc: '2.0'
              method: eth_getBlockTransactionCountByNumber
              params:
                - '0x9d0c37'
              id: 1
      responses:
        '200':
          description: Successful response with the transaction count
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: JSON-RPC version
                  id:
                    type: integer
                    description: Request identifier
                  result:
                    type: string
                    description: >-
                      The number of transactions in the block as a hexadecimal
                      string
              example:
                jsonrpc: '2.0'
                id: 1
                result: '0x3'

````