{"uid":"cap_p7OGtddWS7n93IoiDNxj6","slug":"tokenintel-on-chain-token-intelligence-api-40842ce1","name":"TokenIntel On-Chain Token Intelligence API","description":"Evidence-first on-chain token intelligence for Base. Query ERC-20 identity, total supply, ownership, pause status, owner code type, and EIP-1967 proxy-slot evidence from live RPC data. Responses distinguish OBSERVED, UNKNOWN, and FAILED states instead of making unsupported SAFE/SCAM verdicts.","url":"https://tokenintel-api.onrender.com/v1/token/usdc?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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":[],"properties":{"mode":{"type":"string","default":"full","description":"Optional analysis mode."},"since_block":{"type":"integer","minimum":0,"description":"Optional earlier Base block for control snapshot comparison; not event history."},"token_address":{"type":"string","description":"ERC-20 contract address on Base. Not required for the /v1/token/usdc convenience route."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["schema_version"],"properties":{"schema_version":{"type":"string","description":"TokenIntel response schema version"}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"schema_version":"0.2"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vDp8T7d6kEni8VVs2e7D7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Queries live Base blockchain RPC data to return ERC-20 token identity, total supply, ownership, pause status, owner code type, and EIP-1967 proxy-slot evidence with OBSERVED/UNKNOWN/FAILED state distinctions","exampleAgentPrompt":"Can you pull the on-chain intelligence for the USDC contract on Base — I want to see its identity, total supply, ownership, whether it's paused, and if it's using a proxy pattern?","exampleUseCases":[{"title":"Due diligence on new token listing","prompt":"Before I add this token to my portfolio tracker, can you check the on-chain details for contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want to know who owns it, whether it's paused, and if it's a proxy contract?"},{"title":"Automated token risk screening","prompt":"Run a full analysis on the Base ERC-20 at 0x4200000000000000000000000000000000000006 — I need the total supply, ownership, pause status, and whether there's any EIP-1967 proxy evidence so I can assess the risk profile."},{"title":"Verifying USDC contract legitimacy","prompt":"Can you verify the USDC token on Base for me using the /v1/token/usdc route — I want to confirm the identity, supply, and ownership details from live chain data to make sure it matches the known canonical contract?"}],"resultDescription":"A structured JSON response (schema version 0.2) containing ERC-20 token identity fields, total supply, ownership address, pause status, owner code type classification, and EIP-1967 proxy-slot evidence. Each data point is tagged with an observation state of OBSERVED, UNKNOWN, or FAILED rather than subjective SAFE/SCAM verdicts, giving the agent factual on-chain evidence to reason from.","failureModes":["Contract address not found on Base — returns FAILED or UNKNOWN state for affected fields","Invalid or malformed contract address — likely 400 or error state in response","RPC node unavailable or rate-limited — endpoint may return FAILED states across all fields","Token is not an ERC-20 contract — identity and supply fields may return UNKNOWN","Payment not processed (x402) — request rejected before reaching the chain","Network congestion causing slow RPC response — may result in partial FAILED states"],"whenToPreferThis":"Choose this endpoint when you need factual, evidence-based on-chain data about a specific ERC-20 token on the Base network, especially when you need to distinguish between confirmed observations and gaps in data (OBSERVED vs UNKNOWN vs FAILED). It is particularly suited for due diligence workflows, token risk screening, and proxy contract detection. Prefer it over generic blockchain explorers when you need structured, agent-consumable JSON with explicit epistemic states rather than human-readable pages or opinionated SAFE/SCAM labels.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T00:40:02.233Z","isFirstParty":false,"canonicalSlug":"tokenintel-on-chain-token-intelligence-api-40842ce1"}