Back to Browse
Solana Wallet Preflight Oracle
x402
Solana Wallet Preflight Oracle is a paid API for AI agents from home.chrz.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).
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.
Price / call$0.1
Success—
StatusUnknown
How this service works
x402-paid Solana mainnet wallet preflight oracle for agents.
Output
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.
Example use cases
Pre-payment wallet readiness check
“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.”
Agent treasury monitoring before task run
“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?”
Diagnose failed agent transaction funding
“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?”
Technical details
Endpoint
POSThttps://home.chrz.dev/agent-dust/v1/agent/wallet-reportWhen to prefer
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.
Side effects
- 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
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| outputrequired | object |
Output
Schema · Response
{
"type": "json",
"example": {
"chain": "solana",
"address": "3mVCM1cokCNGkhTSWZtu4PjqSSx7VqpJyS74bY91wDgk",
"details": {
"sol_balance": 0,
"usdc_balance": 0
},
"can_transact_now": false,
"recommended_action": "top_up_sol"
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"