Skip to main content
Returns the number of transactions sent from an address — also known as the account nonce. Use the pending block parameter to include transactions that are in the mempool but not yet mined.

​
Parameters

​
address
string
required
The 20-byte account address.
​
blockParameter
string
required
Block number in hexadecimal, or a block tag: latest, earliest, pending, safe, or finalized.

​
Returns

​
result
string
The number of transactions sent from the address as a hexadecimal integer.

​
Flashblocks Behavior

On a Flashblocks-aware endpoint, use "pending" as the block parameter to query preconfirmed state — data available up to 200ms before the next full block is sealed. Returns the account nonce including transactions preconfirmed in Flashblocks but not yet in a sealed block. Always use "pending" when building sequential transactions to avoid nonce gaps. 
curl https://mainnet-preconf.base.org \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0xd3CdA913deB6f4967b2Ef66ae97DE114a83bcc01","pending"],"id":1}'

​
Example

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