{"uid":"cap_kiq4hXzSH1WopnBY-Hsgu","slug":"1gateway-solana-wallet-balance-lookup-0a8147eb","name":"1gateway Solana Wallet Balance Lookup","description":"Use when an agent needs what a Solana address holds in one call. Input: address. Output: JSON slot, SOL balance, every non-zero token (mint, token account, program, decimals, raw and decimal balance, frozen flag; first 50), counts of token and empty accounts. Chain state only, no prices. Bad input: 400, not charged. Example: ?address=CV8t6fnSsckB3bzJSVRxQjVvTgdB35q11Fu3eaF1nz8u","url":"https://1gateway.dev/v1/onchain/solana/balances?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","examples":["CV8t6fnSsckB3bzJSVRxQjVvTgdB35q11Fu3eaF1nz8u"],"description":"Wallet address on Solana mainnet (base58, 32 bytes). Bad input → 400 (not charged)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["chain","cluster","address","slot","sol","tokenAccounts","nonZeroTokens","emptyTokenAccounts","tokens","truncated","notes","rpc"],"properties":{"rpc":{"type":"object","properties":{"servedBy":{"type":"string"}}},"sol":{"type":"object","properties":{"balance":{"type":"string"},"lamports":{"type":"string"}}},"slot":{"type":"integer"},"chain":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}},"tokens":{"type":"array","items":{"type":"object","properties":{"raw":{"type":"string"},"mint":{"type":"string"},"frozen":{"type":"boolean"},"symbol":{"type":["string","null"]},"balance":{"type":"string"},"program":{"type":"string"},"decimals":{"type":"integer"},"tokenAccount":{"type":"string"}}}},"address":{"type":"string"},"cluster":{"type":"string"},"truncated":{"type":"boolean"},"nonZeroTokens":{"type":"integer"},"tokenAccounts":{"type":"integer"},"emptyTokenAccounts":{"type":"integer"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ln_Z8S7Za6mv1YlbuhxDp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the SOL balance and all non-zero SPL token holdings for a given Solana mainnet wallet address in a single call","exampleAgentPrompt":"What's the SOL balance and full list of SPL tokens held by the Solana wallet CV8t6fnSsckB3bzJSVRxQjVvTgdB35q11Fu3eaF1nz8u right now?","exampleUseCases":[{"title":"Portfolio snapshot for a trader","prompt":"Can you pull up everything held in this Solana wallet — CV8t6fnSsckB3bzJSVRxQjVvTgdB35q11Fu3eaF1nz8u — I want to see the SOL balance and every token it holds with their amounts."},{"title":"Verify wallet before airdrop","prompt":"Before we send the airdrop, check what tokens and SOL are already in the wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM so we can confirm it's active and not empty."},{"title":"DeFi protocol eligibility check","prompt":"Look up the on-chain balances for wallet 5FHwkrdxFnpVFkHRNBSRVaEXuKg7eAnJQMqHVWRzExK3 — specifically the token accounts and any non-zero holdings — so we can see if it qualifies for our liquidity program."}],"resultDescription":"A JSON object containing: the current Solana slot, the wallet's SOL balance in both decimal and raw lamports, an array of up to 50 non-zero SPL token entries each with mint address, associated token account, program, decimals, raw and decimal balance, and frozen status; plus counts of total token accounts, non-zero token accounts, empty token accounts, a truncated flag, and the RPC node that served the request.","failureModes":["400 Bad Request if the address is not a valid base58-encoded 32-byte public key (not charged)","Empty token array if the wallet exists but holds no SPL tokens","Slot lag if the RPC node is slightly behind mainnet tip","Truncated flag set to true if the wallet holds more than 50 non-zero tokens (only first 50 returned)","Address not found on-chain returns zero balances (not an error)"],"whenToPreferThis":"Use this endpoint when you need a complete, single-call snapshot of a Solana wallet's on-chain state — SOL plus all token balances — without wanting to parse raw RPC responses yourself. It is ideal for portfolio display, eligibility checks, or pre-transaction audits. It does not return prices, so pair it with a price feed if USD valuation is needed. Prefer it over raw Solana RPC calls when you want a normalized, structured response at a fixed $0.002/call cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:47:36.847Z","isFirstParty":false,"canonicalSlug":"1gateway-solana-wallet-balance-lookup-0a8147eb"}