{"uid":"cap_oEePVGPnNTM3PRhll_zER","slug":"shelf-thirdmade-net-transaction-nonce-lookup-afe0de6a","name":"shelf.thirdmade.net Transaction Nonce Lookup","description":"Current transaction nonce for any address on Base or Ethereum. Agent tx bots need this before sending transactions.","url":"https://shelf.thirdmade.net/probe/nonce","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"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","description":"base (default) or ethereum"},"address":{"type":"string","description":"EVM address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_axr0UqTaavFKAt2So2wF_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current transaction nonce for any EVM address on Base or Ethereum, enabling agents to construct valid transactions.","exampleAgentPrompt":"What's the current transaction nonce for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base so I can build my next transaction?","exampleUseCases":[{"title":"Bot preflight nonce check","prompt":"Before sending this ETH transfer on Base, grab the current nonce for 0xAbCd1234...5678 so the transaction doesn't get rejected."},{"title":"Ethereum wallet nonce audit","prompt":"Check the current nonce for 0x742d35Cc6634C0532925a3b8D4C9C3E1a2b3c4d5 on Ethereum — I need to know how many transactions this address has sent."},{"title":"Stuck transaction debugging","prompt":"I think I have a stuck pending transaction — can you get me the on-chain nonce for 0xDe0B295669a9FD93d5F28D9Ec85E40f4cb697BAe on Ethereum so I can figure out which nonce to rebroadcast with?"}],"resultDescription":"Returns the current transaction nonce (integer) for the queried EVM address on the specified chain (Base or Ethereum). The nonce represents the number of confirmed transactions sent from that address, and is the value an agent must include when constructing the next outgoing transaction.","failureModes":["Invalid or malformed EVM address returns an error response","Unsupported chain value returns an error (only 'base' and 'ethereum' are accepted)","Address not yet on-chain (zero transactions) returns nonce of 0, which is valid","Network or RPC unavailability may cause timeouts or 5xx errors","Payment not included or insufficient causes 402 Payment Required"],"whenToPreferThis":"Use this endpoint when an AI agent or transaction bot needs to programmatically retrieve the correct nonce before constructing or signing an EVM transaction on Base or Ethereum. Prefer this over manual RPC calls when operating in an agentic context with x402 micropayment support already in place. It complements the sibling block-height endpoint for full transaction preparation context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:20.463Z","isFirstParty":false}