{"uid":"cap_-2FdqajYpNi5wF6uhzZLl","slug":"base-token-facts-api-6ca5110c","name":"Base Token Facts API","description":"Get on-chain facts about a Base token contract","url":"https://base-facts.yankii.fr/v1/facts?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"token":{"type":"string","description":"Token contract address (0x-prefixed hex, 20 bytes)"}}},"responseSchema":{"type":"json","example":{"erc20":{"name":"USD Coin","symbol":"USDC","decimals":6,"totalSupply":"4375220680762469"},"owner":"0x3ABd6f64A422225E61E435baE41db12096106df7","proxy":{"isProxy":true,"standard":"ZeppelinOS","implementation":"0x2Ce6311ddAE708829bc0784C967b7d77D19FD779"},"source":"base-mainnet-rpc","isContract":true,"blockNumber":"52125591","contractType":"ERC20","adminFunctionsDetected":{"burn":true,"mint":true,"owner":true,"pause":true,"blacklist":true}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1Dwq5_1yB0WSrh67TOLnB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns on-chain metadata and analysis for a given ERC-20 token contract on the Base blockchain, including name, symbol, decimals, supply, proxy status, and detected admin functions.","exampleAgentPrompt":"Can you pull the on-chain facts for the token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Base — I want to know its name, symbol, total supply, whether it's a proxy, and what admin functions like mint or pause it has?","exampleUseCases":[{"title":"DeFi due diligence on new token","prompt":"Before I ape into this new Base token, can you check the contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 and tell me if it's mintable, pausable, or has a blacklist — and whether it's behind a proxy?"},{"title":"Security audit of a suspicious token","prompt":"Someone sent me tokens from contract 0x4200000000000000000000000000000000000006 on Base — can you check if it's a legitimate ERC-20, who owns it, and what admin powers the deployer has like burn or blacklist?"},{"title":"Verify proxy implementation for a token upgrade","prompt":"I need to verify whether the Base token at 0x2Ce6311ddAE708829bc0784C967b7d77D19FD779 is a proxy contract and what implementation address it points to — and what proxy standard it uses."}],"resultDescription":"A JSON object containing: ERC-20 token metadata (name, symbol, decimals, totalSupply), the contract owner address, proxy details (isProxy, standard such as ZeppelinOS, implementation address), whether the address is a contract, the contract type (e.g. ERC20), the block number at which the data was fetched, the data source (base-mainnet-rpc), and a map of detected admin functions (burn, mint, owner, pause, blacklist).","failureModes":["Invalid or non-0x-prefixed address returns an error or empty result","Address is an EOA (not a contract) — isContract may be false and ERC-20 fields may be absent","Token is not ERC-20 compliant — contractType may be unknown or fields may be null","RPC timeout or Base network congestion causing slow or failed response","Non-Base-network contract addresses will not return meaningful results","Unverified or minimal contracts may return sparse admin function data"],"whenToPreferThis":"Use this endpoint when you need authoritative on-chain facts about a specific token contract deployed on the Base network, especially when you need proxy architecture details, admin function detection (mint, burn, pause, blacklist), and owner information in a single call. Prefer this over generic block explorers when you need structured, machine-readable output suitable for automated DeFi risk assessment or smart contract auditing workflows on Base specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:42:34.611Z","isFirstParty":false,"canonicalSlug":"base-token-facts-api-6b247996"}