eth_getTransactionCount

Returns the number of transactions sent from an address on Optimism (the nonce).

Use Cases

• Transaction building - Get correct nonce for new transactions
• Account analysis - Count total outgoing transactions
• Nonce management - Handle pending transaction queues
• Wallet operations - Prepare transactions for cross-chain DeFi, Superchain-interoperable dApps, and public goods funding recipients

Parameters

Parameter	Type	Required	Description
address	DATA	Yes	20-byte address
blockParameter	QUANTITY|TAG	Yes	Block number or tag (pending for next nonce)

Request

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionCount",
  "params": [
    "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "latest"
  ],
  "id": 1
}

Code Examples

cURL

curl -X POST https://api-optimism-mainnet-archive.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionCount",
    "params": [
      "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "latest"
    ],
    "id": 1
  }'

JavaScript

import { JsonRpcProvider } from 'ethers';

const provider = new JsonRpcProvider('https://api-optimism-mainnet-archive.n.dwellir.com/YOUR_API_KEY');

const address = '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045';
const nonce = await provider.getTransactionCount(address);
console.log('Nonce:', nonce);

// Get pending nonce for new transaction
const pendingNonce = await provider.getTransactionCount(address, 'pending');
console.log('Next nonce:', pendingNonce);

Python

from web3 import Web3

w3 = Web3(Web3.HTTPProvider('https://api-optimism-mainnet-archive.n.dwellir.com/YOUR_API_KEY'))

address = '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
nonce = w3.eth.get_transaction_count(address)
print(f'Nonce: {nonce}')

# Get pending nonce
pending_nonce = w3.eth.get_transaction_count(address, 'pending')
print(f'Next nonce: {pending_nonce}')

Related Methods

• eth_getBalance - Get account balance
• eth_sendRawTransaction - Send transaction