eth_getTransactionCount

Every outbound transaction on BNB Smart Chain must carry a strictly increasing nonce, and eth_getTransactionCount reports that nonce: the number of transactions an address has sent as of the block you specify. On a network that spends BNB for gas and finalizes blocks in roughly three seconds, getting the nonce right is what keeps your sends from colliding or stalling. Query https://bsc.therpc.io/YOUR_API_KEY on chain ID 56 with an address and a block tag, and the method hands back the count as a hex integer. That is typically the value you assign to the very next transaction you sign.

Use cases

• Fetch the nonce that your next freshly built BSC transaction should carry before signing and broadcasting it.
• Notice transactions wedged in the mempool by comparing the latest count against the pending count for one address.
• Fire several transactions in a row by pre-assigning consecutive nonces instead of waiting for each to confirm.
• Chart an account's activity across time by reading its nonce at a series of historical chain-56 blocks.

Parameters

Response

Example request

1curl https://bsc.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "eth_getTransactionCount",
7    "params": [
8        "0x8894E0a0c962CB723c1976a4421c95949bE2D4E3",
9        "latest"
10      ],
11    "id": 1
12  }'

Try it live in the BNB Smart Chain playground.

Errors & troubleshooting

Common pitfalls

• For rapid back-to-back sends, request the pending tag. The latest tag keeps returning the same number until each transaction confirms, so you would reuse a nonce.
• Leave a gap (submit nonce N+1 while N is still unmined) and every later transaction parks in the queue until the missing one arrives or is replaced.
• A contract account's nonce ticks up only when it deploys another contract via CREATE, not on ordinary calls into or out of it.

Supported networks

• Mainnet — Chain ID: 56
• Testnet — Chain ID: 97

See also

• eth_sendRawTransaction
• eth_getTransactionByHash
• eth_getBalance

1curl https://bsc.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getTransactionCount","params":["0x8894E0a0c962CB723c1976a4421c95949bE2D4E3",""]}'