Ethereum · eth

eth_getTransactionCount

Returns the nonce of an account in the state. NOTE: The name eth_getTransactionCount reflects the historical fact that an account's nonce and sent transaction count were the same. After the Pectra fork, with the inclusion of EIP-7702, this is no longer true.

Parameters

Address required

Schema

{
  "type": "string",
  "title": "hex encoded address",
  "pattern": "^0x[0-9a-fA-F]{40}$"
}

Block

default: 'latest'

Schema

{
  "title": "Block number, tag, or block hash",
  "anyOf": [
    {
      "type": "string",
      "title": "Block number",
      "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
    },
    {
      "type": "string",
      "title": "Block tag",
      "description": "`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; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `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. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error",
      "enum": [
        "earliest",
        "finalized",
        "safe",
        "latest",
        "pending"
      ]
    },
    {
      "type": "string",
      "title": "Block hash",
      "pattern": "^0x[0-9a-f]{64}$"
    }
  ]
}

Result

Account nonce

Schema

{
  "type": "string",
  "title": "hex encoded unsigned integer",
  "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
}

Example request

Endpoint: https://your-eth-node.azxa.io

JSON-RPC

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

Example response

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

Test fixture

Fixture: get-nonce-default-block

Request

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

Response

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

cURL

curl -X POST https://your-eth-node.azxa.io \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getTransactionCount","params":["0xc94770007dda54cF92009BFF0dE90c06F603a09f","latest"]}'