Skip to main content
POST
eth_getTransactionCount
BNB API method that returns the number of transactions sent from an address at the selected block. This value is also called nonce; it is an important piece of information, especially to ensure that a transaction is not sent twice.
When called against a block older than the latest ~128 blocks, this method is treated as an archive request (2 RUs instead of 1 RU). See request units.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

  • address— the address to retrieve the transaction count.
  • quantity or tag — the integer of a block encoded as hexadecimal or the string with:
    • latest — the most recent block in the blockchain and the current state of the blockchain at the most recent block. A chain reorganization is to be expected.
    • safe — the latest justified block. Under BSC fast finality, a block becomes justified when more than two-thirds of the validators vote for it and its direct child carries their attestation in its header, so safe usually trails latest by a block or two.
    • finalized — the latest finalized block: a justified block whose direct child is also justified. Two conflicting blocks can both reach finality only if one-third or more of the validators violate the voting rules.
    • earliest — the earliest available or genesis block.
    • pending — the pending state and transactions block. The current state of transactions that have been broadcast to the network but have not yet been included in a block.

Response

  • quantity — an integer value identifying the number of transactions sent from an address at the specified block.

eth_getTransactionCount code examples

Use case

One of the most common use cases for eth_getTransactionCountis to create the transaction object built in a script designed to send a transaction. The nonce field is required, and it is retrieved using the eth_getTransactionCount method.

Body

application/json
id
integer
default:1
jsonrpc
string
default:2.0
method
string
default:eth_getTransactionCount
params
string[]

The address to check

Response

200 - application/json

The address nonce

jsonrpc
string
id
integer
result
object
Last modified on November 13, 2026