eth_getTransactionCount - Base

Example code for the eth_getTransactionCount JSON-RPC method. Complete guide on how to use eth_getTransactionCount JSON-RPC in GetBlock Web3 documentation.

The eth_getTransactionCount method returns the number of transactions sent from an address, also known as the nonce. This value is essential for constructing new transactions as each transaction must have a unique, sequential nonce.

Parameters

Parameter	Type	Required	Description
address	string	Yes	20-byte address to check
blockParameter	string	Yes	Block number in hex, or "latest", "earliest", "pending"

Request

cURl

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionCount",
    "params": ["0x742d35Cc6634C0532925a3b844Bc9e7595f5bE21", "latest"],
    "id": "getblock.io"
}'

Axios

Request

Rust

Response

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": "0x1a"
}

Response Parameters

Parameter	Type	Description
jsonrpc	string	JSON-RPC protocol version ("2.0")
id	string	Request identifier matching the request
result	string	Transaction count (nonce) in hex

Use Cases

1

Transaction Nonce

Get nonce for signing new transactions.

2

Pending Detection

Compare "latest" vs "pending" to detect pending transactions.

3

Account Activity

Measure account transaction activity.

4

Replay Prevention

Ensure unique nonce for each transaction.

5

Transaction Management

Track outgoing transaction sequence.

Error Handling

Error Code	Message	Description
-32602	Invalid params	Invalid address format or block parameter
-32603	Internal error	Node internal failure

Web3 Integration

Ethers.js

const { ethers } = require('ethers');

const provider = new ethers.JsonRpcProvider('https://go.getblock.io/<ACCESS-TOKEN>/');

async function getNonce(address) {
    // Get confirmed nonce
    const nonce = await provider.getTransactionCount(address);
    console.log('Confirmed Nonce:', nonce);
    
    // Get pending nonce (includes pending transactions)
    const pendingNonce = await provider.getTransactionCount(address, 'pending');
    console.log('Pending Nonce:', pendingNonce);
    
    // Check for pending transactions
    if (pendingNonce > nonce) {
        console.log('Pending Transactions:', pendingNonce - nonce);
    }
    
    return { nonce, pendingNonce };
}

// Build transaction with correct nonce
async function buildTransaction(wallet, to, value) {
    const nonce = await provider.getTransactionCount(wallet.address, 'pending');
    
    const tx = {
        to: to,
        value: ethers.parseEther(value),
        nonce: nonce,
        gasLimit: 21000n,
        maxFeePerGas: ethers.parseUnits('0.1', 'gwei'),
        maxPriorityFeePerGas: ethers.parseUnits('0.001', 'gwei'),
        chainId: 8453n
    };
    
    return tx;
}

getNonce('0x742d35Cc6634C0532925a3b844Bc9e7595f5bE21');

Viem