{"uid":"cap_gLW3QQQ_Zw36Y8UzGny0B","slug":"salt19-agent-utility-grid-base-token-balance-lookup-6c5481f6","name":"SALT19 Agent Utility Grid – Base Token Balance Lookup","description":"SALT19 is an independent applied AI systems lab behind EvoMind governed cognition, the MCP-native Agent Utility Grid, the ARCS research community, AeroClear UAS flight intelligence, and practical software for real-world work.","url":"https://api.salt19.com/v1/base-token-balance","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"owner":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"token_address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}},"responseSchema":{"type":"json","example":{"symbol":"USDC","decimals":6,"block_number":12345678,"balance_atomic":"0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_P1wqReGc2eY48kgw4XZsI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the on-chain ERC-20 token balance for a given wallet address and token contract at the latest block.","exampleAgentPrompt":"What's the current on-chain USDC balance for wallet 0xAbC123...4567, using token contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?","exampleUseCases":[{"title":"Pre-flight agent treasury check","prompt":"Before the agent runs its next task, check how much USDC is sitting in wallet 0xAbC123...4567 using the USDC contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 so I know if there are enough funds."},{"title":"DeFi eligibility verification","prompt":"Tell me whether wallet 0xDEF456...7890 holds any of the governance token at contract 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 — I need the raw atomic balance and how many decimals it uses."},{"title":"Multi-wallet portfolio snapshot","prompt":"Pull the on-chain token balance for wallet 0x111222...AAAB for the WETH contract at 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 and tell me the symbol, decimals, and balance as of the latest block."}],"resultDescription":"Returns a JSON object with the token symbol (e.g. 'USDC'), decimal precision (e.g. 6), the block number at which the balance was read, and the balance in atomic (smallest) units as a string (e.g. '1000000' for 1 USDC). The agent must divide the atomic balance by 10^decimals to get the human-readable amount.","failureModes":["Invalid Ethereum address format for owner or token_address — returns validation error","Token contract address is not an ERC-20 contract — may return zero balance or error","Wallet has no balance for the token — returns balance_atomic: '0' (not an error)","Network congestion or RPC unavailability — may result in timeout or 5xx response","Payment not completed (x402 protocol) — request blocked until 0.01 USDC fee is paid"],"whenToPreferThis":"Use this endpoint when you need a fast, pay-per-call on-chain ERC-20 balance lookup with no API key setup, accessible via the x402 micropayment protocol. It is particularly suited for AI agents in the SALT19 / Agent Utility Grid ecosystem that already handle x402 payments natively. Prefer it over free RPC calls when you want a managed, low-friction single endpoint that abstracts away node infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:40:12.321Z","isFirstParty":false}