{"uid":"cap_USxcsADXT4cr6GFea_gqc","slug":"agents-x402stock-xyz-solana-account-balance-state-lookup-48128d6c","name":"Solana Account Balance & State Lookup","description":"The native SOL balance and basic account state for any Solana address, read from the public ledger: lamports and SOL, whether the account exists, its owning program, executable flag, and data size. Pass a base58 address in the path. Keyless on-chain data — no Jupiter API, no account. From x402stock, a pay-per-call market & economic data API. Pay per request in USDC via x402, no API key.","url":"https://agents.x402stock.xyz/api/v1/solana/balance/{address}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Solana account address (base58)."}}},"responseSchema":{"type":"object","required":["source","as_of","venue","data"],"properties":{"data":{"type":"object","required":["address","lamports","sol","exists","owner","executable","data_size"],"properties":{"sol":{"type":"number"},"owner":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Owning program of the account, if it exists."},"exists":{"type":"boolean","description":"False for an address the ledger has never seen."},"address":{"type":"string"},"lamports":{"type":"number"},"data_size":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Account data size in bytes."},"executable":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false},"as_of":{"type":"string"},"venue":{"type":"string","const":"solana"},"source":{"type":"string","const":"x402stock"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.01","displayCostAsset":"USD","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":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_meG1GvyNtXC4o-icR2Hpi","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns the native SOL balance (in lamports and SOL), account existence, owning program, executable flag, and data size for any Solana address read directly from the public ledger.","exampleAgentPrompt":"What's the current SOL balance and account state for the Solana address 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU? Tell me the lamports, SOL, whether it exists, and who owns the account.","exampleUseCases":[{"title":"Wallet balance check before transfer","prompt":"Before I send SOL, can you check the current balance and confirm the account exists for the Solana address 4fYNw3dojWmQ4dXtSGE9epjRGy9GHtrsuozEVSkiw9dr?"},{"title":"Verify smart contract program account","prompt":"Is the Solana address TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA actually an executable program on-chain, and what program owns it?"},{"title":"Monitor treasury wallet SOL holdings","prompt":"Check how much SOL is in our treasury wallet at 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM and tell me the exact lamport count too."}],"resultDescription":"A JSON object containing the queried Solana address, its balance in both lamports and SOL, a boolean indicating whether the account exists on the ledger, the owning program address (or null), whether the account is executable, the account data size in bytes, plus metadata fields for source, venue (solana), and timestamp (as_of).","failureModes":["Invalid base58 address format returns an error response","Account that has never received SOL returns exists: false with zero lamports","Network or RPC timeout may cause delayed or failed responses","Malformed path parameter (non-base58 characters) may return a 400 error","Extremely new accounts may not yet be reflected if there is slight ledger read latency"],"whenToPreferThis":"Choose this endpoint when you need raw on-chain Solana account state — balance in lamports/SOL, account existence, owning program, or executable flag — directly from the public ledger without needing a Jupiter API key or any account setup. Prefer it over DEX-aggregator APIs when you just need native SOL balance or program ownership data rather than token swap quotes or token metadata. Pay-per-call pricing via USDC/x402 makes it ideal for agents that query infrequently or on-demand without subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T06:45:52.697Z","isFirstParty":false}