{"uid":"cap_lJXHPQqMoL5FVuwHJu7-Q","slug":"solana-spl-token-account-balance-9467b7a0","name":"Solana SPL Token Account Balance","description":"Balance of one specific SPL token account — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/solana-token-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"address":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"solana-token-balance","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.003,"receipt_id":"g402-<16hex>"},"generated_at":"<iso8601>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vahPpOzpH1W9uFKYAXgpm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the current token balance for a specific SPL token account address on Solana","exampleAgentPrompt":"What's the current SPL token balance for the Solana token account address 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU?","exampleUseCases":[{"title":"DeFi portfolio token balance check","prompt":"Can you check the current token balance for this Solana SPL token account: Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB? I need to know how many tokens are sitting there."},{"title":"Airdrop eligibility verification","prompt":"I need to verify whether this SPL token account address 4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R actually holds any tokens before we proceed with the airdrop."},{"title":"Automated treasury monitoring","prompt":"What's the token balance right now for our treasury SPL token account at 3yFwqXBfZY4jBVyzqf3xpBRV5QeUyRLqJAGsQgVmLMge? I want to make sure it's above our minimum threshold."}],"resultDescription":"Returns a JSON object with ok status, the balance type identifier ('solana-token-balance'), and a payment receipt containing tx_hash, amount_usd paid, and a receipt_id, along with the timestamp when the balance was fetched. The actual token balance value is returned within this structure.","failureModes":["Invalid base58 address format — returns error if address doesn't match the 32-44 character base58 pattern","Account not found — if the address doesn't correspond to an existing SPL token account","Network or RPC issues querying the Solana blockchain","Payment failure — x402 payment of $0.003 USDC not fulfilled before response is served"],"whenToPreferThis":"Use this endpoint when you need the current balance of a specific SPL token account on Solana and are comfortable with a pay-per-call model ($0.003 USDC via x402). Prefer this over free RPC calls when you want a managed, receipted service with provenance tracking. Best for agents or automation pipelines that need verified, auditable balance lookups on Solana token accounts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:55:49.323Z","isFirstParty":false,"canonicalSlug":"solana-spl-token-account-balance-9467b7a0"}