# Xerxes Ethereum Transaction Count (eth_getTransactionCount)

> Xerxes Ethereum Transaction Count (eth_getTransactionCount) is a paid API for AI agents from ari001.tailb4ac3a.ts.net, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-19).

Returns the number of transactions sent from an Ethereum address (nonce) via eth_getTransactionCount, essential for building and signing new transactions.

## Facts

- Endpoint: GET https://ari001.tailb4ac3a.ts.net/v1/ventures/ethereum_contract_abi_service/eth_gettransactioncount?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xerxes-ethereum-transaction-count-eth-gettransactioncount-e476507d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_M3pVZ_uyLNohjqCiFpXN1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability xerxes-ethereum-transaction-count-eth-gettransactioncount-e476507d
```

Example prompt: What's the current nonce (transaction count) for Ethereum address 0xAbCd1234567890abcdef1234567890abcdef1234? I need it to build and sign my next transaction.

## When to prefer this

Use this endpoint when you need the current nonce of an Ethereum address before constructing, signing, or submitting a new transaction. It is the canonical source for eth_getTransactionCount on Ethereum via this provider and is preferable when you already use Xerxes for other Ethereum RPC calls and want consistency. Not suitable for Base network nonce lookups (use sibling Base endpoints) or for ERC-20 transfer counts.

## Known failure modes

- Invalid address format (not 0x + 40 hex) returns an error response with ok: false
- Address not found or never used on chain returns count of 0 (not an error)
- Network or RPC node unavailability causes service errors
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Returns the number of transactions sent from an address (nonce) via eth_getTransactionCount. This is essential for building and signing new transactions. Query: address (0x + 40 hex).

## Output

Returns a JSON object containing: 'ok' boolean indicating success, 'result' integer with the total number of transactions sent from the address (the nonce), 'hex' string with the hex-encoded count, 'chain' string identifying the network, 'method' string echoing the RPC method used, and 'service' string. On failure, 'ok' is false and 'error' describes the problem.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[a-fA-F0-9]{40}$",
       "description": "0x + 40 hex"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "ok",
      "service"
     ],
     "properties": {
      "ok": {
       "type": "boolean"
      },
      "hex": {
       "type": [
        "string",
        "null"
       ]
      },
      "chain": {
       "type": "string"
      },
      "error": {
       "type": "string",
       "description": "present when ok is false"
      },
      "method": {
       "type": "string"
      },
      "result": {
       "type": "integer"
      },
      "service": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/xerxes-ethereum-transaction-count-eth-gettransactioncount-e476507d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ari001.tailb4ac3a.ts.net](https://www.zero.xyz/host/ari001.tailb4ac3a.ts.net/llms.txt)
