> For the complete documentation index, see [llms.txt](https://docs.blinklabs.xyz/blink/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blinklabs.xyz/blink/ethereum/api-reference/eth_gettransactioncount.md).

# eth\_getTransactionCount

{% hint style="info" %}
This behavior is disabled by default and only enabled for allowlisted originators. If you would like it enabled for your custom endpoint, please let us know.
{% endhint %}

If `eth_getTransactionCount` is submitted with the `"pending"` param, Blink intercepts the call, looks up the most recent transaction it has accepted for that address within the last **3 hours** — or the last **96 seconds** if you use revert protection — and returns the greater of:

* the node's pending transaction count, and
* Blink's latest recorded nonce for that address **+ 1**

If Blink has no recent transaction for the address, or the node's pending count is higher, the node response is returned unchanged.

Only transactions Blink accepted for submission are counted. A transaction we declined does not raise the nonce, so you are never handed a nonce that skips one we never forwarded.

The shorter window for revert protection is deliberate: those submissions are dropped after 96 seconds, so past that point the nonce is free again and bumping past it would hand you a gap.

All calls with a block tag other than `"pending"` (for example `"latest"` or `"earliest"`) will return responses directly from our Ethereum nodes.

### Example request

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_getTransactionCount",
  "params": [
    "0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97",
    "pending"
  ]
}
```

### Example response

```
{
   "id" : 1,
   "jsonrpc" : "2.0",
   "result" : "0x31"
}
```
