{"tool":"wallet","title":"Wallet Balance","what":"USDC and gas balance of any Solana or Base address, read from the chain: USDC amount, SOL or ETH for fees, whether the USDC account exists, and whether the wallet can pay a given x402 price. Lets an agent check its own funds or a counterparty before it pays.","endpoint":"https://yruz.one/api/wallet","methods":["GET with query parameters","POST with a JSON body (same fields)"],"price":{"model":"fixed","usdc":"0.002"},"params":[{"name":"address","required":true,"description":"Solana (base58) or Base (0x) address","example":"CWfaj5vDppWCp4q1X4iPYGWpCGY2Rerj9DQWqxTnz1Pp"},{"name":"amount","required":false,"description":"optional USDC price to test, e.g. 0.01","example":null}],"valid_request":{"get":"https://yruz.one/api/wallet?address=CWfaj5vDppWCp4q1X4iPYGWpCGY2Rerj9DQWqxTnz1Pp","post":{"url":"https://yruz.one/api/wallet","body":{"address":"CWfaj5vDppWCp4q1X4iPYGWpCGY2Rerj9DQWqxTnz1Pp"}}},"how_to_pay":["1. Send the request without payment: the answer is HTTP 402 with the exact price (x402 v2 in the PAYMENT-REQUIRED header, x402 v1 in the JSON body).","2. Sign one offer of \"accepts\" with an x402 client (USDC on Base eip155:8453 or on Solana mainnet; the facilitator pays the network fee).","3. Resend the identical request (same method, parameters and body) with PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1).","4. The answer carries the receipt in PAYMENT-RESPONSE. Any changed parameter needs a new 402."],"response_shape":{"product":"string","result":{"address":"string","chain":"string","checked_at":"string","network":"string","usdc":"string","usdc_atomic":"string","usdc_account":"string","usdc_account_exists":"boolean","gas_token":"string","gas_balance":"string","usdc_mint":"string","gas_needed_for_x402":"boolean","note":"string"},"payment":{"payment_id":"string","transaction":"string"}},"refusals":{"400":"invalid input: the message names the field and the expected format; nothing is charged","402":"payment required, or the payment was refused (reason in \"error\"); nothing is charged","403/404":"not your item, or the asked item does not exist; nothing is charged","409/422":"not allowed right now (state or destination safety); nothing is charged","503":"a source or the payment rail is unavailable; nothing is charged, retry after Retry-After"},"mcp":{"server":"https://yruz.one/mcp/x402","payment":"params._meta[\"x402/payment\"] = PaymentPayload"},"related":{"tools":[{"tool":"crypto-portfolio","url":"https://yruz.one/api/crypto/portfolio","why":"what this Solana wallet holds, in USD","usd":"0.005","how":"https://yruz.one/api/instructions?tool=crypto-portfolio"},{"tool":"crypto-tx","url":"https://yruz.one/api/crypto/tx","why":"explain a transaction of this wallet","usd":"0.003","how":"https://yruz.one/api/instructions?tool=crypto-tx"},{"tool":"crypto-fees","url":"https://yruz.one/api/crypto/fees","why":"current Solana and Base fees before you pay","usd":"0.002","how":"https://yruz.one/api/instructions?tool=crypto-fees"}],"more_x402_apis":{"402index":"https://402index.io","x402scan":"https://www.x402scan.com","agent402":"https://agent402.tools","x402_protocol":"https://www.x402.org"},"all_yruz_tools":"https://yruz.one/api/instructions"}}