eth_getTransactionCount

eth_getTransactionCount returns how many transactions an address has sent on Polygon PoS (chain ID 137) — its nonce — at a chosen block. Because Polygon uses the same Ethereum account model with MATIC as the gas token, the nonce is what you must set on every outgoing transaction so it lands in order, which matters when Polygon's ~2-second blocks let you fire many sends in quick succession. Query https://polygon.therpc.io/YOUR_API_KEY with an address and a block tag and you get the hex-encoded count of confirmed transactions from that account as of that block.

Use cases

• Get the next nonce to assign when building and signing a new Polygon transaction.
• Detect stuck transactions by comparing the latest nonce with the pending nonce — a gap means sends are queued but not yet mined.
• Batch many sends back-to-back by pre-computing nonces from the pending value and incrementing locally.
• Analyse an account's historical activity by querying its nonce at past Polygon block heights (archive node required for old blocks).

Parameters

Response

Example request

1curl https://polygon.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        "0x0000000000000000000000000000000000000000",
9        "latest"
10      ],
11    "id": 1
12  }'

Try it live in the Polygon playground.

Errors & troubleshooting

Common pitfalls

• Use the pending tag when firing several Polygon transactions in a row; latest would hand back the same nonce for all of them and they would collide.
• A nonce gap — submitting N+1 before N is mined — leaves the later transactions queued in the Bor mempool indefinitely until the missing nonce fills in.
• For contract accounts the nonce counts contract creations: it increments on each CREATE/CREATE2, not on ordinary calls to the contract.

Supported networks

• Mainnet — Chain ID: 137
• Amoy — Chain ID: 80002

See also

• eth_sendRawTransaction
• eth_getTransactionByHash
• eth_getBalance

1curl https://polygon.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":["0x0000000000000000000000000000000000000000",""]}'