{"uid":"cap_DP93F3oCr-cxtMZAQQbnS","slug":"solana-wallet-preflight-oracle-2e6930e2","name":"Solana Wallet Preflight Oracle","description":"x402-paid Solana mainnet wallet preflight oracle for agents.","url":"https://home.chrz.dev/agent-dust/v1/agent/wallet-report","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"}}},"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","can_transact_now","recommended_action"],"properties":{"chain":{"type":"string"},"address":{"type":"string"},"details":{"type":"object"},"can_transact_now":{"type":"boolean"},"recommended_action":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"chain":"solana","address":"3mVCM1cokCNGkhTSWZtu4PjqSSx7VqpJyS74bY91wDgk","details":{"sol_balance":0,"usdc_balance":0},"can_transact_now":false,"recommended_action":"top_up_sol"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Kj5RizRI3wl9vqlbnLiRr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks a Solana mainnet wallet's SOL and USDC balances and returns a readiness assessment indicating whether the agent can transact now and what action to take next.","exampleAgentPrompt":"Can you run a preflight check on my Solana mainnet wallet 3mVCM1cokCNGkhTSWZtu4PjqSSx7VqpJyS74bY91wDgk and tell me if it has enough SOL and USDC to transact right now, and what I should do if it doesn't?","exampleUseCases":[{"title":"Pre-payment wallet readiness check","prompt":"Before my agent tries to pay for the next API call, check if wallet 3mVCM1cokCNGkhTSWZtu4PjqSSx7VqpJyS74bY91wDgk on Solana mainnet is ready to transact and what action I should take if it isn't."},{"title":"Agent treasury monitoring before task run","prompt":"I'm about to kick off an autonomous task that requires on-chain payments — can you first check if my Solana wallet 3mVCM1cokCNGkhTSWZtu4PjqSSx7VqpJyS74bY91wDgk has enough SOL and USDC and tell me if I need to top it up?"},{"title":"Diagnose failed agent transaction funding","prompt":"My agent failed to complete a payment — can you check wallet 3mVCM1cokCNGkhTSWZtu4PjqSSx7VqpJyS74bY91wDgk on Solana mainnet and tell me what the current SOL and USDC balances are and what's recommended to fix it?"}],"resultDescription":"Returns a JSON object containing the Solana wallet address, chain identifier, current SOL balance, current USDC balance, a boolean indicating whether the wallet can transact immediately, and a recommended action string (e.g. 'top_up_sol') guiding the agent on what to do next.","failureModes":["Invalid or malformed Solana wallet address returns an error","Network timeout querying Solana mainnet RPC","Wallet address not found on mainnet returns zero balances","Payment of 0.1 USDC via x402 protocol fails due to insufficient funds in calling wallet","Rate limiting if called too frequently"],"whenToPreferThis":"Use this endpoint when an AI agent needs to verify its Solana wallet is funded and ready before attempting an on-chain payment or x402-paid API call. It is ideal as a preflight step in agentic payment workflows to avoid failed transactions due to insufficient SOL for fees or USDC for payments. Prefer this over general blockchain explorers when you need a structured, action-oriented readiness signal rather than raw chain data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:31:36.442Z","isFirstParty":false}