{"uid":"cap_M3pVZ_uyLNohjqCiFpXN1","slug":"xerxes-ethereum-transaction-count-eth-gettransactioncount-e476507d","name":"Xerxes Ethereum Transaction Count (eth_getTransactionCount)","description":"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).","url":"https://ari001.tailb4ac3a.ts.net/v1/ventures/ethereum_contract_abi_service/eth_gettransactioncount?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ybYo1tAzOKX-wFbNMkrA_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the number of transactions sent from an Ethereum address (nonce) via eth_getTransactionCount, essential for building and signing new transactions.","exampleAgentPrompt":"What's the current nonce (transaction count) for Ethereum address 0xAbCd1234567890abcdef1234567890abcdef1234? I need it to build and sign my next transaction.","exampleUseCases":[{"title":"Build and sign next Ethereum transaction","prompt":"I'm about to send a new Ethereum transaction from 0xAbCd1234567890abcdef1234567890abcdef1234 — can you get the current nonce for that address so I can set the right sequence number?"},{"title":"Detect Ethereum account activity","prompt":"Has anything ever been sent from Ethereum address 0xDead000000000000000000000000000000000001? Check its transaction count to see if it's ever been used."},{"title":"Verify nonce before transaction replay protection","prompt":"Before I submit my transaction, confirm the transaction count for 0x1111111111111111111111111111111111111111 on Ethereum so I can make sure I'm using the correct nonce and avoid replay issues."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T18:36:39.749Z","isFirstParty":false,"canonicalSlug":"xerxes-ethereum-transaction-count-eth-gettransactioncount-230f89de"}