{"uid":"cap_RrVbxGQ7Mzicl97b8oWCl","slug":"booaip-token-supply-lookup-eae304be","name":"booAIP Token Supply Lookup","description":"ERC-20 token name, symbol, decimals and total supply via on-chain read. Body: { token, chain }.","url":"https://booaip.vercel.app/api/supply","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","description":"eth, bnb, base."},"token":{"type":"string"}}},"responseSchema":{"type":"json","example":{"found":true,"symbol":"USDC","decimals":6,"totalSupply":"1000000"}},"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_m1MvK3ZX28OnmZLkhZoO0","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 total supply and decimals for a given ERC-20 token symbol on-chain","exampleAgentPrompt":"What is the total supply and decimals for USDC on-chain? I need the raw totalSupply number and token precision so I can calculate real balances in my DeFi workflow.","exampleUseCases":null,"resultDescription":"Returns a JSON object with: found (boolean indicating if token was located), symbol (the token ticker), decimals (number of decimal places for the token), and totalSupply (raw integer string of the full token supply).","failureModes":["Token symbol not found returns found: false with no supply data","Invalid or unsupported token symbol yields empty or error response","Payment failure via x402 USDC on Base prevents API access","Network or contract lookup timeout returns error","Unsupported chain or token contract returns not found"],"whenToPreferThis":"Use this endpoint when an AI agent needs on-chain ERC-20 token supply data in a pay-per-call model without API key management; ideal for crypto/DeFi agents that need accurate totalSupply and decimals to normalize token amounts, especially when paying with USDC via x402 on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:37:03.434Z","isFirstParty":false}