EVM

Archive

eth_getTransactionCount

Summary: Get transaction count

This request returns a count of transactions sent from a given address up to and including the provided block.

Parameters

address string

required

A string identifier for the contract or EOA address (20 bytes).

Pattern: ^0x[0-9a-fA-F]{40}$

---

block anyOf

required

Block number, block hash, or string tag.

Block number string

Block number in hexadecimal.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

Block tag enum

See the default block parameter.

• earliest: The lowest numbered block the client has available.
• finalized: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination.
• latest: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions.
• pending: A sample next block built by the client on top of latest and containing the set of transactions usually taken from local mempool.

Enum:

"earliest"

"finalized"

"latest"

"pending"

Block hash string

32 byte hex value.

Pattern: ^0x[0-9a-f]{64}$

Returns

The number of transactions sent from the specified address up to and including the specified block, in hexadecimal.

eth_getTransactionCountResponse string

The number of transactions sent from the specified address up to and including the specified block, in hexadecimal.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

Customize request

Parameter

Value

address

string

block

0x4fb66d

anyOf

• Block number
• Block tag
• Block hash

Request

curl https://linea-mainnet.infura.io/v3/<YOUR-API-KEY> \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionCount",
    "params": ["0x188e0B45cedd8f5e425e73c8aa7953b92115ec24","0x4fb66d"],
    "id": 1
  }'

Example response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x52"
}