{"uid":"cap_k6WtigXPuKgBD9MzYAuTi","slug":"evm-token-balance-lookup-f917fe2a","name":"EVM Token Balance Lookup","description":"Crypto market data and web tools for autonomous agents: read web pages, PDFs and YouTube transcripts, check domains and tokens. Every `/api/v1/*` call is paid per call: **$0.003** for simple reads, **$0.005-$0.01** for aggregates, **$0.02-$0.03** for token risk checks and reports (USDC or USDT). Each route's price is in `x-payment-info`.\n\n**x402 agents:** pay automatically. The 402 response carries a standard `PAYMENT-REQUIRED` header (x402 v2, USDC on Base or Solana, USDT on Solana); retry with `PAYMENT-SIGNATURE`.\n\n**Manual (legacy) flow:** call the endpoint, read the HTTP 402 JSON (`pay_to`, `asset`, `price`), send the USDT transfer, then repeat the call with header `X-Payment-Tx: <signature>`. One signature pays for one call; signatures older than the `max_tx_age_seconds` value are rejected.\n\nMachine-readable spec: `/openapi.json`. LLM summary: `/llms.txt`. MCP server: `POST /mcp`.","url":"https://194-28-85-99.sslip.io/api/v1/evm/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","required":["token","address"],"properties":{"chain":{"type":"string"},"token":{"type":"string"},"address":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","symbol":"USDC","balance":1.5,"decimals":6,"raw_balance":"1500000"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MuOvg-22xSdLBlCYy-zO1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the token balance for a given wallet address and ERC-20 token contract on an EVM-compatible chain","exampleAgentPrompt":"What's the USDC balance for wallet address 0xAbC...123 on Base chain?","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"Can you check how much USDC the wallet 0x1234567890abcdef1234567890abcdef12345678 holds on Base right now?"},{"title":"Agent treasury monitoring","prompt":"Look up the USDT balance for our agent's treasury wallet 0xdeadbeef...cafe on Ethereum — I need to know if we have enough to cover operations."},{"title":"Token gating verification","prompt":"Does wallet 0xabc...def hold at least 100 of token contract 0x456...789 on Polygon? Check the balance for me."}],"resultDescription":"Returns a JSON object with the chain name, token symbol, human-readable balance (float), token decimals, and raw balance string (e.g. {chain: 'base', symbol: 'USDC', balance: 1.5, decimals: 6, raw_balance: '1500000'}).","failureModes":["Invalid or malformed wallet address returns an error","Unknown or unsupported chain identifier results in an error","Invalid token contract address (e.g. not an ERC-20) may return zero or error","Payment not provided or expired payment signature returns HTTP 402","Network congestion or RPC unavailability may cause timeouts"],"whenToPreferThis":"Use this endpoint when you need to check the ERC-20 token balance of any wallet address on an EVM-compatible chain (Base, Ethereum, Polygon, etc.) without running your own node. Ideal for AI agents that need on-chain balance data as part of a workflow, treasury checks, token-gating, or DeFi monitoring, and that can pay per-call in USDC via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T12:33:07.281Z","isFirstParty":false,"canonicalSlug":"evm-token-balance-lookup-f917fe2a"}