{"uid":"cap_-oTzl0Q436Ip5ff43TOdE","slug":"base-wallet-preflight-oracle-f8dab77c","name":"Base Wallet Preflight Oracle","description":"x402-paid Solana mainnet wallet preflight oracle for agents.","url":"https://home.chrz.dev/agent-dust/v1/agent/base-preflight","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["address"],"properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["address","chain_id","eth_balance","usdc_balance","can_transact_now"],"properties":{"nonce":{"type":"integer"},"address":{"type":"string"},"chain_id":{"type":"integer"},"dust_hint":{"type":"string"},"eth_balance":{"type":"number"},"usdc_balance":{"type":"number"},"gas_price_gwei":{"type":"number"},"can_transact_now":{"type":"boolean"}}}}}}},"responseSchema":{"type":"json","example":{"nonce":0,"address":"0xE145b40A782E6eC778b2Ae9aC396ae5C0d6a311d","chain_id":8453,"dust_hint":"needs a small ETH top-up on Base before agents should bother","eth_balance":0,"usdc_balance":0,"gas_price_gwei":0,"can_transact_now":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NWgFMoOxRJOWPWWx9P3Wd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks a Base mainnet wallet's ETH and USDC balances, current gas price, and transactability before an agent attempts an on-chain action","exampleAgentPrompt":"Before you try to send that transaction, can you run a preflight check on my Base wallet 0xE145b40A782E6eC778b2Ae9aC396ae5C0d6a311d to see if it has enough ETH for gas and whether it can actually transact right now?","exampleUseCases":[{"title":"Pre-transaction wallet readiness check","prompt":"Check if my Base wallet 0xE145b40A782E6eC778b2Ae9aC396ae5C0d6a311d is ready to send a transaction — does it have enough ETH for gas fees and what's the current gas price?"},{"title":"Agent loop gas guard","prompt":"Before my trading agent submits any trades today, verify that the wallet at 0xE145b40A782E6eC778b2Ae9aC396ae5C0d6a311d has enough ETH to cover gas on Base mainnet and tell me if anything needs topping up."},{"title":"Debugging a stuck agent wallet","prompt":"My agent wallet on Base seems stuck and isn't sending transactions — can you do a preflight check on 0xE145b40A782E6eC778b2Ae9aC396ae5C0d6a311d and tell me what's wrong, like if it needs more ETH dust?"}],"resultDescription":"Returns a JSON object with the wallet's current nonce, ETH balance, USDC balance, gas price in gwei, a boolean can_transact_now flag, and a human-readable dust_hint string explaining any issues preventing the wallet from transacting on Base mainnet (chain ID 8453).","failureModes":["Invalid or malformed wallet address returns an error","Network congestion may cause stale gas price readings","Payment of $0.01 USDC via x402 required; missing or invalid payment returns 402","Wallet address not on Base mainnet may return unexpected results","Service unavailability returns 5xx error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to verify a Base mainnet wallet is funded and ready before attempting any on-chain transaction — particularly useful as a guard step in agentic loops to avoid wasted gas or failed transactions. Prefer this over raw RPC calls when you want a single opinionated summary (can_transact_now + dust_hint) rather than raw blockchain data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:31:20.569Z","isFirstParty":false}