{"uid":"cap_VPmRB9kFw3rxNLf_kJis4","slug":"ethereum-token-verdict-preview-e80f51a5","name":"Ethereum Token Verdict Preview","description":"Token Quick Check: Ethereum mainnet contract facts -- name, supply, owner, code. Not financial advice.  Returns: a token verdict preview on one token contract: the contract facts the full verdict reads -- code size, name, symbol, decimals, total supply, owner(), proxy slots -- read from the chain. No grade, no model, no pool price, no holders, no safety or legitimacy call.","url":"https://api.arysphere.com/v1/ventures/x402_eth_token_verdict_v1/eth_mainnet_token_verdict_preview?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"},"queryParams":{"type":"object","properties":{"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"token contract, 0x + 40 hex"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"note":"A preview: the contract's own state read from the chain. No grade, no model, no pool price, no holders, no safety or legitimacy call. Not financial advice.","chain":"ethereum","cached":false,"method":"preview","result":{"facts":{"name":"Tether USD","owner":"0xc6cde7c39eb2f0f0095f41570af89efc2c1ea828","symbol":"USDT","address":"0xdAC17F958D2ee523a2206206994597C13D831ec7","decimals":6,"code_bytes":11075,"proxy_slot":null,"is_contract":true,"erc20_shaped":true,"total_supply":"88301265725.970534","owner_function":true,"owner_renounced":false,"total_supply_raw":"88301265725970534","upgradeable_proxy":false,"proxy_slots_checked":["eip1967","eip1967_beacon"],"proxy_implementation":null},"token":"0xdAC17F958D2ee523a2206206994597C13D831ec7"},"service":"x402_eth_token_verdict_v1.eth_mainnet_token_verdict_preview"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HTABR1Mo0Ct4sqahqf8wT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches raw on-chain contract facts for an Ethereum ERC-20 token address — code size, name, symbol, decimals, total supply, owner, and proxy slots — without scoring or analysis.","exampleAgentPrompt":"Can you pull the raw on-chain contract facts for the Ethereum ERC-20 token at address 0xdAC17F958D2ee523a2206206994597C13D831ec7 — I want to see its name, symbol, decimals, total supply, owner, and whether it's a proxy?","exampleUseCases":[{"title":"Token contract sanity check before trading","prompt":"Before I buy any of this token, can you check the on-chain contract facts for 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum mainnet — I want to see the name, symbol, owner, total supply, and whether it's an upgradeable proxy?"},{"title":"Detecting proxy or upgradeable contracts","prompt":"Can you fetch the raw chain data for the Ethereum token contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 and tell me if it's a proxy contract and which proxy slots were found?"},{"title":"Verifying ownership renouncement of an ERC-20","prompt":"I need to know if the owner of the Ethereum ERC-20 contract at 0x6B175474E89094C44Da98b954EedeAC495271d0F has renounced ownership — can you pull the contract facts directly from the chain?"}],"resultDescription":"Returns a JSON object with the token's on-chain contract facts: name, symbol, decimals, total supply (raw and formatted), owner address, owner_renounced flag, code size in bytes, is_contract and erc20_shaped booleans, proxy slot values checked (eip1967, eip1967_beacon), proxy_implementation address if found, and upgradeable_proxy flag. No safety grade, no price, no holder data, no model-generated verdict — purely chain-read state.","failureModes":["Invalid or non-checksummed contract address returns a 400 or validation error","Address is an EOA (externally owned account), not a contract — is_contract returns false","Token contract does not implement standard ERC-20 interface — erc20_shaped may return false","Network connectivity or RPC node issues may cause timeouts","Calling with a non-Ethereum address format (e.g. Base or other chain address) may return unexpected results"],"whenToPreferThis":"Use this endpoint when you need cheap, fast, raw on-chain contract facts for an Ethereum mainnet ERC-20 token without needing a safety grade, price data, holder counts, or AI-generated verdict. Ideal as a lightweight first-pass check before calling more expensive analysis endpoints, or when you specifically need proxy slot inspection, ownership status, or basic ERC-20 shape validation straight from the chain.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T12:34:11.576Z","isFirstParty":false,"canonicalSlug":"ethereum-token-verdict-preview-e80f51a5"}