{"uid":"cap_YELfgTuBU3KG_z-fg4vHx","slug":"santyvv-data-token-balance-lookup-18cf490e","name":"santyvv-data Token Balance Lookup","description":"Market and on-chain data, paid per call in USDC on Base through the x402 protocol. No accounts, no API keys. Sources are public data providers; the value added here is keyless access, edge caching, multi-source fallback and normalised responses.","url":"https://x402.santyvv.com/api/chain/token-balance?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","properties":{}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_My4JGoZPcwshRJz0uHnAM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","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 token balance for a given wallet address and token on Base or other supported chains, paid per call via x402/USDC","exampleAgentPrompt":"What's the current on-chain token balance for wallet 0xAbC...123 for the USDC token contract on Base — pay the small per-call fee to fetch it without an API key?","exampleUseCases":[{"title":"DeFi portfolio balance checker","prompt":"Can you check how many tokens wallet 0x1234...abcd holds for the token at contract 0xA0b8...eB48 on Base?"},{"title":"Airdrop eligibility verification","prompt":"Before we distribute the airdrop, check on-chain whether wallet 0xDead...Beef already holds any of our token at 0xToken...Contract on Base."},{"title":"Smart contract treasury audit","prompt":"What's the current on-chain balance of USDC held by our treasury contract at 0xTreasury...Addr on Base?"}],"resultDescription":"A normalised JSON response containing the token balance for the specified wallet and token contract, sourced from on-chain data with edge caching and multi-source fallback. Typically includes the raw balance, decimals, and formatted amount.","failureModes":["Invalid or malformed wallet address returns an error response","Unsupported token contract address returns empty or error","Chain not supported returns 400 or equivalent error","Payment failure (insufficient USDC, x402 rejection) results in 402 response with no data","RPC unavailability on all fallback sources may cause timeout or 503","Missing required query parameters (address, token) returns validation error"],"whenToPreferThis":"Choose this endpoint when you need a quick, keyless on-chain token balance lookup without setting up API accounts or managing API keys. It is ideal for agents that need per-call blockchain data access billed in USDC micropayments via x402, especially for Base chain tokens. Prefer it over self-hosted RPC calls when you want normalised responses and edge caching without infrastructure overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:48:13.740Z","isFirstParty":false,"canonicalSlug":"santyvv-data-token-balance-lookup-18cf490e"}